> ## 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.

# MCP Server

> DropCV MCP Server 的接入地址、传输协议、鉴权和可用工具。

DropCV MCP Server 把 [Skills API](/integration/skills/overview) 的能力包装成 [MCP](/ai-basics/what-is-mcp) 工具，让支持 MCP 的 AI 工具（Claude Code、Cherry Studio、Cline 等）能用自然语言直接操作你的人才库。

## 接入地址

```
https://api.dropcv.work/api/external/v1/mcp/mcp
```

| 项       | 值                                                                         |
| ------- | ------------------------------------------------------------------------- |
| 传输协议    | Streamable HTTP（MCP 2025-03-26+）                                          |
| 鉴权      | HTTP Header `Authorization: Bearer drop_cv_...`                           |
| API Key | 在 [设置 → API Keys](https://app.dropcv.work/dashboard/settings/api-keys) 生成 |

## 通用配置

大多数 MCP 客户端用一段 JSON 配置远程 MCP Server：

```json theme={null}
{
  "mcpServers": {
    "dropcv": {
      "url": "https://api.dropcv.work/api/external/v1/mcp/mcp",
      "headers": {
        "Authorization": "Bearer drop_cv_你的_API_Key"
      }
    }
  }
}
```

不同工具的配置入口略有差异，逐工具的图文步骤见下方「各工具接入指南」。

## 可用工具

MCP Server 暴露的工具与 Skills API 一致：

| 工具                       | 功能                            | 权限 |
| ------------------------ | ----------------------------- | -- |
| `candidate_search`       | 人才库**语义**搜索（按 JD/画像找相似的人）     | 读  |
| `candidate_list`         | 人才库**列表/关键词**查询（翻页、按姓名/公司精确找） | 读  |
| `candidate_profile_read` | 按 ID 读取候选人完整档案                | 读  |
| `jd_parse`               | JD 文本结构化解析                    | 读  |
| `save_candidate`         | 简历入库                          | 写  |
| `candidate_update`       | 候选人字段 partial update          | 写  |
| `candidate_delete`       | 永久删除候选人档案                     | 写  |
| `candidate_note_add`     | 给候选人笔记时间线追加一条笔记               | 写  |
| `candidate_tag_add`      | 给候选人追加自定义标签（去重）               | 写  |

<Note>
  写工具（`save_candidate` / `candidate_update` / `candidate_delete` / `candidate_note_add` / `candidate_tag_add`）需要 API Key 开启 write 权限，否则调用返回 `INSUFFICIENT_PERMISSION`。详见 [鉴权](/integration/skills/authentication)。
</Note>

每次工具调用都会写入审计，可在 [设置 → 用量](https://app.dropcv.work/dashboard/settings/usage) 按 `invocation_id` 查询。

<Note>
  MCP 工具只覆盖**数据能力**。推荐语、面试题、匹配分析、沟通策略等业务智能不是 MCP 工具，而是 [Agent Skills 提示词技能](/integration/agent-skills) —— 由你的模型执行。
</Note>

## 各工具接入指南

<CardGroup cols={2}>
  <Card title="Cherry Studio" icon="mouse-pointer-click" href="/integration/cherry-studio">
    图形界面，零门槛。
  </Card>

  <Card title="Claude Code" icon="terminal" href="/integration/claude-code">
    Anthropic 官方 CLI。
  </Card>

  <Card title="Cline" icon="code" href="/integration/cline">
    VS Code AI 编程助手。
  </Card>

  <Card title="全部工具" icon="plug" href="/integration/overview">
    Roo Code、Kilo Code、TRAE、OpenCode 等。
  </Card>
</CardGroup>

## 排查连接问题

* 确认网络可访问 `api.dropcv.work`
* 检查 `Authorization` 头：`Bearer ` 前缀 + key，无多余空格
* key 被撤销后约 60 秒内全网生效，需重新生成
* 工具不主动调用 DropCV 时，在对话里明确提到「人才库」「候选人」等关键词