为什么需要这个#
想象 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/mcp2. 远程 SSE 服务器#
类似于 HTTP,但使用不同的数据传输技术:
claude mcp add --transport sse asana https://mcp.asana.com/sse3. 本地服务器(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 list、claude mcp get、claude mcp remove - 在 Claude Code 内部检查状态:
/mcp - MCP 将 Claude Code 的能力扩展到文件操作之外