Claude Desktop 接入

Claude Desktop 是 Anthropic 官方桌面客户端。它的 MCP 目前只原生支持 stdio，要接 Keepamore 的远程 HTTP MCP，需要套一层桥接器（推荐 mcp-remote）。

一、安装 Claude Desktop 与 Node.js

1. 下载并安装 Claude Desktop（macOS / Windows）
2. 安装 Node.js 18+（桥接器要用）

node --version   # 需要 >= 18
npx --version

二、找到配置文件

Claude Desktop 的 MCP 配置在：

系统	路径
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

如果文件不存在，新建一个空的 {}。

打开方式：Claude Desktop 顶栏 Settings → Developer → Edit Config，会直接打开该文件所在目录。

三、配置 Keepamore MCP（通过 mcp-remote 桥接）

把下面内容写入 claude_desktop_config.json（已有 mcpServers 就并入即可）：

{
  "mcpServers": {
    "keepamore": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.keepamore.com/mcp",
        "--header",
        "X-API-Key:km_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      ]
    }
  }
}

Windows 用户注意：command 也可以写 npx.cmd，避免找不到可执行文件；如果路径里有中文，建议把 npx 换成绝对路径（where npx 查）。

保存后完全退出并重启 Claude Desktop（macOS 是 Cmd+Q，Windows 在系统托盘右键 Quit）。

四、验证

重启后在对话框右下角应能看到一个工具图标（🔧）变亮，点击展开能看到 keepa_* 13 个工具。

测试一句：

请调用 keepa_get_quota 查询我的账号额度。

Claude 会弹出权限确认对话框，允许后会返回你的套餐信息。

五、配置 Keepa 数据分析师 Persona

Claude Desktop 通过 Projects 实现持久化 system prompt：

1. 左侧 Projects → New Project
2. 名称：Keepamore 数据分析
3. Custom instructions 粘贴 Keepa 数据分析师 prompt
4. 之后在该 Project 下开新对话，自动应用 prompt

Claude Desktop 不支持给单个 chat 设 system prompt，必须用 Project 形式持久化。

故障排查

现象	原因	处理
重启后看不到工具图标	JSON 写错或路径错	用 jsonlint.com 校验；查看 ~/Library/Logs/Claude/mcp*.log
npx 报 ENOENT	Node 没装好 / PATH 没生效	终端能跑 npx --version 但 GUI 不能时，把 command 写成 npx 的绝对路径
桥接器报 401	header 格式错	必须是 X-API-Key:km_xxx（冒号紧贴，没有空格）；或换成 Authorization:Bearer km_xxx
工具能列出但调用失败	网络拦截 / 公司代理	检查能否在浏览器打开 https://mcp.keepamore.com/health
调用一直 pending	mcp-remote 缓存了旧会话	杀掉所有 node 进程后重启 Claude Desktop

关于直连

未来 Claude Desktop 如果原生支持 Streamable HTTP，可以省掉 mcp-remote 这一层。届时配置会简化为：

{
  "mcpServers": {
    "keepamore": {
      "url": "https://mcp.keepamore.com/mcp",
      "headers": { "X-API-Key": "km_xxx" }
    }
  }
}

请关注 Anthropic 官方更新，本页会同步修订。

---

下一步：Cursor 接入 · Cline 接入