ClaudeKeep MCP 服务器使用说明

项目简介

ClaudeKeep 是一个实验性项目,它实现了一个 Model Context Protocol (MCP) 服务器,旨在帮助用户保存和分享与 Claude 桌面应用的对话。通过 ClaudeKeep MCP 服务器,你可以将重要的对话记录保存下来,并选择是否公开分享给其他人。项目包含 MCP 服务器端和 Web 应用前端,方便用户管理和查看对话。

主要功能点

  • 对话保存: 通过 Claude 桌面应用指示 ClaudeKeep MCP 服务器保存当前对话。
  • 私有/公开分享: 保存对话时可以选择设为私有,仅自己可见,或设为公开,分享给他人。
  • Web 界面查看: 提供 Web 应用界面,用户可以登录查看自己保存的私有对话以及所有公开分享的对话。
  • 集成 Claude 桌面应用: 通过 MCP 协议与 Claude 桌面应用无缝集成,使用户可以在对话过程中自然地触发保存和分享功能。

安装步骤

  1. 登录 ClaudeKeep Web 应用并获取 Token:

    • 访问 https://claudekeep.com 并点击 "Login" 按钮,使用 GitHub 账号完成 OAuth 登录。
    • 登录成功后,在页面右上角找到并复制你的 JWT Token。
  2. 配置 Claude 桌面应用:

    • 找到 Claude 桌面应用的配置文件 'claude_desktop_config.json'。
      • macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
      • Windows: '%APPDATA%/Claude/claude_desktop_config.json'
    • 将以下 JSON 配置代码块添加到 'claude_desktop_config.json' 文件中的 'mcpServers' 字段中。如果不存在 'mcpServers' 字段,请手动创建。
  3. 重启 Claude 桌面应用:

    • 完全退出 Claude 桌面应用 (例如,macOS 上使用 CMD+Q),然后重新启动应用。

服务器配置

以下是将 ClaudeKeep MCP 服务器配置到 'claude_desktop_config.json' 的 JSON 代码。请务必将 '<YOUR_TOKEN>' 替换为你从 ClaudeKeep Web 应用复制的 JWT Token。

{
  "mcpServers": {
    "claudekeep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claudekeep-mcp"
      ],
      "env": {
        "CLAUDEKEEP_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}
  • 'server name': 'claudekeep-mcp' (服务器名称,在 Claude 桌面应用中选择时会用到)
  • 'command': 'npx' (Node.js 包执行器,用于运行本地安装的 npm 包)
  • 'args':
    • '-y': ('npx' 参数,自动确认安装 'claudekeep-mcp' 包)
    • 'claudekeep-mcp': (要执行的 npm 包名,即 ClaudeKeep MCP 服务器)
  • 'env':
    • 'CLAUDEKEEP_TOKEN': (环境变量,用于传递用户身份验证 Token,请替换为你的 JWT Token)

基本使用方法

  1. 启动 Claude 桌面应用并选择 MCP 服务器:

    • 启动 Claude 桌面应用后,在对话界面中,找到并点击纸夹图标旁边的插头图标 (MCP 连接图标)。
    • 在弹出的 MCP 服务器列表中,选择 'claudekeep-mcp' 下的 'default' 选项。这将应用 ClaudeKeep 提供的默认 Prompt。
  2. 与 Claude 对话并保存:

    • 现在你可以像往常一样与 Claude 进行对话。
    • 当你希望保存当前对话时,直接在对话中发送指令给 Claude,例如:
    • 发送 'save this chat' 保存为私有对话
    • 发送 'save this chat and make it public' 保存为公开对话
    • Claude 会理解你的指令,并调用 ClaudeKeep MCP 服务器的 'save_chat' 工具来保存对话记录。

注意事项

  • ClaudeKeep 项目是实验性质的,请勿用于处理敏感信息。
  • 请妥善保管你的 JWT Token,避免泄露。如果 Token 泄露,请在 ClaudeKeep Web 应用中刷新 Token。

信息

分类

生产力应用