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

# Cursor

> Cursor IDE 原生 MCP 支持，编程时直接调用 DropCV 人才库。

Cursor 是基于 VS Code 的 AI 优先 IDE，原生支持 MCP，可以在 Cursor 的 Chat / Composer 里直接用 DropCV 人才库工具。

## 适用场景

* 在 Cursor 里写代码同时管人才（比如写一个候选人筛选脚本）
* 用 Cursor 的 Agent 模式批量处理候选人数据
* 不想离开 IDE 上下文

## 接入步骤

<Steps>
  <Step title="确认 Cursor 版本">
    需要 Cursor `0.45.0` 以上（原生 MCP 支持）。在 Cursor 里 `Cmd+Shift+P` → "About" 查看版本。
  </Step>

  <Step title="生成 DropCV API Key">
    登录 [app.dropcv.work](https://app.dropcv.work)，进入 **设置 → API Keys**，新建一个 key（命名 "Cursor"），复制完整 key。
  </Step>

  <Step title="配置 Cursor MCP">
    Cursor 的 MCP 配置文件：

    * **macOS / Linux**: `~/.cursor/mcp.json`
    * **Windows**: `%USERPROFILE%\.cursor\mcp.json`

    编辑或新建这个文件：

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

    或者通过 Cursor UI：

    1. `Cmd+,` 打开设置
    2. 搜 "MCP"
    3. 点击「Add new MCP server」
    4. 填名称 `dropcv`、URL `https://api.dropcv.work/api/external/v1/mcp/mcp`、Header `Authorization: Bearer <你的 API Key>`
  </Step>

  <Step title="重启 Cursor">
    完全退出 Cursor 再重新打开。打开 Chat 面板（右上角图标），点击 MCP 工具列表，应该能看到 `dropcv` 下的 9 个工具。
  </Step>

  <Step title="开始使用">
    在 Cursor Chat 里：

    * "用 candidate\_search 找 React + TypeScript 5 年经验的候选人"
    * "查这个候选人的完整档案 (candidate\_id=...)"

    或在 Composer 模式让 Cursor 帮你写脚本：

    * "写一个脚本，从 DropCV 人才库里把所有上海的候选人导出为 CSV"

    Cursor 会自动调用 DropCV 工具拿数据 + 用代码处理后续。
  </Step>
</Steps>

## 写入权限

`save_candidate`、`candidate_update`、`candidate_delete` 需要 API Key 开启「允许写入」（在 [DropCV 设置](https://app.dropcv.work/dashboard/settings) 里）。开启后等约 60 秒生效。

## 常见问题

### 工具不出现

* 确认 Cursor ≥ 0.45.0
* 完全退出 Cursor（不是 Cmd+W）
* 用 `cat ~/.cursor/mcp.json | jq .` 验证 JSON 合法