为什么需要这个#

想象 Claude Code 是您的助手,坐在电脑前。默认情况下它能处理文件和运行命令。但如果您需要它检查 Jira 中的任务、阅读 Slack 中的消息或查看数据库呢?

为此存在 MCP 服务器——将 Claude Code 连接到外部服务和工具的"适配器"。

什么是 MCP#

MCP(Model Context Protocol,模型上下文协议)是将 AI 工具连接到外部服务的标准方式。把它想象成 Claude 的 USB 端口:每个 MCP 服务器就是一个您插入的"设备",获得新的功能。

💡 协议是一套通信规则。就像语言:如果双方说同一种语言(协议),他们就能互相理解。MCP 就是 Claude Code 与外部服务通信的"语言"。

可以连接什么#

服务 提供的功能
GitHub 创建任务、pull request,查看代码
Jira / Asana 读取任务,更新状态
Slack 读取和发送消息
PostgreSQL 查询数据库
Notion 处理文档和笔记
Figma 获取设计稿信息
Sentry 分析应用错误

还有更多——列表不断增长。

连接类型#

有三种方式连接 MCP 服务器:

1. 远程 HTTP 服务器(推荐)#

服务在云端运行,您只需指定其地址:

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

2. 远程 SSE 服务器#

类似于 HTTP,但使用不同的数据传输技术:

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

3. 本地服务器(stdio)#

程序直接在您的计算机上运行:

claude mcp add --transport stdio airtable -- npx -y airtable-mcp-server

💡 对于初学者,远程服务器(HTTP/SSE)最合适——不需要安装额外的程序。

分步指南:连接 MCP 服务器#

步骤1:选择服务#

决定您需要哪个服务。以 Notion 为例。

步骤2:添加服务器#

打开终端并执行:

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

逐部分解析命令:

  • claude mcp add — “添加 MCP 服务器”
  • --transport http — 连接类型(通过互联网)
  • notion — 您给服务器起的名称(可以是任意名称)
  • https://mcp.notion.com/mcp — 服务器地址

步骤3:授权(如需要)#

某些服务器需要访问密钥:

claude mcp add --transport http my-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-access-key"

💡 Bearer token(访问令牌)是 API 服务的"密码"。通常可以在服务的设置中获取。

步骤4:验证连接#

启动 Claude Code 并输入:

/mcp

您会看到已连接服务器的列表及其状态。

管理服务器#

查看所有已连接的服务器#

claude mcp list

查看特定服务器的详情#

claude mcp get notion

删除服务器#

claude mcp remove notion

使用示例#

处理任务跟踪器中的任务#

您:查看 Jira 中的 PROJ-123 任务并实现
    其中描述的内容。

Claude:[通过 MCP 读取任务,理解需求,
        编写代码,创建提交]

错误分析#

您:检查 Sentry 中的最近错误并修复
    最常见的那个。

Claude:[查看 Sentry,找到错误,
        在代码中修复]

数据库操作#

您:在 PostgreSQL 数据库中找到昨天
    注册的10个用户。

Claude:[通过 MCP 连接数据库,
        执行查询,显示结果]

MCP 配置存储位置#

层级 文件 适用对象
个人 ~/.claude.json 所有项目
项目 项目文件夹中的 .mcp.json 整个团队

安全#

  • ⚠️ 不要分享令牌和访问密钥
  • ⚠️ 项目级 MCP 服务器仅用于整个团队需要的服务
  • ⚠️ 个人密钥存储在个人配置中(~/.claude.json
  • ✅ Claude Code 在使用 MCP 工具前会征求许可

建议#

  • ✅ 从一个服务器开始,确认它正常工作后再连接下一个
  • ✅ 使用 /mcp 检查服务器状态
  • ✅ 团队协作时将服务器添加到项目的 .mcp.json
  • ✅ 远程(HTTP)服务器比本地服务器更容易配置

课程总结#

  • MCP 是将 Claude Code 连接到外部服务(Jira、Slack、数据库等)的标准
  • 服务器通过 claude mcp add 命令连接
  • 有三种类型:HTTP(推荐)、SSE 和本地(stdio)
  • 管理:claude mcp listclaude mcp getclaude mcp remove
  • 在 Claude Code 内部检查状态:/mcp
  • MCP 将 Claude Code 的能力扩展到文件操作之外