第 14 章 MCP——连接外部世界

❓ 引导问题：MCP 协议的核心思想是什么？如何配置和管理 MCP 服务器？三种传输方式怎么选？

📖 14.1 什么是 MCP

MCP（Model Context Protocol）是 Anthropic 推出的开放标准化协议，让 Claude Code 能连接外部工具和数据源。

核心思想转换：不要让 AI 逐一学习所有工具的使用规则，而是让所有工具提供统一接口给 AI——就像通用插座，不用让电器适配不同插座，只要插座统一标准，所有电器都能直接使用。

场景	无 MCP 时	有 MCP 时
跨仓库分析	只能分析当前文件夹内代码	跨仓库协作："分析仓库 A 的接口文档，在仓库 B 中编写调用方法"
需求同步	手动复制粘贴需求文档	实时同步："查 Slack #feature-x 频道的讨论记录"
数据库验证	手动查表结构	直接联动："查 MySQL users 表结构，判断查询接口是否匹配"
自动化流程	只能生成代码片段	自动化执行："调用 Puppeteer 验证登录页面交互逻辑"

MCP 服务器提供三种能力：工具（tools）——执行操作，资源（resources）——暴露数据，提示（prompts）——预定义指令模板。

📖 14.2 核心管理命令

Claude Code 内置完整的 MCP 管理能力：

命令	作用
claude mcp add	添加 MCP 服务器
claude mcp list	查看所有已配置服务器
claude mcp get <name>	查看服务器详情
claude mcp remove <name>	删除服务器
/mcp	在对话中查看状态和完成 OAuth 认证

📖 14.3 三种传输方式

HTTP 远程服务器（推荐）

适用云服务类工具，最通用：

# 基础
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 带身份验证
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer 你的令牌"

SSE 远程服务器（已弃用）

仅兼容旧版工具，优先用 HTTP 替代：

claude mcp add --transport sse asana https://mcp.asana.com/sse

Stdio 本地服务器

适用需要本地系统访问的工具（数据库、自定义脚本）：

claude mcp add --transport stdio --env AIRTABLE_API_KEY=密钥 airtable \
  -- npx -y airtable-mcp-server

⚠️ --transport/--env 等参数必须在服务器名称前面，-- 用于分隔 Claude 参数和服务器命令。Windows 下用 npx 需加 cmd /c 包装。

📖 14.4 配置范围

范围	用途	配置命令
local（默认）	仅当前项目，私密配置	claude mcp add --scope local ...
project	团队共享（存储在 .mcp.json，可提交 Git）	claude mcp add --scope project ...
user	所有项目可用（个人全局）	claude mcp add --scope user ...

优先级：local > project > user（同名服务器，本地覆盖共享配置）。

📖 14.5 实用示例

GitHub 代码审查：

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

> Review PR #456 and suggest improvements
> Show me all open PRs assigned to me

Sentry 生产环境排错：

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

> /mcp   # 完成 OAuth 登录
> What are the most common errors in the last 24 hours?

直接查询 PostgreSQL：

claude mcp add --transport stdio db \
  -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

📖 14.7 常用 MCP 服务器

MCP市场：https://mcpmarket.com/zh

服务器	功能	当前项目安装	全局安装
server-postgres	查询 PostgreSQL 数据库	npx -y @modelcontextprotocol/server-postgres
server-github	操作 GitHub（PR、Issue 等）	npx -y @modelcontextprotocol/server-github
server-filesystem	访问指定目录的文件	npx -y @modelcontextprotocol/server-filesystem
server-brave-search	网络搜索	npx -y @modelcontextprotocol/server-brave-search
playwright	浏览器自动化	claude mcp add playwright npx '@playwright/mcp@latest'	claude mcp add -s user playwright npx '@playwright/mcp@latest'

📖 14.要点总结

1. MCP 核心思想：不让 AI 学所有工具，而是让所有工具提供统一接口给 AI（通用插座思维）
2. 三种传输方式：HTTP（推荐，远程服务）→ Stdio（本地进程）→ SSE（已弃用）
3. 三层配置范围：local（个人密钥）→ project（团队共享，提交 Git）→ user（全局）
4. /mcp 命令是对话中管理 MCP 的核心入口，远程服务需通过它完成 OAuth 认证
5. MCP 命令格式：/mcp__服务器__命令，支持 @ 引用资源（@github:issue://123）