教程

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 集成完全指南:连接外部工具、配置服务器与调试技巧Claude Code MCP 完整集成指南:stdio 和 HTTP 两种服务器类型配置、常用 MCP 服务器推荐(GitHub/PostgreSQL/Slack/Linear)、在 Subagent 中限制 MCP 访问、Hook 中使用 MCP 工具名匹配、成本优化策略,以及自定义 MCP 服务器开发示例。2026/2/28教程Claude Code MCP 集成指南:通过 Model Context Protocol 连接外部工具Claude Code 通过 MCP(Model Context Protocol)连接数据库、GitHub、Slack 等外部工具。本文介绍三种传输类型(stdio/HTTP/SSE)的配置方法、Anthropic 官方 MCP 服务器(文件系统、GitHub、PostgreSQL、Brave Search、Puppeteer)的安装命令、自定义 TypeScript MCP 服务器开发,以及 MCP 安全最佳实践。2026/2/27教程Claude Code 报错解决手册:安装失败、登录异常、context too long 等常见问题全覆盖Claude Code 报错一站式解决手册:全面覆盖安装失败、command not found、登录 403、context too long、MCP 连接失败,每个问题附完整解决步骤。2026/4/9教程Claude Code 自动代码审查:多 Agent 分析 PR,捕捉逻辑错误和安全漏洞Claude Code 自动代码审查功能详解:多 Agent 并行分析 GitHub PR,自动发现逻辑错误、安全漏洞和回归 Bug。含配置步骤、自定义审查和 CI 集成。2026/4/7