Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dropcv.work/llms.txt

Use this file to discover all available pages before exploring further.

Claude Desktop 是 Anthropic 官方的桌面 AI 客户端（macOS / Windows / Linux），原生支持 MCP，配置完后在普通对话里就能用上 DropCV 人才库。

​
适用场景

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

​
接入步骤

1

下载安装 Claude Desktop

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

生成 DropCV API Key

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

编辑 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
用任意编辑器打开（不存在就新建），写入：
{
  "mcpServers": {
    "dropcv": {
      "url": "https://api.dropcv.work/api/external/v1/mcp/sse",
      "headers": {
        "Authorization": "Bearer <你的 API Key>"
      }
    }
  }
}
把 <你的 API Key> 替换为上一步复制的 key（保留 Bearer 前缀和空格）。
4

重启 Claude Desktop

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

开始使用

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

​
写入操作（save / update）

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

​
常见问题

​
工具图标不出现

  • 确认 JSON 格式正确（用 jsonlint.com 校验）
  • 完全退出 Claude Desktop（菜单栏 → 退出，不是 Cmd+W）
  • 看 Claude 的开发者日志：菜单栏 → Help → Open Logs

​
401 / “Unauthorized”

  • 检查 API Key 是否完整（前缀 drop_cv_ + 32 位字符 = 40 字符）
  • 检查 Bearer 前缀和空格
  • 在 DropCV 后台确认 key 没被撤销