指南
MCP 入门
先用人话把 MCP 搞懂，再去看代码和协议细节。
MCP 解决什么问题
Agent 只有在能访问合适的工具和数据时才真正有用。如果没有统一协议，每接一个系统都要单独写适配层，不仅难维护，也很难检查、复用和控制权限。
先记住三个角色
1
客户端
想要使用能力的 AI 应用或运行时。
2
服务端
把真实系统包装成受控能力的连接层。
3
能力
真正可调用的工具，或者可读取的资源。
一个新手例子
假设有个 Agent 需要回答“Skill 页面讲了什么”。MCP 服务端提供一个 search_docs 工具，客户端发现它后，由模型决定是否调用，最后服务端返回相关页面。
用户：哪个页面解释了 Skill？
客户端看到可用工具：
search_docs({ query: string, limit: number })
客户端调用：
search_docs({ query: "Skill", limit: 2 })
服务端返回：
{
"results": [
{
"title": "什么是 Skill？",
"url": "/skill",
"snippet": "Skill 把可复用的步骤、规则和模板打包起来..."
}
]
}练习路线
按这个顺序学，能把概念一层一层堆起来，不会乱。
新手常见错误
分不清客户端和服务端如果你说不清自己在写哪一端，后面的设计一定前后不一致。
工具描述太模糊描述里没写清楚什么时候适用，模型就没法选它。
一次暴露全部能力把整个 API 面都包进来，会让工具清单没法用，权限也过宽。
忽略失败路径错误必须说明哪里出问题、重试有没有用，否则 agent 会一直打转。