Skip to main content
Claude Desktop 是 Anthropic 官方的桌面 AI 客户端（macOS / Windows / Linux），支持 MCP，配置完后在普通对话里就能用上 DropCV 人才库。
Claude Desktop 的 claude_desktop_config.json 只支持 stdio 传输，不认 url 字段。DropCV 是 HTTP（Streamable HTTP）的远程 MCP 服务，所以需要用 mcp-remote 这个 npm 包做 stdio↔HTTP 桥。下面的配置已经处理好了，照抄即可。老版本文档里教过的 { "url": "..." } 写法是错的，会让 Claude Desktop 报 “expecting stdio transport”。Pro/Max 订阅用户也可以走 Settings → Connectors → Add custom connector 的 UI 直接填 HTTP URL（不需要 mcp-remote），但 JSON 配置始终只支持 stdio。

​
适用场景

  • 想在 Claude 桌面对话里直接搜候选人 / 读档案
  • 不想折腾 IDE、CLI
  • 多任务同时进行（一边搜人才一边写邮件）

​
接入步骤

1

下载安装 Claude Desktop

访问 claude.ai/download 下载对应系统的安装包，安装后登录你的 Anthropic 账号。
2

生成 DropCV API Key

登录 app.dropcv.work，进入 设置 → API Keys，点击「新建 Key」，起一个名字（例如 “Claude Desktop”），生成后复制完整 key（明文只显示一次）。
3

确认本机有 Node.js（>= 18）

mcp-remote 桥靠 npx 拉起，必须先有 Node.js。打开终端跑：
没装就去 nodejs.org 装 LTS 版（>= 18）。
4

编辑 Claude Desktop 配置文件

Claude Desktop 的 MCP 配置文件路径：
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
用任意编辑器打开（不存在就新建），写入：
把 <你的 API Key> 替换为上一步复制的 key（保留 Bearer 前缀和后面的空格）。mcp-remote 会在第一次启动时被 npx 自动下载并缓存到本地，无需手动安装。
5

重启 Claude Desktop

完全退出（不是关闭窗口，要从菜单栏退出）后重新打开。打开对话窗口，看左下角是否出现 MCP 工具图标。点击图标应该能看到 dropcv 服务下的 9 个工具。
6

开始使用

在对话里直接用自然语言：
  • “帮我从人才库里找 3 年以上 Python 经验的候选人”
  • “查 candidate_id 是 abc-123 的候选人完整档案”
  • “把这段 JD 跟我的人才库匹配，列出前 5 个最合适的人”
Claude 会自动选择正确的工具调用。每次工具调用都会在对话气泡上方显示「使用 dropcv 工具」的提示。

​
写入操作（save / update / delete）

save_candidate、candidate_update、candidate_delete 是写操作。默认 API Key 是只读的，要使用这些写工具：
  1. 回到 app.dropcv.work 设置 → API Keys
  2. 找到对应 key 的「允许写入」开关，打开它
  3. 在 Claude Desktop 里等约 60 秒（缓存生效时间），或者重启 Claude Desktop
如果想在 Claude 里上传 PDF 简历入库，建议用 dropcv CLI 的 import resume 命令——文件上传在 MCP 协议下不友好。

​
常见问题

​
工具图标不出现 / Claude 报 “expecting stdio transport”

  • 你的 JSON 里是不是直接写了 "url": "..."？Claude Desktop 不支持 —— 必须按上面的 command + args + mcp-remote 写法
  • 确认 JSON 格式正确（用 jsonlint.com 校验）
  • 完全退出 Claude Desktop（菜单栏 → 退出，不是 Cmd+W）
  • 本机是否能跑 npx？终端跑 npx --version 验证；不行就先装 Node.js
  • 看 Claude 的开发者日志：菜单栏 → Help → Open Logs

​
401 / “Unauthorized”

  • 检查 API Key 是否完整（前缀 drop_cv_ + 32 位字符 = 40 字符）
  • 检查 Bearer 前缀和空格（注意：在 args 数组里，Authorization: Bearer <key> 是一整个字符串元素）
  • 在 DropCV 后台确认 key 没被撤销