MCP

MCP 入门:先理解连接,再接入第一个工具

分清宿主、客户端和服务端,理解接入成功与任务成功之间的区别。

先看一个使用场景

你在编程工具里问某个库的最新配置,希望 AI 直接读取官方文档,而不是根据记忆猜测。文档服务可以通过 MCP 向支持它的应用提供检索和读取能力。这只是一个场景,不代表所有 MCP 服务都只读。

认清三个角色

宿主是你正在使用的 AI 应用;客户端负责在宿主中与服务交互;服务端提供已声明的能力。用户通常在宿主里配置连接,但不同产品的配置方法和支持范围各有不同。

接入前问三件事

  • 服务由谁运营?地址能否从官方资料确认?
  • 它会接收什么数据,提供读取还是写入能力?
  • 是否需要登录,权限能否缩小到本次任务?

本地服务还涉及运行程序。把陌生的包启动命令粘贴进配置,意味着允许该程序在对应环境运行,应该先理解来源和作用。

分层检查故障

先看连接是否建立,再看能力能否列出,接着执行一个范围小的读取任务,最后检查返回内容是否支持结论。“已连接”只能证明其中一层,不能证明查到了正确资料。

text
连接失败 → 检查地址、网络和服务状态
认证失败 → 检查登录及授权范围
调用失败 → 检查输入与可用能力
答案不对 → 检查实际读取的资料与引用

设计第一个验收任务

选择官方只读文档服务,询问一项可在官网核对的配置,要求返回页面链接。对照原文检查,不要仅凭答案里出现了链接就认为已经检索成功。

下一步

阅读“把官方文档接进 Codex 与 Claude Code”,按自己使用的工具添加同一个文档服务。先验证读取,再考虑更复杂的账户连接和写操作。

官方资料与参考

产品功能与命令可能调整。遇到差异时,以对应官方页面和当前环境为准。

读完了,动手试一次。

完成练习后,标记进度,方便继续学习。