展开知识库目录
MCP 是什么:让 AI 调用浏览器、文档和数据库的接口
MCP 是客户端和外部工具之间的连接协议。装上 MCP 后,Codex 或 Claude Code 可以读取网页、仓库、数据库等真实数据。它不是安全保证,权限和来源要单独核验。
先想清楚要连接什么数据和工具
MCP 是客户端和外部工具之间的连接协议。装上 MCP 后,Codex 或 Claude Code 能读取网页、仓库、数据库等真实数据。它不是“多一个插件”,而是一类真实能力的接口。
接 MCP 之前先想清楚:要连什么数据、谁维护这个服务器、它有什么权限、凭证放哪里。装完先用无副作用的只读任务验证,再扩大使用范围。
这些情况适合用,另外几种先停一下
适合用
- 任务需要读取网页、仓库、文档或数据库
- 想让 Codex 或 Claude Code 调用外部工具
- 现有工作流需要外部数据参与
先别急着用
- 任务用不到外部数据
- 服务器来源不明,先核验再装
先定连接目标,再按文档添加,最后做只读验证
为什么这样安排
Codex 官方 MCP 文档给出 `codex mcp add <名称> -- <启动命令>` 的命令格式;Claude Code 用 /mcp 或项目配置,两者不能混着写。
- 01
定连接目标
写清要读什么数据、做什么操作,选官方或可信来源的服务器,一次只接一个。
- 02
按客户端添加
Codex 用 `codex mcp add`,Claude Code 按当前文档配置,分别验证。
- 03
配置最小权限
凭证用最小作用范围,先只读,不要一上来给全部权限,用完即收。
- 04
做无副作用验证
用已知答案的只读任务测试返回内容,确认数据和范围正确,异常就暂停排查。
复制前先替换 {占位}
MCP 接入确认提示词(复制后改 {占位})
我想给{Codex / Claude Code}接入一个 MCP 服务器,请帮我确认方案:
要连接的外部工具:{工具名,如 GitHub / 浏览器 / 数据库}
用途:{要让 AI 做什么}
候选服务器:{GitHub 官方 MCP / 自建服务等}
请输出:
1. 这个工具是否值得用 MCP 接入,理由;
2. 推荐用哪个服务器地址或仓库,来源链接;
3. 需要哪些权限或密钥,最小够用方案;
4. 接入命令示例(codex mcp add / claude mcp add);
5. 接入后怎么验证真的能用。MCP 连接单(示例)
下面是已经填过变量的示例。复制时请换成自己的文件名、数字和材料位置,别把示例数据原样交出去。
看清格式再改
MCP 连接单(示例)
目标:读取 GitHub Issue 列表 服务器:官方 GitHub MCP 添加:codex mcp add github -- 命令 权限:只读,限定一个测试仓库 验证:列出 5 个 Issue,返回正确 凭证:Token 未进代码和截图
先对症状,别一上来重写整段提示词
装了一堆 MCP 后不知道哪个出错
- 常见原因
- 一次装太多
- 怎么修
- 删到只剩任务需要的一个,逐层排查。
连接成功但返回空
- 常见原因
- 凭证或权限范围问题
- 怎么修
- 检查凭证和只读范围,换小任务重试。
工具能调用但结果不可信
- 常见原因
- 没做验证任务
- 怎么修
- 先用已知答案的任务验证返回内容。
最后五分钟,逐项打勾
这篇具体参考了什么
正文按公开教程和官方文档重新整理,并换成了可以直接操作的中文场景。产品能力、规则和投稿要求会更新,真正执行前请再打开原始页面核对一次。
