MCP 与插件

这一课你将能做到

1. 说清 MCP（Model Context Protocol）解决什么问题，以及它与内置工具、function calling 的关系
2. 用 claude mcp add 配置一个 MCP 服务器，区分 stdio / HTTP / SSE 三种传输与 local / project / user 三种作用域
3. 用项目级 .mcp.json 给全团队统一分发服务器，并用 mcp__ 前缀规则管理第三方工具的权限

为什么要学

内置工具只能操作本地文件和 shell。但真实开发要连数据库查线上数据、用浏览器做 E2E 验证、去监控系统看报错堆栈。MCP 是 Anthropic 在 2024 年底开源的协议，把「外部能力」标准化成即插即用的服务器：任何支持 MCP 的客户端（Claude Code、Claude Desktop 等）都能使用同一批服务器，社区已有数千个现成实现。插件（Plugin）则更进一步，把命令、子代理、MCP 服务器、Hooks 打包成一键安装的扩展包。

人话：MCP 之于 AI 工具，约等于 USB 之于电脑——统一的接口标准，插上就能用；插件则是「USB 集线器 + 驱动光盘」的组合装。

先建立图像

Claude Code（MCP 客户端）
   │ stdio（本地进程）          │ HTTP/SSE（远程服务）
   ▼                           ▼
┌──────────────┐        ┌──────────────┐
│ postgres-mcp │        │ sentry-mcp   │
│ 数据库查询    │        │ 线上报错检索  │
└──────────────┘        └──────────────┘
 工具名：mcp__postgres__query    mcp__sentry__search

三种作用域：

作用域	存储位置	谁能用	典型用途
local（默认）	用户级配置里	只有你	个人实验
project	项目根 .mcp.json	全团队（进 git）	团队统一工具
user	用户级配置	你的所有项目	个人常用工具

跟着做

步骤 1：添加第一个服务器（local 作用域）

以数据库类服务器为例（以所选服务器的官方 README 为准）：

claude mcp add airtable \
  --env AIRTABLE_API_KEY=你的密钥 \
  -- npx -y airtable-mcp-server

语法拆解：add <名字> + --env 传环境变量 + -- 之后是启动命令。stdio 类型就是在本地拉起一个子进程，通过标准输入输出通信。

步骤 2：验证与排查

claude mcp list          # 列出已配置服务器及连接状态
claude mcp get airtable  # 查看某个服务器的详细配置
claude mcp remove airtable

会话内用 /mcp 查看状态、查看服务器提供的工具与资源列表；需要 OAuth 授权的服务器会在这里引导登录。

步骤 3：升级为团队共享（project 作用域）

claude mcp add -s project my-server -- node ./tools/mcp-server.js

会在项目根生成 .mcp.json，提交进 git 后，同事启动 Claude Code 会收到启用提示：

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["./tools/mcp-server.js"],
      "env": { "MY_TOKEN": "${MY_TOKEN}" }
    }
  }
}