M

MCP

推荐

Model Context Protocol:一种标准化的“插头”,让 AI 助手无需定制集成即可使用你的工具和数据。

本文由 AI 翻译。 阅读原文

6 个章节27 篇教程官网

01 · 介绍

什么是 MCP

把 USB 接口想象一下:任何设备只要插头对得上,就能接到任何电脑上。MCP(Model Context Protocol,模型上下文协议)对 AI 助手来说,就是这样一个“插头”。

MCP 服务器是一个小程序,它对外提供一些有用的能力:你的文件、数据库、日历、公司知识库、网页搜索等等。MCP 客户端则是使用这些能力的助手,例如 Claude、Claude Code、Cursor,以及许多其他工具。

服务器一旦建好,每个支持 MCP 的客户端都可以使用它。在 MCP 出现之前,每个助手都需要为每个工具单独开发一套集成。

一个服务器可以提供三类东西:工具(助手可以调用的操作)、资源(助手可以读取的数据)和提示词(现成的指令模板)。

02 · 适合什么场景

何时使用

  • 你希望 Claude 在你聊天时读取项目文件夹或笔记应用中的文件。
  • 你的团队有一套内部系统(工单工具、数据库),你希望助手能安全地查询它。
  • 你使用多种 AI 工具,厌倦了在每个工具里重复配置同一个集成。
  • 你正在开发产品,希望其他人的助手能与之协作。

如果只是一次性任务,可以直接粘贴到聊天中,不需要 MCP。

03 · 配置

连接你的第一个服务器

最快的入门方式是使用 Claude Desktop 配合文件系统服务器:

  1. 如果尚未安装 Node.js,请先安装。
  2. 打开 Claude Desktop → Settings(设置)→ Developer(开发者)→ Edit Config(编辑配置)。
  3. 添加一个服务器条目,指向你允许访问的文件夹:
{
  "mcpServers": {
    "files": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents/agents"]
    }
  }
}
  1. 重启 Claude Desktop。此时会出现一个工具图标;然后询问“列出我 agents 文件夹中的文件”。

现在许多服务都提供托管的 MCP 服务器,你无需运行本地命令,只需通过 URL 和登录信息即可连接。

04 · 使用说明

日常使用

  • 用自然语言提问;助手会自行决定调用哪个工具,并且在做任何会改动数据的操作之前先征求你的同意。
  • 保持已连接的服务器列表简短。每个服务器都会增加模型在每一轮都必须阅读的指令。
  • 在你充分信任这套配置之前,优先使用只读服务器;写入权限应逐个工具地单独添加。
  • 工具调用失败时,错误信息通常会出现在助手的回复中。先阅读这些信息,再决定是否重试。

05 · 注意事项

常见陷阱

  • 服务器以你的权限运行。 指向你主目录的文件系统服务器可以读取其中的所有内容。请只指向一个文件夹。
  • 信任发布者。 从供应商或官方列表安装服务器,不要从随意的代码仓库安装。
  • 提示词注入。 服务器返回的数据(如网页、文档)可能包含试图向助手下达指令的文字。应将工具输出视为数据,而不是指令。
  • 本地服务器需要安装 Node.js 或 Python,并会在应用关闭时停止运行;托管服务器则不会。

06 · 资源

接下来去哪里

即使你从不自己搭建服务器,这份规范也很容易读懂;快速入门教程是最快看到它实际运行的方式。

我的笔记

登录后可以在这本手册上记私人笔记。登录