> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magic-resume.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置

> 配置 MCP 服务器，并把它注册到 Claude Code、Cursor 或任意 MCP 客户端。

MCP 服务器以 stdio 子进程形式由你的 AI 工具拉起。两步：先一次性配凭据，再把启动命令告诉每个 AI 工具。

<Steps>
  <Step title="签发个人访问令牌（PAT）">
    在 Web 应用里：**设置 → 个人访问令牌 → 新建**。复制 `mr_pat_…` 的值 —— 只显示一次。请像对待密码一样对待它：它有读写你全部简历的权限。
  </Step>

  <Step title="配置 MCP 服务器">
    ```bash theme={null}
    npx -y @magic-resume/mcp config set \
      --api-url "https://api.magic-resume.cn/api" \
      --pat "mr_pat_xxx"
    ```

    这会写入 `~/.magic-resume/mcp.json`。如果你本地跑 Core 网关，把 `--api-url` 指向 `http://localhost:3110/api`。
  </Step>

  <Step title="注册到你的 AI 工具">
    <Tabs>
      <Tab title="Claude Code">
        ```bash theme={null}
        claude mcp add magic-resume -- npx -y @magic-resume/mcp mcp
        ```

        这会把 Magic Resume 加进用户级 MCP 列表。重启 Claude Code 让它读到新服务器。
      </Tab>

      <Tab title="Cursor">
        打开 `~/.cursor/mcp.json`（没有就创建），加：

        ```json theme={null}
        {
          "mcpServers": {
            "magic-resume": {
              "command": "npx",
              "args": ["-y", "@magic-resume/mcp", "mcp"]
            }
          }
        }
        ```
      </Tab>

      <Tab title="手动 / Windsurf">
        任何支持 stdio MCP 服务器的客户端都可以拉起它：

        ```bash theme={null}
        npx -y @magic-resume/mcp mcp
        ```

        服务器通过 stdin/stdout 说标准 MCP 协议 —— 不需要传任何标志。
      </Tab>
    </Tabs>
  </Step>

  <Step title="验证">
    在 AI 工具里问一句：*"列一下我的 Magic Resume 简历。"* 模型应该调 `list_resumes` 并返回你的列表。如果报错，跑 `npx -y @magic-resume/mcp config print` 确认 API URL 和 PAT 没填错。
  </Step>
</Steps>

<Info>
  MCP 服务器通过 **stdio** 通信 —— 它不开端口、不监听 socket、不走 SSE。AI 工具把它作为子进程拉起，会话结束时关掉。
</Info>

## 更新

因为命令是 `npx -y @magic-resume/mcp mcp`，每次 AI 工具启动都会拉最新版。要钉死某个版本：

```bash theme={null}
claude mcp add magic-resume -- npx -y @magic-resume/mcp@0.1.0 mcp
```

## 重置凭据

```bash theme={null}
npx -y @magic-resume/mcp config clear
```

这会删掉 `~/.magic-resume/mcp.json`。如果 PAT 泄漏了，记得也在 Web 应用里吊销那个 PAT。