[!abstract] 本文要点
介绍 MCP（Model Context Protocol）的原理与三种连接方式（stdio / SSE / HTTP），并给出 Filesystem、Playwright、GitHub、Sentry、Vercel、Context7 六个高频 MCP 的安装命令与使用场景。

1. 什么是 MCP？

Model Context Protocol (MCP) 直译就是“模型上下文协议”，其实它就是一个标准接口，让大模型可以像插 USB-C 接口一样，去访问你的工具、代码库和数据源。在 Claude Code 中，可以通过 MCP 连接到数百个外部工具和数据源。

当工具变成一个 MCP 服务器，Claude Code 这类客户端就能发现这个工具（比如 GitHub、Sentry、Notion），连接并完成授权，直接调用它的功能。

2. 原理和基础操作

前面说了，MCP 就像给 Claude 插上 USB 接口，那它是怎么连上去的？其实主要有三种方式：

1. 本地 stdio

最常见，适合连接你电脑上的工具，比如：本地 Git 仓库、文件系统。Claude 会直接在你本地起一个进程，通过标准输入输出和 MCP 服务器对话。

# Basic syntax
claude mcp add <name> <command> [args...]
# Real example: Add Airtable server
claude mcp add airtable --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

2. 远程 SSE（Server-Sent Events）

适合一些需要实时推送更新的服务，比如任务流转、协作工具。Claude 会一直保持一个长连接，能第一时间拿到数据更新。

# Basic syntax
claude mcp add --transport sse <name> <url>
# Real example: Connect to Linear
claude mcp add --transport sse linear https://mcp.linear.app/sse

3. 远程 HTTP

最常见的云服务连接方式，比如 Vercel、Sentry。Claude 需要的时候才发请求，拿到结果再整合到对话里。

# Basic syntax
claude mcp add --transport http <name> <url>
# Real example: Connect to Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

几个常用的管理 MCP 的命令：

• claude mcp get 名称 → 查看某个 MCP 详情
• claude mcp list → 查看当前连了哪些 MCP
• claude mcp remove 名称 → 移除不用的 MCP
• /mcp → 在聊天框里触发登录授权（OAuth 流程）

再来聊聊配置作用域，作用域是在添加 MCP 时通过命令行参数**–scope**来指定的。可以分成三个层级，取决于 .mcp.json 配置文件保存在哪里：

1. local（本地目录）

如果你在某个目录里运行 claude mcp add …，Claude 会在这个目录下生成一个 .mcp.json。这样 MCP 配置只对这个目录里的项目生效。

2. project（项目级）

类似 local，但通常会把 .mcp.json 直接提交到代码仓库里（比如放在根目录）。团队成员一拉仓库，Claude Code 就能识别到这些配置。适合做团队统一的 MCP 接入方案。

3. user（用户全局）

如果你加 MCP 的时候指定了全局作用域，Claude 会把配置写在用户目录下。不管你在哪个项目里，都能用这些 MCP。

默认情况下，Claude 会用local（在当前目录保存配置）。如果你想明确指定作用域，可以在命令里加参数：

# 在用户全局作用域添加一个 MCP
claude mcp add github --scope user -- npx -y @modelcontextprotocol/server-github
# 在项目作用域（当前目录）添加 MCP
claude mcp add sentry --scope project --transport http https://mcp.sentry.dev/mcp

3. 高频推荐 MCP

3.1. Filesystem MCP —— 读写文件系统

让 Claude 能访问你指定的本地文件夹。

# macOS / Linux
claude mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/Projects
# Windows
claude mcp add fs -- cmd /c npx -y @modelcontextprotocol/server-filesystem "C:\Projects"

3.2. Playwright MCP —— 浏览器自动化

让 Claude 操作浏览器，跑自动化测试或采集数据。

claude mcp add playwright -- npx -y @playwright/mcp@latest

比如让它打开 Twitter 网站，浏览前 10 篇帖子，给出相应的总结提炼。

3.3. GitHub MCP —— 远程仓库协作

把 Claude 接入 GitHub 的 PR、Issue。

claude mcp add github \
  --env GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxx \
  -- npx -y @modelcontextprotocol/server-github

3.3.1. 使用场景：

• 拉取一个 PR → Claude 自动生成 Review 意见
• 根据 Issue 描述 → Claude 写出修复思路
• 查询某个 Repo 的最新发布版本

3.4. Sentry MCP —— 线上监控日志

让 Claude 直接读你的错误监控数据。

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
# 然后在 Claude 里输入 /mcp 完成授权

3.4.1. 使用场景：

• 查询过去一小时最频繁的报错
• 追踪某个错误的堆栈信息，生成排障建议
• 按版本统计错误趋势

3.5. Vercel MCP —— 部署与环境

Claude 可以直接和 Vercel 打交道。

claude mcp add --transport http vercel https://mcp.vercel.com/
# /mcp 授权登录

3.5.1. 使用场景：

• 查询最近几次部署的日志
• 回滚到上一个版本
• 查看项目环境变量

3.6. Context7 MCP —— 实时技术文档

获取最新的 API 文档还有最新的代码示例，避免生成过时或不存在的 API 或用法，让开发更高效更省心。

claude mcp add context7 -- npx -y @context7/mcp-server

实际包名可能因版本迭代有变化，建议查看 Context7 的官方仓库或 npm 包说明。

官网地址：https://context7.com/

GitHub 地址：https://github.com/upstash/context7/blob/master/README.md