00 / 00
MCP 协议
理解 MCP 的客户端、服务端、传输方式和最小权限配置。
MCP（Model Context Protocol）是连接 AI 应用与外部工具、数据源的开放协议。它统一的是连接方式，不会自动保证工具安全、稳定或适合你的项目。
两个角色
- MCP Client：Codex、Claude Code、编辑器或其他 AI 应用。
- MCP Server：提供工具、资源或提示模板的服务。
Client 读取 Server 暴露的能力，再由模型决定何时发起调用。最终权限仍由本机、账号和 Server 配置决定。
当前传输方式
| 方式 | 适用场景 |
|---|---|
stdio | 本地进程，由 Client 启动并通过标准输入输出通信 |
| Streamable HTTP | 远程服务，使用标准 HTTP 请求和可选流式响应 |
旧教程常写的 HTTP + SSE 传输已经被 Streamable HTTP 取代。维护旧集成时可以看到 SSE，新项目不要再把它当首选方案。
在 Claude Code 中配置
优先使用官方命令，不手写来源不明的配置：
claude mcp add --transport stdio example -- npx -y @example/mcp-server
claude mcp list项目级共享配置使用 .mcp.json。.claude/settings.json 负责 Claude Code 设置，不是 MCP Server 的主要项目配置文件。
具体参数以 Claude Code MCP 文档 为准。
安全检查
安装 MCP Server 前确认：
- 代码和发布者来源可信。
- 文件、数据库、浏览器和云账号权限只给任务所需范围。
- 密钥放在环境变量或密钥管理器，不写进仓库。
- 会修改数据的工具支持确认、撤销或隔离环境。
- 远程 Server 说明认证、日志、留存和删除策略。
MCP Server 相当于给 Agent 增加操作能力。能读写文件、执行命令或访问生产数据的 Server，风险与本地脚本和后台账号相同。
这篇文档有问题？