MCP

MCP（Model Context Protocol，模型上下文协议）是开放协议，用来把 AI 应用连接到外部工具、数据源和服务。支持 MCP 的客户端、IDE、CLI 或桌面应用可以复用同一类 Server。不支持 MCP 的工具，仍可能用插件、内置工具、API 或企业网关实现类似能力。

目的是统一连接方式，避免每个 AI 工具为每个外部服务单独做集成。

常见用途：查询 Issue、Pull Request、代码历史和 CI；读取内部文档、接口规范、设计系统；查询数据库 Schema、测试数据或服务状态；调用内部 API、工单或消息系统。

组成

• Host：用户使用的 AI 应用、IDE 或 Agent 平台。
• Client：Host 内部连接 Server 的组件。
• Server：提供外部数据或操作的服务。

Server 通常提供：

• Tools：可执行操作，如搜索 Issue、查询数据库、创建工单。
• Resources：可读取内容，如文档、Schema、配置、知识库。
• Prompts：可复用的任务模板或预设指令。

通信

本地 Server 由客户端启动，经标准输入发送请求，从标准输出读取响应。

消息使用 JSON-RPC。请求包含 jsonrpc、id、method 和可选的 params；响应用相同的 id 关联结果或错误。

适用条件

信息在仓库之外，且需要实时查询或受控操作：内部文档平台上的规范，需实时核对的 API 契约或数据库结构，依赖 Issue、PR、CI 或发布状态的任务，设计系统、工单或内部服务，以及多个 AI 工具复用同一外部能力。

仓库内已经稳定的规则和文档，使用 README.md、AGENTS.md、Skill 或普通文档。

分工

项目规则与长期约束 -> AGENTS.md
特定任务的执行流程 -> Skill
当前任务目标 -> Prompt
外部服务与实时信息 -> MCP

AGENTS.md 只写哪些任务使用外部工具，以及允许的操作范围，不写完整配置。服务清单另记：允许的 Server、用途、权限范围、认证方式。Token、私有地址和账号不提交到仓库。

Server 可以在多个工具间复用。客户端的配置入口、认证和权限各自按该工具的规范接入，不能把一份客户端配置直接复制到所有工具。

安全

Server 可能读取数据、修改记录、执行命令或调用外部 API。

• 最小权限，优先只读；写入能力单独开放。
• 开发、测试、生产使用不同凭据和不同 Server。
• API Key、Token、Cookie、数据库密码不写入仓库、AGENTS.md 或 Skill。
• 来源不明的 Server 不安装。
• 写入、删除、发消息、发布、部署、支付先确认再执行。
• 一个 Server 只提供边界清晰的能力，不混入无关工具。名称、描述和参数保持可审计，防止恶意工具描述或提示注入。
• 生产环境、敏感数据和密钥使用独立权限边界。
• 定期检查权限、依赖版本和日志，清理不再使用的 Server 和凭据。