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

发布时间:2026/10/11 15:06:35
给你的 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.jsonMCP 地址https://agent-toolkit.app.baizhi.cloud/mcp传输方式HTTP / Streamable HTTP鉴权方式Bearer Token 请求头服务名称agent-toolkitMCP 地址必须以/mcp结尾。不要把教程中的占位密钥sk_******直接写入配置也不要把真实密钥提交到 Git。1. 准备 API KeyAgent 工具包是远程 MCP 服务需要使用真实 API Key 才能连接并调用工具。打开 Agent 工具包控制台的 API Key 页面。创建一把新的 API Key。根据使用场景选择合适的工具分组例如航班查询、机场天气、网页搜索或图片生成。创建后立即复制密钥并妥善保存。后续配置时把sk_******整段替换为真实密钥不要保留星号也不要附加尖括号。2. 打开 Cursor 的 MCP Tools打开 Cursor进入Cursor Settings在Tools Integrations下找到并打开MCP Tools。如果页面提示 MCP 功能尚未启用先按提示开启再继续添加服务。3. 写入用户级配置在MCP Tools页面点击New MCP Server打开用户级配置文件~/.cursor/mcp.jsonWindows 用户通常可以在资源管理器地址栏中打开%USERPROFILE%\.cursor\mcp.json将下面的内容合并到mcpServers中{mcpServers:{agent-toolkit:{command:npx.cmd,args:[-y,mcp-remotelatest,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-remotelatest,https://agent-toolkit.app.baizhi.cloud/mcp,--header,Authorization: Bearer sk_xxxxxx]}}}保存文件后检查 JSON 中的逗号、双引号和大括号是否完整。4. 重新加载并验证保存后回到MCP Tools页面确认agent-toolkit已出现并处于启用状态。如果 Cursor 没有立即识别配置可以按以下顺序处理关闭并重新打开 Cursor或重新加载当前窗口。回到MCP Tools页面确认agent-toolkit可以列出工具。新建一个 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-toolkitMCP 服务是否比较了多个航班方案再说明推荐理由选定航班后时间线、机场接驳和行程是否始终使用同一组航班是否标注查询日期、来源以及“待确认”的不确定信息是否把机票、签证、景点开放时间和交通变更提示为出发前复核项。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不必重复安装。