给你的 cursor 装个外挂，让 AI 干的活告别鸡肋

给你的 cursor 装个外挂，让 AI 干的活告别鸡肋

本教程介绍如何把远程 MCP 服务 agent-toolkit 接入 Cursor，使 Cursor 可以调用 Agent 工具包提供的航班、天气、网页搜索、图片生成等能力。

Cursor IDE 与 Cursor Agent CLI 共用 mcp.json。在用户级配置中添加一次服务后，IDE 中的 Agent 和 Cursor Agent CLI 都可以读取同一份配置。

接入信息

项目	内容
客户端	Cursor IDE / Cursor Agent CLI
配置文件	~/.cursor/mcp.json
MCP 地址	https://agent-toolkit.app.baizhi.cloud/mcp
传输方式	HTTP / Streamable HTTP
鉴权方式	Bearer Token 请求头
服务名称	agent-toolkit

MCP 地址必须以 /mcp 结尾。不要把教程中的占位密钥 sk_****** 直接写入配置，也不要把真实密钥提交到 Git。

1. 准备 API Key

Agent 工具包是远程 MCP 服务，需要使用真实 API Key 才能连接并调用工具。

1. 打开 Agent 工具包控制台的 API Key 页面。
2. 创建一把新的 API Key。
3. 根据使用场景选择合适的工具分组，例如航班查询、机场天气、网页搜索或图片生成。
4. 创建后立即复制密钥，并妥善保存。

后续配置时，把 sk_****** 整段替换为真实密钥；不要保留星号，也不要附加尖括号。

2. 打开 Cursor 的 MCP Tools

打开 Cursor，进入 Cursor Settings，在 Tools & Integrations 下找到并打开 MCP Tools。

如果页面提示 MCP 功能尚未启用，先按提示开启，再继续添加服务。

3. 写入用户级配置

在 MCP Tools 页面点击 New MCP Server，打开用户级配置文件：

~/.cursor/mcp.json

Windows 用户通常可以在资源管理器地址栏中打开：

%USERPROFILE%\.cursor\mcp.json

将下面的内容合并到 mcpServers 中：

{
  "mcpServers": {
    "agent-toolkit": {
      "command": "npx.cmd",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://agent-toolkit.app.baizhi.cloud/mcp",
        "--header",
        "Authorization: Bearer sk_xxxxxx"
      ]
    }
  }
}

将 sk_****** 替换为第 1 步创建的真实 API Key。

如果 mcp.json 中已经配置了其他服务，只在已有的 mcpServers 对象中新增 agent-toolkit，不要覆盖原有服务，也不要重复创建第二个 mcpServers。

例如，已有其他服务时，配置结构应类似下面这样：

{
  "mcpServers": {
    "已有服务名": {
      "command": "..."
    },
    "agent-toolkit": {
      "command": "npx.cmd",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://agent-toolkit.app.baizhi.cloud/mcp",
        "--header",
        "Authorization: Bearer sk_xxxxxx"
      ]
    }
  }
}

保存文件后，检查 JSON 中的逗号、双引号和大括号是否完整。

4. 重新加载并验证

保存后回到 MCP Tools 页面，确认 agent-toolkit 已出现并处于启用状态。

如果 Cursor 没有立即识别配置，可以按以下顺序处理：

1. 关闭并重新打开 Cursor，或重新加载当前窗口。
2. 回到 MCP Tools 页面，确认 agent-toolkit 可以列出工具。
3. 新建一个 Agent 对话，明确要求使用 agent-toolkit 完成简单查询。

例如：

请使用 agent-toolkit 查询北京首都机场未来几天的天气，并简要说明适合携带的衣物。

若能看到工具调用并得到整理后的结果，说明配置成功。Cursor Agent CLI 会读取同一份 ~/.cursor/mcp.json，一般不需要重复配置。

5. 案例：在 Cursor 中调用 Agent 工具包规划旅行

配置完成后，在 Cursor Agent 对话中直接输入下面的提示词。Cursor 会根据任务需要调用 agent-toolkit 的航班、天气和网页搜索工具，再把结果整理成旅行计划。

第 1 步：输入旅行需求

我计划 [人数] 人从 [出发地] 去 [目的地]，
[出发日期] 出发，[返程日期] 返回。
旅行偏好是 [省钱 / 少换乘 / 慢慢逛]，住宿希望在 [区域或预算]。

请使用 agent-toolkit 完成以下任务：
1. 查询往返航班，比较价格低、全程直飞和时间较合适的方案；
2. 查询到达机场的天气；
3. 选择一组推荐航班，并整理机场到住宿区域的交通建议；
4. 用 Markdown 输出出发前清单、往返时间线和 3—5 个主要景点的顺路安排。

请标注查询日期和信息来源。价格、航班和景点开放时间可能变化；查不到的信息写“待确认”，不要编造。

第 2 步：观察 Cursor 的工具调用

运行后，在 Agent 对话中确认 Cursor 调用了 agent-toolkit，而不是仅凭已有知识生成答案。一次常见的调用链如下：

查询内容	可能调用的工具
确认城市或机场代码	city_search、airport_search
查询往返航班和价格	flight_prices
查询中转路线	flight_transfers
查询机场天气	airport_weather
搜索景点和交通补充信息	websearch_aisearch、web_extract

不同的目的地、日期和工具权限会影响实际调用的工具数量，以 Cursor 对话中的工具记录为准。

第 3 步：检查旅行计划是否可用

重点检查以下内容：

• 是否明确显示调用了 agent-toolkit MCP 服务；
• 是否比较了多个航班方案，再说明推荐理由；
• 选定航班后，时间线、机场接驳和行程是否始终使用同一组航班；
• 是否标注查询日期、来源，以及“待确认”的不确定信息；
• 是否把机票、签证、景点开放时间和交通变更提示为出发前复核项。

6. 常见问题

现象	处理方式
MCP Tools 中没有 agent-toolkit	检查 ~/.cursor/mcp.json 是否已保存，并重新加载 Cursor。
服务显示失败或无法调用	检查 URL 是否以 /mcp 结尾，确认 Authorization 的格式为 Bearer <真实 API Key>。
保存后其他 MCP 服务消失	恢复原来的 mcp.json，然后只将 agent-toolkit 补到已有的 mcpServers 对象中。
JSON 解析报错	检查键名和字符串是否使用英文双引号，确认最后一项后没有多余逗号。
已连接但看不到工具	重启或重新加载 Cursor，在 Agent 对话中明确要求使用 agent-toolkit。
API Key 泄露	立即在 Agent 工具包控制台作废旧密钥并重新生成；不要把新密钥发到聊天、截图或公开仓库。

7. 安全建议

• 不要把 API Key 写进项目代码、提交到 Git 或发布到公开截图中。
• ~/.cursor/mcp.json 中可能包含可直接调用服务的密钥，不要上传到公开仓库。
• 只为当前用途选择必要的工具权限，避免给不需要的工具开放额度。
• 旅行计划中的航班、票价、签证、景点开放时间和交通信息会变化，出发前应通过订单、航空公司和官方渠道再次确认。

完成以上步骤后，Cursor 就可以通过远程 MCP 使用 Agent 工具包。以后如果工具清单发生变化，通常只需要保持 MCP 服务配置正确并重新加载 Cursor，不必重复安装。