MCP(外部服务连接器):让 Claude 接 Slack / GitHub / 数据库

📍 Claude Code 进阶 3/6 · 上一篇:← Hooks(钩子)

那个让洁柔受不了的复制粘贴时刻

5 月某天,洁柔正在改 niuxue.org 的某一篇文章。

她跟我说「等下,我看一下 GitHub 上那个 issue 的描述,顺便看看 Slack 里同事是怎么说的」——她切到浏览器,手动打开 GitHub、复制 issue 描述、回来贴给我;然后切到 Slack 找那条消息、复制、再贴。

3 次切窗口 + 3 次复制粘贴下来,她有点烦:

“为什么我每次都要当人形复制粘贴机?Claude Code 自己不能直接读 GitHub 跟 Slack 吗?”

我说:“能,这叫 MCP——给 Claude 装一个『外部服务连接器』,它直接通过 API 读 Slack / GitHub / 数据库 / Drive,你完全不用复制粘贴**。”**

她半信半疑配了一下,5 分钟后她说:

“这才是 AI 该有的样子嘛。”

这一篇讲的就是 MCP——Claude Code 跟外部服务之间的”通用接口”。

MCP 是什么:AI 工具圈的”USB-C”

MCP 全称 Model Context Protocol(模型上下文协议) —— 是 Anthropic 跟一群伙伴一起搞的开源标准,用来连接 AI 跟各种外部工具。

类比:

• 以前每个手机充电口都不一样(Lightning / Micro USB / Type-C / 各种乱七八糟),换设备就要换线
• 后来大家统一了 USB-C,一根线全设备通用

MCP 就是 AI 工具圈的 USB-C —— 一个统一标准,Claude Code / Cursor / ChatGPT / 任何支持 MCP 的 AI 都能用同一个 MCP 服务器。

给 Claude Code 装一个 MCP 服务器,效果:

• ✅ Claude 直接读 GitHub issue / PR 内容
• ✅ Claude 查 Slack 群里有谁说过什么
• ✅ Claude 直接 SELECT 你的 PostgreSQL 数据库
• ✅ Claude 读 Figma 设计 / 调 Notion 文档 / 拉 Sentry 错误日志
• ✅ 你完全不用复制粘贴

4 个真实场景(看完你就想装)

🎯 场景 1:实现 JIRA 票子 + 自动提 PR

“把 JIRA 票号 ENG-4521 描述的功能实现,然后在 GitHub 上提一个 PR。”

Claude 自己:

1. 通过 JIRA MCP 读 ENG-4521 的需求描述
2. 在你本地仓库改对应代码
3. 通过 GitHub MCP 创建 PR,自动写描述

你做的事:打一句话,然后审 PR。

📊 场景 2:分析监控数据

“查一下 Sentry 跟 Statsig,看用户对 ENG-4521 这个功能用的怎么样。”

Claude 自己:

1. Sentry MCP 拉错误日志
2. Statsig MCP 拉 A/B 测试数据
3. 汇总给你一个判断”功能稳不稳 / 用户接受度高不高”

🗄️ 场景 3:查公司数据库

“找 10 个最近用过 ENG-4521 功能的用户邮箱,从我们的 PostgreSQL 里。”

Claude 直接:

1. PostgreSQL MCP 跑一个 SELECT 查询
2. 返回 10 个邮箱给你

你不用打开 DBeaver / 不用写 SQL——直接说人话。

📧 场景 4:Slack + Gmail 联动

“把上面那 10 个用户拉一个反馈访谈,用 Gmail 给他们发邀请邮件。”

Claude:

1. 直接调 Gmail MCP 生成邮件草稿
2. 你确认后一键发出

这就是 AI 真正”替你干活”的样子——不是聊一聊,是真的把跨工具的工作流串起来。

怎么装一个 MCP 服务器

装 MCP 服务器有 3 种传输方式(transport),对应不同的服务器类型。

🌐 方式 1:HTTP 远程服务器(最常用)

云端服务一般都走 HTTP。比如装 Notion 的 MCP:

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

带 Bearer Token 鉴权:

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer 你的-token"

💻 方式 2:本地 stdio 服务器(直跑本地脚本)

如果服务器是个本地脚本 / 命令行工具,用 stdio:

claude mcp add --transport stdio --env AIRTABLE_API_KEY=你的-key airtable \
  -- npx -y airtable-mcp-server

说明:

• --env 传环境变量给服务器
• -- 双横线之后是要跑的命令 + 参数

📡 方式 3:SSE 远程服务器(已淘汰,但还有人用)

Server-Sent Events 是早期的远程 MCP 协议,官方建议不要用(已 deprecated),改用 HTTP。但有些老服务器还是 SSE:

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

装完之后管理服务器

claude mcp list                # 列出所有装的服务器
claude mcp get github          # 看 github 服务器的详细配置
claude mcp remove github       # 删掉 github 服务器

在 Claude Code 里看实时状态:

/mcp

会弹一个面板,显示每个服务器的连接状态、提供了多少工具、有没有需要登录(OAuth)。

3 种安装范围(scope)

装的时候可以选这个 MCP 服务器对哪些项目生效——--scope 参数:

