纪念品mcp
MCP服务器 纪念品 --帮助您培养人际关系的个人CRM。
将您的AI助手(Claude、Cursor或任何兼容MCP的客户端)连接到您的Keepsake数据:联系人、交互、任务、笔记、日记、公司和标签。
为什么
你的人工智能助理将成为个人关系经理。要求它:
- “我上次在Acme公司和谁谈过?”
- “添加一条我在会议上遇到Sarah的信息”
- “哪些任务已经逾期?”
- “显示与#house项目标签相关的所有内容”
- “为我下周与约翰的会面制定一个后续任务”
快速开始
1.获取API密钥
注册地址: 纪念品,然后转到 帐户>API密钥 生成一个。
2.选择您的连接方式
选项A:远程(HTTP)--推荐
无需安装。适用于Claude iOS、Claude web、Claude Desktop Connectors以及任何支持Streamable HTTP的MCP客户端。
端点: https://app.keepsake.place/api/mcp
身份验证: 将您的API密钥作为Bearer令牌传递到 Authorization 头球
克劳德桌面(连接器):
在Claude Desktop设置中添加远程MCP服务器,包括:
- 网址:
https://app.keepsake.place/api/mcp - 身份验证:携带您的令牌
ksk_API密钥
任何MCP客户端(流式HTTP):
{
"mcpServers": {
"keepsake": {
"type": "streamable-http",
"url": "https://app.keepsake.place/api/mcp",
"headers": {
"Authorization": "Bearer ksk_YOUR_API_KEY"
}
}
}
}选项B:本地(stdio)
通过以下方式在本地运行 npx。可用于Claude Code、Cursor和本地开发。
克劳德桌面:
添加 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"keepsake": {
"command": "npx",
"args": ["-y", "keepsake-mcp"],
"env": {
"KEEPSAKE_API_KEY": "ksk_YOUR_API_KEY"
}
}
}
}克劳德代码:
claude mcp add keepsake -- npx -y keepsake-mcp然后设置 KEEPSAKE_API_KEY 在您的环境中。
光标:
添加 .cursor/mcp.json 在您的项目中:
{
"mcpServers": {
"keepsake": {
"command": "npx",
"args": ["-y", "keepsake-mcp"],
"env": {
"KEEPSAKE_API_KEY": "ksk_YOUR_API_KEY"
}
}
}
}可用工具(58)
联系人
| 工具 | 说明 |
|---|---|
list_contacts | 列出所有联系人,并进行分页和排序 |
get_contact | 获取最近的互动、标签和统计信息 |
create_contact | 创建新联系人 |
update_contact | 更新联系人字段 |
delete_contact | 永久删除联系人 |
search_contacts | 按姓名、电子邮件、公司进行不区分口音的搜索 |
get_contact_timeline | 联系人所有项目的统一按时间顺序馈送 |
公司
| 工具 | 说明 |
|---|---|
list_companies | 列出所有公司 |
get_company | 使用链接的联系人和标签获取公司 |
create_company | 创建新公司 |
update_company | 更新公司字段 |
delete_company | 软删除(或永久删除)公司 |
search_companies | 口音不敏感的公司搜索 |
参赛作品(互动)
| 工具 | 说明 |
|---|---|
list_entries | 列出互动(电话、电子邮件、会议等) |
create_entry | 记录新的交互——支持 #tag# 和 [[tag]] 语法 |
update_entry | 更新交互 |
delete_entry | 删除交互 |
任务
| 工具 | 说明 |
|---|---|
list_tasks | 列出带有状态/日期过滤器的任务 |
create_task | 创建任务--支持 #tag# 和 [[tag]] 语法 |
update_task | 更新任务字段 |
delete_task | 删除任务 |
complete_task | 标记为已完成(自动为重复任务创建下一个事件) |
uncomplete_task | 再次标记为待定 |
snooze_task | 重新安排到新的日期 |
get_tasks_today | 今天的任务:逾期+今天到期+尽快 |
get_tasks_overdue | 仅限逾期任务 |
快速笔记
| 工具 | 说明 |
|---|---|
list_notes | 列出笔记(按固定/存档过滤) |
create_note | 创建注释--支持 #tag# 和 [[tag]] 语法 |
update_note | 更新笔记内容 |
delete_note | 软删除(或永久删除) |
pin_note | 固定到顶部 |
archive_note | 存档笔记 |
restore_note | 恢复已删除/存档的笔记 |
日报
| 工具 | 说明 |
|---|---|
list_days | 按日期范围列出日记账条目 |
get_day | 获取特定日期的日记 |
update_day | 创建或更新一天的日记(追加销售) |
标签
| 工具 | 说明 |
|---|---|
list_tags | 列出所有标签 |
get_tag | 按ID获取包含所有属性(颜色、图标、视图模式等)的标签 |
create_tag | 创建新标签 |
update_tag | 更新标签(名称、描述、颜色、图标、查看模式、收藏夹) |
delete_tag | 永久删除标签及其所有链接 |
get_tag_items | 将所有内容链接到标签 |
link_tag | 将任何实体链接到标记 |
unlink_tag | 删除标记链接 |
任务标题(节)
| 工具 | 说明 |
|---|---|
list_task_headers | 列出所有任务标题(部分分隔符) |
get_task_header | 按ID获取任务标题 |
create_task_header | 创建任务标题(部分) |
update_task_header | 更新任务标题(名称、描述、折叠) |
delete_task_header | 永久删除任务标题 |
联系链接
| 工具 | 说明 |
|---|---|
link_note_contact | 将联系人链接到备注 |
unlink_note_contact | 从笔记中删除联系人链接 |
link_entry_contact | 将联系人链接到条目 |
unlink_entry_contact | 从条目中删除联系人链接 |
link_task_contact | 将联系人链接到任务 |
unlink_task_contact | 从任务中删除联系人链接 |
公用事业
| 工具 | 说明 |
|---|---|
search | 跨所有数据类型的全局搜索 |
get_changelog | 自时间戳以来修改的项目(用于同步) |
get_agent_instructions | AI代理的最佳实践 |
工具注释
所有工具均包含MCP安全注释:
- 只读工具 (
list_*,get_*,search_*):已标记readOnlyHint: true - 创造工具:已标记
destructiveHint: false - 更新工具:已标记
destructiveHint: false, idempotentHint: true - 删除工具:已标记
destructiveHint: true, idempotentHint: true
活动跟踪
通过API执行的每个写入操作(创建、更新、删除)都记录在 动态消息 用户在Keepsake中可见。每个操作都显示实体类型、内容预览以及使用了哪个API键。
这意味着你的用户可以看到你所做的一切。透明和精确。如果你犯了错误,让用户知道,这样他们就可以在活动提要中进行验证。
呼叫 get_agent_instructions 在每节课开始时查看完整的最佳实践指南。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
KEEPSAKE_API_KEY | 是 | 您的API密钥(以 ksk_) |
KEEPSAKE_API_URL | 否 | 自定义API URL(默认值: https://app.keepsake.place/api/v1) |
速率限制
每个API密钥每分钟60个请求。响应中包含速率限制标头。
API文档
完整的REST API文档: 纪念品。地点/api
隐私
Keepsake MCP服务器仅与Keepsake API通信(app.keepsake.place).它不会向任何第三方服务发送数据。您的数据保存在MCP客户端和Keepsake帐户之间。
所有API调用都使用您的个人API密钥进行身份验证,并通过行级安全性将范围限定到您的帐户。无法访问其他用户的数据。
请参阅我们的隐私政策 keepsake.place/隐私.
许可证
麻省理工学院
