> ## 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 官方桌面客户端，最直观的 MCP 接入方式。

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

<Warning>
  **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。
</Warning>

## 适用场景

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

## 接入步骤

<Steps>
  <Step title="下载安装 Claude Desktop">
    访问 [claude.ai/download](https://claude.ai/download) 下载对应系统的安装包，安装后登录你的 Anthropic 账号。
  </Step>

  <Step title="生成 DropCV API Key">
    登录 [app.dropcv.work](https://app.dropcv.work)，进入 **设置 → API Keys**，点击「新建 Key」，起一个名字（例如 "Claude Desktop"），生成后**复制完整 key**（明文只显示一次）。
  </Step>

  <Step title="确认本机有 Node.js（>= 18）">
    `mcp-remote` 桥靠 `npx` 拉起，必须先有 Node.js。打开终端跑：

    ```bash theme={null}
    node --version
    ```

    没装就去 [nodejs.org](https://nodejs.org/) 装 LTS 版（>= 18）。
  </Step>

  <Step title="编辑 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`

    用任意编辑器打开（不存在就新建），写入：

    ```json theme={null}
    {
      "mcpServers": {
        "dropcv": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://api.dropcv.work/api/external/v1/mcp/mcp",
            "--header",
            "Authorization: Bearer <你的 API Key>"
          ]
        }
      }
    }
    ```

    把 `<你的 API Key>` 替换为上一步复制的 key（保留 `Bearer ` 前缀和后面的空格）。`mcp-remote` 会在第一次启动时被 `npx` 自动下载并缓存到本地，无需手动安装。
  </Step>

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

  <Step title="开始使用">
    在对话里直接用自然语言：

    * "帮我从人才库里找 3 年以上 Python 经验的候选人"
    * "查 candidate\_id 是 abc-123 的候选人完整档案"
    * "把这段 JD 跟我的人才库匹配，列出前 5 个最合适的人"

    Claude 会自动选择正确的工具调用。每次工具调用都会在对话气泡上方显示「使用 dropcv 工具」的提示。
  </Step>
</Steps>

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

`save_candidate`、`candidate_update`、`candidate_delete` 是写操作。默认 API Key 是只读的，要使用这些写工具：

1. 回到 [app.dropcv.work 设置 → API Keys](https://app.dropcv.work/dashboard/settings)
2. 找到对应 key 的「允许写入」开关，打开它
3. 在 Claude Desktop 里**等约 60 秒**（缓存生效时间），或者重启 Claude Desktop

如果想在 Claude 里上传 PDF 简历入库，建议用 [`dropcv` CLI](/integration/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 没被撤销