Scope	范围	存哪
local(默认)	只这个项目,只你自己	~/.claude.json
project	这个项目,团队共享	项目根/.mcp.json
user	你所有项目都生效	~/.claude.json

怎么选:

• 装一个 GitHub MCP,所有项目都要用 → user scope
• 装一个 公司内部数据库 MCP,只这个项目用且团队共用 → project scope(.mcp.json 推到 git 里,队友拉代码就有)
• 装一个 个人 token 的服务器,不想推给团队 → local scope

例子:

# 装 GitHub MCP,所有项目都能用
claude mcp add --transport http --scope user github https://mcp.github.com/mcp

安全:装之前看 3 件事

MCP 服务器能调你账号下的 API(读 GitHub / 改 Notion / SELECT 数据库)——装错一个就可能泄露数据。装之前必看 3 件事:

✅ 1. 看是不是官方源 / Anthropic 目录验证过

Anthropic Connector 目录 里收录的 MCP 服务器都经过审核——优先用目录里有的。

✅ 2. 看权限范围

很多 MCP 服务器要 OAuth 授权——看清楚它要哪些权限:

• “Read GitHub repos” → 合理,装
• “Read & write all your GitHub repos including private” → 看清楚再装
• “Read your entire Gmail inbox” → 重要场景慎装

✅ 3. 看是不是开源 + 有人在维护

第三方 MCP 服务器优先选:

• ✅ GitHub 仓库开源
• ✅ 最近 3 个月有更新
• ✅ 装机量 1000+ / star 100+

新作者 + 闭源 + 少人用 + 要敏感权限 —— 直接拒绝。

几个值得装的 MCP 服务器(2026-05 主流)

服务器	装什么	用途
GitHub	claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_PAT"	读 / 改 GitHub issue / PR / repo
Notion	claude mcp add --transport http notion https://mcp.notion.com/mcp	读 / 改 Notion 页面
Filesystem	claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Documents	给 Claude 访问指定目录的能力(超过默认范围)
Postgres	claude mcp add --transport stdio --env DATABASE_URL=$DB_URL postgres -- npx -y @modelcontextprotocol/server-postgres	跑 SQL 查询
Slack	(官方目录里搜 Slack,走 OAuth 流程)	读 / 发消息
Figma	(官方目录里搜 Figma)	读设计文件
Sentry	(官方目录里搜 Sentry)	读错误日志

全清单:claude.ai/directory 浏览。

3 个新手最容易踩的坑

❌ 坑 1:装一堆 MCP 但用不上

新手第一周容易一口气装 10 个 MCP 服务器——结果 Claude 启动慢、tool 列表爆炸、context 被吃掉。

修正:先装 2-3 个你真的每天用的(GitHub / Filesystem / 一个数据库)。其他用到再装。

❌ 坑 2:OAuth 没走完留下”半装”状态

很多远程 MCP 要 OAuth 授权——你点了 claude mcp add 但没在浏览器里点”同意”,服务器状态会一直是 “pending”。

修正:装完立刻在 Claude Code 里 /mcp 看状态,绿色 ✅ 才算装好。红色 / 黄色 → 点进去看是不是需要重新 OAuth。

❌ 坑 3:Hook 工具输出太大撑爆 context

MCP 工具的返回值默认上限 10,000 tokens——超过 Claude Code 会截断 + 警告。如果你查的内容大(比如大表查询),返回会被砍。

修正:用 MAX_MCP_OUTPUT_TOKENS=50000 claude 启动时把上限调高。或者在 prompt 里限定返回大小(“只返回前 10 行”)。

MCP 跟 Plugin 跟 Hook 的区别

新手常搞混,一表对齐:

	Hook	MCP	Plugin
本质	在生命周期挂一个 shell 命令	给 Claude 加一组新工具	打包好的功能集合(可含 Skill + Tool + Hook + MCP)
典型用法	自动 format / 自动 git add / 桌面通知	让 Claude 直接调 GitHub / Slack API	装一套现成的代码 review 工作流
配置	settings.json hooks 段	claude mcp add 或 settings.json mcpServers	/plugin install <名字>
跨工具用	❌ 仅 Claude Code	✅ 任何支持 MCP 的 AI(Claude / Cursor / ChatGPT)	❌ 仅 Claude Code

记住一句话:

• MCP = 给 Claude 加”新感官”(让它能看 GitHub / 听 Slack)
• Hook = 给 Claude 加”反射动作”(它一改文件你的脚本就跑)
• Plugin = 别人打好的”套餐”

下一步

读完这一篇你应该会:

• 用 USB-C 类比理解 MCP 是什么
• 用 claude mcp add 装第一个 MCP 服务器
• 知道 4 个真实场景 + 3 种 transport + 3 种 scope
• 安全把关 装之前看 3 件事

接下来 03 区还有:

→ 自定义 Slash Command:把团队规范变成 /xxx(即将上线)

→ Subagents(子智能体):多个 Claude 并行干不同活(即将上线)

→ Git Worktree:多个 Claude 改同一个 repo 不打架(即将上线)

想第一时间收到,可以收藏 niuxue.org 主页。

---

你装的最好用的 MCP 服务器是什么?发邮箱 [email protected],精选会进社区 MCP 推荐清单。