教程

Claude Code MCP 配置完全指南:5 分钟连接 GitHub、Notion、数据库等 100+ 外部服务

Claude Code MCP 完全配置指南:5 分钟连接 GitHub、Notion、Stripe 等外部服务。含 3 种添加方法、常用服务命令速查、传输协议选择和连接失败排查。

2026/4/93分钟 阅读ClaudeEagle

Claude Code 默认只能操作本地代码文件。但如果你想让它直接操作 GitHub、查询数据库、读 Notion 笔记怎么办?答案是 MCP(Model Context Protocol)


MCP 能做什么?

连上 MCP 之后:

text
从 JIRA ENG-4521 拉需求,实现功能并创建 PR
查 Sentry 最近 24 小时的错误,帮我定位原因
从 PostgreSQL 找 10 个用了新功能的用户邮箱
根据 Figma 最新设计稿更新邮件模板

以前需要手动切多个工具的事,现在一句话搞定。


添加 MCP 服务器(3 种方法)

方法 1:命令行直接加(最简单)

bash
# HTTP 传输(大多数服务用这种)
claude mcp add --transport http <名称> <URL>

# 示例
claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add --transport http stripe https://mcp.stripe.com
claude mcp add --transport http supabase https://mcp.supabase.com/mcp
claude mcp add --transport http vercel https://mcp.vercel.com
claude mcp add --transport http figma https://mcp.figma.com/mcp

方法 2:在会话中用 /mcp 命令

text
/mcp

图形化界面管理所有 MCP 服务器。

方法 3:编辑配置文件

json
// ~/.claude.json(全局)或 .claude/settings.json(项目级)
{
  "mcpServers": {
    "notion": {
      "transport": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

常用服务速查

服务命令
Notionclaude mcp add --transport http notion https://mcp.notion.com/mcp
Linearclaude mcp add --transport http linear https://mcp.linear.app/mcp
Vercelclaude mcp add --transport http vercel https://mcp.vercel.com
Figmaclaude mcp add --transport http figma https://mcp.figma.com/mcp
Stripeclaude mcp add --transport http stripe https://mcp.stripe.com
Supabaseclaude mcp add --transport http supabase https://mcp.supabase.com/mcp
Jira/Confluenceclaude mcp add --transport http atlassian https://mcp.atlassian.com/v1/mcp
Ahrefsclaude mcp add --transport http ahrefs https://api.ahrefs.com/mcp/mcp

三种传输协议

协议适用示例
http云服务(最常用)Notion、Stripe
streamable-http需要流式输出Asana
stdio本地工具SQLite、文件系统

本地 SQLite 示例:

bash
claude mcp add sqlite --command "npx -y @modelcontextprotocol/server-sqlite /path/to/db.sqlite"

作用域控制

bash
# 只对当前项目生效
claude mcp add --scope project ...

# 全局(默认)
claude mcp add --scope user ...

常见问题

MCP 连接失败

bash
claude mcp list          # 查看当前状态
claude mcp remove <name> # 删除
claude mcp add ...       # 重新添加

需要认证的服务

首次使用跳出浏览器认证,完成后 token 自动保存。手动传 token:

bash
claude mcp add --transport http myservice https://api.example.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

工具不出现

text
/mcp
# 选对应服务器 → Enable

来源:Claude Code MCP 官方文档 | 整理:ClaudeEagle

相关文章推荐

教程Claude Code MCP 集成指南:连接 Jira、GitHub、Slack 等外部工具Claude Code MCP 集成完整指南:MCP 协议原理、快速配置 GitHub/Postgres/Slack 等现成 Server、TypeScript 开发自定义 MCP Server 示例、三个实战场景(Bug 处理/站会准备/数据优化)、安全配置建议。2026/3/12教程Claude Code MCP 完全指南:三种安装方式、三级作用域、OAuth 认证与企业管控策略Claude Code MCP 完全指南:三种安装方式(远程 HTTP 推荐/SSE 废弃/本地 Stdio)、三级作用域(local/project/user)及优先级规则、Sentry+GitHub+PostgreSQL 实战示例、OAuth 2.0 认证(/mcp 命令/固定端口/预配置凭证)、/mcp__server__prompt 命令格式、资源引用语法,以及企业管控(managed-mcp.json 白名单黑名单策略)。2026/3/5教程Claude Code MCP 完整接入指南:HTTP、SSE、stdio、OAuth 和 ChannelsClaude Code MCP 官方文档中文整理:MCP 能做什么、何时该接入、HTTP/SSE/stdio 三种安装方式、claude mcp add 命令、.mcp.json 配置、/mcp 面板、OAuth 认证、动态工具更新、自动重连、Channels 推送消息、插件内置 MCP 服务器,以及安全风险与最佳实践。2026/5/15教程Claude Code MCP 服务器完整配置指南:10 个最实用的 MCP 集成Claude Code MCP 服务器完整配置指南:MCP 协议三种能力(Tools/Resources/Prompts);全局和项目级配置方式;10 个最实用 MCP 集成详解(PostgreSQL 查询数据库/GitHub PR 管理/Slack 通知/Brave 实时搜索/Memory 跨会话知识/Jira 任务管理/Redis/AWS/自定义 HTTP API);v2.1.91 工具结果大小配置;v2.1.114 Hooks 直接调用 MCP 工具;以及安全最佳实践。2026/5/3教程Hermes Agent MCP 集成完全指南:GitHub、数据库、内部 API 连接实战Hermes Agent MCP 集成完整教程:常用 MCP Server 安装配置(GitHub/PostgreSQL/Slack),v0.8.0 新增 OAuth 2.1 PKCE 安全认证和 OSV 漏洞扫描,GitHub 完整操作和数据库查询实战示例,以及自己开发 MCP Server 的快速入门。2026/4/16教程Claude Code MCP 集成完全指南:连接外部工具、配置服务器与调试技巧Claude Code MCP 完整集成指南:stdio 和 HTTP 两种服务器类型配置、常用 MCP 服务器推荐(GitHub/PostgreSQL/Slack/Linear)、在 Subagent 中限制 MCP 访问、Hook 中使用 MCP 工具名匹配、成本优化策略,以及自定义 MCP 服务器开发示例。2026/2/28