展开知识库目录
MCP 与 Skills

MCP 是什么:让 AI 调用浏览器、文档和数据库的接口

MCP 是客户端和外部工具之间的连接协议。装上 MCP 后,Codex 或 Claude Code 可以读取网页、仓库、数据库等真实数据。它不是安全保证,权限和来源要单独核验。

MCP 与外部工具含可复制模板更新 2026-08-13
先说结论

先想清楚要连接什么数据和工具

MCP 是客户端和外部工具之间的连接协议。装上 MCP 后,Codex 或 Claude Code 能读取网页、仓库、数据库等真实数据。它不是“多一个插件”,而是一类真实能力的接口。

接 MCP 之前先想清楚:要连什么数据、谁维护这个服务器、它有什么权限、凭证放哪里。装完先用无副作用的只读任务验证,再扩大使用范围。

使用边界

这些情况适合用,另外几种先停一下

适合用
  • 任务需要读取网页、仓库、文档或数据库
  • 想让 Codex 或 Claude Code 调用外部工具
  • 现有工作流需要外部数据参与
先别急着用
  • 任务用不到外部数据
  • 服务器来源不明,先核验再装
照着做

先定连接目标,再按文档添加,最后做只读验证

为什么这样安排

Codex 官方 MCP 文档给出 `codex mcp add <名称> -- <启动命令>` 的命令格式;Claude Code 用 /mcp 或项目配置,两者不能混着写。

  1. 01

    定连接目标

    写清要读什么数据、做什么操作,选官方或可信来源的服务器,一次只接一个。

  2. 02

    按客户端添加

    Codex 用 `codex mcp add`,Claude Code 按当前文档配置,分别验证。

  3. 03

    配置最小权限

    凭证用最小作用范围,先只读,不要一上来给全部权限,用完即收。

  4. 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 后不知道哪个出错

常见原因
一次装太多
怎么修
删到只剩任务需要的一个,逐层排查。

连接成功但返回空

常见原因
凭证或权限范围问题
怎么修
检查凭证和只读范围,换小任务重试。

工具能调用但结果不可信

常见原因
没做验证任务
怎么修
先用已知答案的任务验证返回内容。
交付前检查

最后五分钟,逐项打勾

参考资料

这篇具体参考了什么

正文按公开教程和官方文档重新整理,并换成了可以直接操作的中文场景。产品能力、规则和投稿要求会更新,真正执行前请再打开原始页面核对一次。