先看一个使用场景
你在编程工具里问某个库的最新配置,希望 AI 直接读取官方文档,而不是根据记忆猜测。文档服务可以通过 MCP 向支持它的应用提供检索和读取能力。这只是一个场景,不代表所有 MCP 服务都只读。
认清三个角色
宿主是你正在使用的 AI 应用;客户端负责在宿主中与服务交互;服务端提供已声明的能力。用户通常在宿主里配置连接,但不同产品的配置方法和支持范围各有不同。
接入前问三件事
- 服务由谁运营?地址能否从官方资料确认?
- 它会接收什么数据,提供读取还是写入能力?
- 是否需要登录,权限能否缩小到本次任务?
本地服务还涉及运行程序。把陌生的包启动命令粘贴进配置,意味着允许该程序在对应环境运行,应该先理解来源和作用。
分层检查故障
先看连接是否建立,再看能力能否列出,接着执行一个范围小的读取任务,最后检查返回内容是否支持结论。“已连接”只能证明其中一层,不能证明查到了正确资料。
连接失败 → 检查地址、网络和服务状态
认证失败 → 检查登录及授权范围
调用失败 → 检查输入与可用能力
答案不对 → 检查实际读取的资料与引用设计第一个验收任务
选择官方只读文档服务,询问一项可在官网核对的配置,要求返回页面链接。对照原文检查,不要仅凭答案里出现了链接就认为已经检索成功。
下一步
阅读“把官方文档接进 Codex 与 Claude Code”,按自己使用的工具添加同一个文档服务。先验证读取,再考虑更复杂的账户连接和写操作。