Model Context Protocol（MCP）让 Cursor Agent 可以调用外部工具并读取经过批准的数据源，例如文档搜索、问题跟踪、浏览器或内部服务。连接 MCP 会扩大 Agent 的能力，因此配置、凭证与工具审批都应像开发依赖一样接受审查。
先判断是否真的需要 MCP
只有当 Agent 需要稳定访问某个外部系统时，才应添加 MCP，不要仅因为某个服务器流行就安装。开始前回答：
- 哪个具体任务需要它？
- 谁发布和维护服务器？
- 它能访问哪些工具、文件、网络地址或账号？
- 只能读取，还是可以修改数据？
- 凭证如何保存和轮换？
- 如何停用并审计服务器？
如果只是查询一次公开资料，经过检查的网页链接可能比长期工具连接更安全。
选择项目级或全局配置
Cursor 当前 MCP 文档支持两个常见位置：
<project>/.cursor/mcp.json # 团队共享的项目配置
~/.cursor/mcp.json # 跨项目使用的个人配置项目配置适合仓库要求所有贡献者使用的工具，提交前应经过代码评审。全局配置更适合个人工具和账号集成。Cursor 会合并两者；当前文档说明，同名服务器出现时项目配置优先。
配置本地 stdio 服务器
本地服务器由命令启动。真实命令和参数必须来自服务器的可信文档。下面只演示安全的配置形状，通过环境变量插值避免写入真实密钥：
{
"mcpServers": {
"project-docs": {
"command": "node",
"args": ["${workspaceFolder}/tools/docs-server.mjs"],
"env": {
"DOCS_TOKEN": "${env:DOCS_TOKEN}"
}
}
}
}Cursor 文档说明，受支持字段可使用 ${workspaceFolder}、${userHome} 和 ${env:NAME} 等变量。把真实凭证保存在系统或 shell 环境中，将本地密钥文件排除在 Git 之外；若桌面应用读不到新变量，应重启 Cursor。
配置远程 MCP 服务器
托管服务器使用 URL，并可能需要认证：
{
"mcpServers": {
"team-service": {
"url": "https://mcp.example.com/mcp",
"headers": {
"Authorization": "Bearer ${env:TEAM_MCP_TOKEN}"
}
}
}
}示例地址只能替换为服务所有者提供的真实 URL。传输专有上下文前，应核对 TLS、数据位置、日志、保留策略和账号范围。不要把 bearer token 直接写进将要提交的 mcp.json。
在 Cursor 中启用并验证服务器
- 打开 Customize → MCPs。
- 找到服务器，核对配置来源和连接状态。
- 如处于停用状态，手动启用。
- 阅读可用工具名称与说明。
- 从指定工具的只读请求开始。
- 批准调用前检查参数。
- 确认返回内容只包含预期数据。
Cursor 默认会在 MCP 工具调用前请求审批，但 Run Mode 和组织政策可能改变行为，因此不要假设每次都会暂停。对能够写文件、发送消息、查询生产数据或触发部署的工具，应保持最小批准范围。
用边界清晰的提示词测试
只使用 project-docs MCP 服务器。
查找项目文档规定的本地测试命令，并返回来源页面标题。
不要修改文件、执行终端命令或调用任何写入工具。然后与原始来源核对答案。连接状态正常，只能证明 Cursor 能与服务器通信，不能证明工具结果正确或安全。
保护凭证和敏感数据
- 通过环境变量引用凭证，不要提交 token；
- 给予最小权限，并使用尽可能短的有效期；
- 分离开发和生产账号；
- 不要开放
.env、私钥、客户记录或无限制数据库工具； - 检查工具参数和返回内容中的提示注入与意外凭证；
- 设备、成员或集成移除后及时撤销凭证。
MCP 服务器在语言模型之外执行。Cursor 审批界面是有用的检查点，但不能替代服务端授权、审计日志、备份和网络控制。
Cursor MCP 常见问题
服务器显示断开连接
打开 Cursor Output 面板并选择 MCP 日志，检查可执行文件路径、参数、工作目录、运行时，以及桌面进程能否读取环境变量。
已连接但没有工具
确认服务器实现了 Cursor 支持的 MCP 能力，并完成启动握手。检查服务日志时不要输出凭证。
远程服务器返回认证错误
核对环境变量名称、token 权限、有效期和服务器 URL。只要 token 曾进入对话、日志或源码，就应立即轮换。
错误的配置覆盖了正确配置
检查项目与全局 mcp.json 是否存在同名服务器。使用清楚的名称并删除过期重复项，不要依赖偶然优先级。
Agent 调用工具过于自由
先停用服务器、缩小账号权限，再检查 Cursor 当前审批或 permissions.json 控制。包含读写混合工具的服务器不应整体放行。
用规则记录工具使用边界
连接验证后，记录项目何时应该调用工具，以及调用后必须执行哪些检查。Cursor Rules 教程介绍了如何让这些说明保持范围清晰并进入版本管理。规则只负责指导 Agent，真正的边界仍由 MCP 服务器和账号权限执行。