M
01 · 介绍
什么是 MCP
把 USB 接口想象一下:任何设备只要插头对得上,就能接到任何电脑上。MCP(Model Context Protocol,模型上下文协议)对 AI 助手来说,就是这样一个“插头”。
MCP 服务器是一个小程序,它对外提供一些有用的能力:你的文件、数据库、日历、公司知识库、网页搜索等等。MCP 客户端则是使用这些能力的助手,例如 Claude、Claude Code、Cursor,以及许多其他工具。
服务器一旦建好,每个支持 MCP 的客户端都可以使用它。在 MCP 出现之前,每个助手都需要为每个工具单独开发一套集成。
一个服务器可以提供三类东西:工具(助手可以调用的操作)、资源(助手可以读取的数据)和提示词(现成的指令模板)。
02 · 适合什么场景
何时使用
- 你希望 Claude 在你聊天时读取项目文件夹或笔记应用中的文件。
- 你的团队有一套内部系统(工单工具、数据库),你希望助手能安全地查询它。
- 你使用多种 AI 工具,厌倦了在每个工具里重复配置同一个集成。
- 你正在开发产品,希望其他人的助手能与之协作。
如果只是一次性任务,可以直接粘贴到聊天中,不需要 MCP。
03 · 配置
连接你的第一个服务器
最快的入门方式是使用 Claude Desktop 配合文件系统服务器:
- 如果尚未安装 Node.js,请先安装。
- 打开 Claude Desktop → Settings(设置)→ Developer(开发者)→ Edit Config(编辑配置)。
- 添加一个服务器条目,指向你允许访问的文件夹:
{
"mcpServers": {
"files": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents/agents"]
}
}
}
- 重启 Claude Desktop。此时会出现一个工具图标;然后询问“列出我 agents 文件夹中的文件”。
现在许多服务都提供托管的 MCP 服务器,你无需运行本地命令,只需通过 URL 和登录信息即可连接。
04 · 使用说明
日常使用
- 用自然语言提问;助手会自行决定调用哪个工具,并且在做任何会改动数据的操作之前先征求你的同意。
- 保持已连接的服务器列表简短。每个服务器都会增加模型在每一轮都必须阅读的指令。
- 在你充分信任这套配置之前,优先使用只读服务器;写入权限应逐个工具地单独添加。
- 工具调用失败时,错误信息通常会出现在助手的回复中。先阅读这些信息,再决定是否重试。
05 · 注意事项
常见陷阱
- 服务器以你的权限运行。 指向你主目录的文件系统服务器可以读取其中的所有内容。请只指向一个文件夹。
- 信任发布者。 从供应商或官方列表安装服务器,不要从随意的代码仓库安装。
- 提示词注入。 服务器返回的数据(如网页、文档)可能包含试图向助手下达指令的文字。应将工具输出视为数据,而不是指令。
- 本地服务器需要安装 Node.js 或 Python,并会在应用关闭时停止运行;托管服务器则不会。
06 · 资源
接下来去哪里
即使你从不自己搭建服务器,这份规范也很容易读懂;快速入门教程是最快看到它实际运行的方式。
我的笔记
登录后可以在这本手册上记私人笔记。登录
