# MCP 入门：先理解连接，再接入第一个工具

原文：https://itjc.com/tutorials/mcp-explained/
主题：MCP；级别：入门；更新时间：2026-11-15。

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

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

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

## 接入前问三件事
- 服务由谁运营？地址能否从官方资料确认？
- 它会接收什么数据，提供读取还是写入能力？
- 是否需要登录，权限能否缩小到本次任务？

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

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

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

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

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

## 官方资料与参考

- [MCP 官方架构说明](https://modelcontextprotocol.io/docs/learn/architecture)
- [Claude Code MCP 指南](https://code.claude.com/docs/en/mcp)
