# 接外 · 用 MCP 把数据和工具接进来 · Cursor · 一台元工具 **作者** Aklman · **章节** 07 / 11 · **首发** 2026.07 · **语言** 中文为主, 中英双语 **原文** https://library.aklman.com/books/cursor/07-mcp **全书 markdown** https://library.aklman.com/books/cursor/llms.md **上一章** https://library.aklman.com/books/cursor/06-rules/llms.md **下一章** https://library.aklman.com/books/cursor/08-send-out/llms.md > 本章来自 Aklman · Library, 完整免费阅读。允许 AI 摘读、引用、问答; 转载请保留作者署名与原文链接 (CC BY-NC-ND 4.0, https://library.aklman.com/license)。 --- > 你的上下文大多不在项目里 —— 在 Linear 的工单、Figma 的稿、数据库的表、线上的日志里。MCP 让 agent 直接读它们、调它们，不用你来回粘。这是 Cursor 从「写代码」扩到「几乎做任何事」的接口。这一章讲 mcp.json 怎么配、哪些服务器值得接，以及为什么「能接」不等于「该接」。 你的上下文大多不在项目里 —— 在 Linear 的工单、Figma 的稿、数据库的表、线上的日志里。MCP 让 agent 直接读它们、调它们，不用你来回粘。 这是 Cursor 从「写代码」扩到「几乎做任何事」的接口，也是这本书「元工具」论点最关键的那块：代码库内的活靠索引，代码库外的活靠 MCP。这一章讲 mcp.json 怎么配、哪些服务器值得接、以及为什么「能接」不等于「该接」。 ### I · mcp.json 一配，工具就在它手里 接一个 MCP 服务器，就等于给 agent 多发一套它能调的工具。 先说省事的路：官方或社区的服务器，直接在 Customize 页 / Marketplace 里一键装，OAuth 当场走完，不用碰 JSON。[^1]手配则放两处：项目级 `.cursor/mcp.json`（随仓库走），全局 `~/.cursor/mcp.json`。传输有三种：stdio 跑本地命令、SSE 和 Streamable HTTP 接远程（带 OAuth）。服务器把能力暴露成 Tools（可调用的函数）、Prompts、Resources，agent 在 Chat 和 Plan 里按需调用。配一次，它以后自己去取，不用你再贴。下面是一个本地服务器加一个远程服务器： ```json { "mcpServers": { "local-tools": { "command": "python", "args": ["mcp-server.py"], "env": { "API_KEY": "${env:MY_API_KEY}" } }, "remote-service": { "url": "https://example.com/mcp", "headers": { "Authorization": "Bearer ${env:TOKEN}" } } } } ``` 注意密钥那一行用的是 `${env:MY_API_KEY}`，不是明文 —— 把真实凭证写进 mcp.json 再提交，等于把钥匙挂在仓库里。用环境变量引用，远程的尽量走 OAuth。 --- ### II · 它是「几乎做任何事」的接口 代码库内的活靠索引，代码库外的活靠 MCP。 实际接法：Linear（读写工单）、Figma（取设计稿）、数据库（查表、跑只读查询）、Sentry（拉线上错误）、各种网页 / 文档服务器。接上之后，agent 不再需要你把这些粘进来 —— 它自己去工单里读需求、去数据库里核对字段、去错误平台里定位堆栈。 对非编码的活，MCP 是它的数据臂膀：调研时拉一手数据、运维时查状态、写作时取资料。这正是「在一个窗口里干完」能成立的原因之一 —— 不是 Cursor 内置了这些功能，是它能通过 MCP 把你已经在用的系统接进同一个 agent。 --- ### III · 能接，不等于该接 每接一个服务器，都同时多了一份攻击面、一截上下文膨胀、一个可能误触的工具。[^2] 默认每次调用都要你审批，可在 permissions.json 预授权一个 allowlist；但权限给得越宽，风险越大。一个 MCP 服务器是在你机器上、用你的凭证跑的外部代码 —— 它能读什么、能写什么，连之前就要看清，给最小的那一份。来路不明、你没法读源码的服务器，别接。 | 风险级别 | 例子 | 默认策略 | |---|---|---| | 只读 | 读文档、读 issue、查只读数据库视图 | 可接，仍保留首次审批 | | 草拟 | 创建草稿 ticket、生成 PR 评论草稿 | 可接，但要求人发布 | | 写入 | 改 Linear 状态、写 Notion、更新测试环境数据 | 按工具逐个审批，最小权限 | | 高风险 | 生产数据库、支付、云控制台、密码管理器、钱包 | 默认不接；隔离环境 + 人工确认才考虑 | | 选择 | 适合 | 不适合 | |---|---|---| | MCP | 反复使用、需要实时外部系统、可定义权限的工具 | 一次性小材料、来路不明工具 | | 直接上传 / @ 文件 | 稳定文档、离线资料、可版本化材料 | 需要实时状态或写回系统 | | 浏览器 | 需要人工登录、视觉检查、一次性网页 | 需要可重复自动化 | | API 脚本 | 可测试、可审计、固定流程 | 探索性、多工具、多上下文任务 | 判断：只接你这周真用得上的两三个，别把 MCP 目录当装机清单。接得越多，agent 越容易在一堆工具里挑错那个、跑得也越慢 —— MCP 让它能做更多，但不是接得越多越强。 团队里，这个判断从「配置」升级成「治理」：3.10 起，管理员把 Team MCP 配一次、放进团队 marketplace，就能分发到 cloud agents、Agents 窗口、IDE、CLI —— 成员一键装已审批的集成，不用各自折腾 server 和凭证。[^3]谁来审、放行哪些、给多宽的权限，这些个人版里你替自己做的决定，团队版里得有人明确地替所有人做。 > 凭证别写进 mcp.json 的明文里 —— 用 ${env:VAR} 引用，远程服务器走 OAuth。提交前检查 .cursor/mcp.json 像检查一段基础设施配置：它能动你的真实系统，写错一行的代价不只是报错。 - 来源可信、能读源码或来自官方 marketplace。 - 凭证最小权限、可撤销、不过期也能轮换。 - 第一次只开只读工具，跑一次真实任务后再考虑写入。 - 工具描述清楚，不会让 Agent 误以为能做高风险操作。 - permissions.json / Run Mode 没有把陌生写入工具全自动放行。 - 不要接钱包、交易、支付、生产数据库写权限。 - 不要接能删除云资源或改 IAM / 权限的云控制台工具。 - 不要接你无法审计源码、权限说明模糊、要求过宽 token 的服务器。 接一个你真用得上的服务器，再删一个你「以防万一」接的： - 挑一个你本周真会用的服务器（文档 / 数据库 / Linear 之类），配进 mcp.json。 - 让 agent 做一件必须用到它的任务，确认它先请求了审批。 - 检查它给这台服务器开了哪些权限，收到最小；凭证用 ${env:VAR}，不写明文。 - 删掉一个你接了却没真用过的服务器。 > 上下文大多不在项目里， > MCP 是去取它的那只手 ## 引用与参考 01 · Cursor Docs · MCP —— 两条接入路：从 Customize 页 / Marketplace 一键安装（OAuth 直接走完），或用 JSON 手配：项目级 .cursor/mcp.json、全局 ~/.cursor/mcp.json；支持 stdio / SSE / Streamable HTTP 三种传输。服务器暴露 Tools / Prompts / Resources 等；每次调用默认需审批，可用 MCP allowlist 预授权。截至 2026-07-10。 (Cursor Docs · MCP) 02 · Model Context Protocol —— MCP 是连接 AI 应用与外部工具 / 数据的开放标准，由 Anthropic 提出，已被多家客户端采用；Cursor 的连接器即基于它。 (modelcontextprotocol.io) 03 · Cursor Docs · Plugins / Team marketplaces —— 3.10（2026-06-30）起：管理员把已配置给 Cloud Agents 的 Team MCP servers 放进团队 marketplace，成员即可在 Agents 窗口、IDE、CLI 一键安装已审批的集成，不必各自配 server；加进 marketplace 不等于替所有人安装，管理员仍控制访问与安装模式。截至 2026-07-10。 (Cursor Docs · Team marketplaces) --- *接外 · 用 MCP 把数据和工具接进来 · Cursor · 一台元工具 · Aklman 著 · CC BY-NC-ND 4.0 · https://library.aklman.com/books/cursor/07-mcp*