Claude Code 接入 MCP 实战：20+个真正实用MCP手把手教你配置！

第三章. MCP 服务器接入

本章摘要：Claude Code 很强，但它默认只能访问本地文件和执行命令。如果你想让它查询数据库、调用 GitHub API、读取 Notion 文档呢？MCP（Model Context Protocol）就是打开这扇门的钥匙。本章将教你如何接入 MCP 服务器，让 Claude 连接外部世界。

本章学习路径

阶段内容解锁能力
第一阶段MCP 是什么理解协议原理和应用场景
第二阶段三种接入方式掌握 HTTP、SSE、stdio 三种连接方式
第三阶段实战接入 GitHub完成一个完整的 MCP 接入流程

3.1. MCP 是什么

上一章我们学会了配置 Claude Code 的行为。但有个根本性的限制没有突破：Claude 只能访问本地资源。

“我想让 Claude 帮我查一下 GitHub 上的 Issue 列表。”

默认情况下，Claude 做不到。它没有 GitHub 的访问权限，也不知道如何调用 GitHub API。

MCP 就是为了解决这个问题而生的。

3.1.1. 协议原理简述

Model Context Protocol模型上下文协议，一种让 AI 连接外部工具的开放标准 是 Anthropic 推出的开放协议，用于标准化 AI 与外部工具的连接方式。

核心思想：

把 “AI 如何调用外部工具” 这件事标准化。就像 USB 协议让各种设备都能插到电脑上一样，MCP 让各种工具都能 “插到” Claude 上。

架构示意：

1
2
3
4
5
6
7
8
9
10
11
┌─────────────┐     MCP 协议     ┌─────────────┐
│ Claude Code │ ◄──────────────► │ MCP Server  │
└─────────────┘                  └─────────────┘
                                       │
                                       ▼
                                 ┌─────────────┐
                                 │ 外部服务     │
                                 │ (GitHub,    │
                                 │  Database,  │
                                 │  Notion...) │
                                 └─────────────┘

Claude Code 通过 MCP 协议与 MCP Server 通信，MCP Server 再去调用实际的外部服务。

3.1.2. 能解决什么问题

接入 MCP 后，你可以让 Claude 做这些事：

场景示例指令
查询 Issue“帮我看看 GitHub 上这个仓库有哪些未解决的 Issue”
操作数据库“查询一下最近 7 天的订单数据”
读取文档“把 Notion 里的产品需求文档总结一下”
监控告警“Sentry 上最近有什么新的报错？”

常见的 MCP 服务器：

服务功能
GitHub管理 Issue、PR、代码搜索
PostgreSQL数据库查询
Notion文档读写
Sentry错误监控
Slack消息发送

3.1.3. 本节小结

MCP 的核心价值是 扩展 Claude 的能力边界：

维度无 MCP有 MCP
数据来源仅本地文件本地 + 外部服务
操作范围读写文件、执行命令+ 调用 API、查询数据库
自动化程度有限大幅提升

3.2. 三种接入方式

MCP 服务器有三种连接方式，适用于不同的场景。

3.2.1. HTTP 远程服务器（推荐）

这是最常用的方式，适合连接云端的 MCP 服务。

语法：

1
claude mcp add --transport http <名称> <URL>

示例：连接 Notion

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

带认证的示例：

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

适用场景：

  • 官方提供的云端 MCP 服务（如 Notion、Sentry）
  • 需要 OAuth 认证的服务

3.2.2. SSE 服务器

Server-Sent Events服务器推送事件，一种单向实时通信协议 是另一种远程连接方式，适合需要实时推送的场景。

语法：

1
claude mcp add --transport sse <名称> <URL>

示例：连接 Asana

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

适用场景：

  • 需要实时数据推送的服务
  • 某些特定的第三方 MCP 服务

3.2.3. stdio 本地服务器

这种方式是在本地运行一个 MCP 服务器进程，通过标准输入输出（stdin/stdout）与 Claude Code 通信。

语法：

1
claude mcp add --transport stdio <名称> -- <命令> [参数...]

示例：连接本地数据库

1
2
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://user:pass@localhost:5432/mydb"

示例：连接 Airtable

1
2
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

适用场景：

  • 本地数据库连接
  • 自定义的 MCP 服务器
  • 需要访问本地资源的服务

3.2.4. 本节小结

三种接入方式的选择：

方式命令适用场景
HTTP--transport http云端服务、OAuth 认证
SSE--transport sse实时推送
stdio--transport stdio本地服务、自定义服务器

3.3. MCP 作用域管理

和 settings.json 一样，MCP 服务器配置也有作用域的概念。

3.3.1. local / project / user 三种作用域

作用域存储位置作用范围是否共享
local~/.claude.json（项目路径下）当前项目，仅自己否
project.mcp.json当前项目，所有人是
user~/.claude.json所有项目，仅自己否

指定作用域：

1
2
3
4
5
6
7
8
# 默认是 local
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# 指定为 project（团队共享）
claude mcp add --transport http github --scope project https://api.githubcopilot.com/mcp/

# 指定为 user（跨项目）
claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/

3.3.2. .mcp.json 项目级配置

当你使用 --scope project 添加 MCP 服务器时，配置会写入项目根目录的 .mcp.json 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "postgresql://..."],
      "env": {}
    }
  }
}

这个文件可以提交到 Git，团队成员克隆项目后就能使用相同的 MCP 配置。

3.3.3. 环境变量展开

.mcp.json 支持环境变量展开，这样你就不用把敏感信息硬编码在配置文件里：

1
2
3
4
5
6
7
8
9
10
11
{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

语法说明：

  • ${VAR} —— 展开为环境变量 VAR 的值
  • ${VAR:-default} —— 如果 VAR 未设置，使用 default

3.3.4. 本节小结

MCP 作用域的选择：

需求推荐作用域原因
个人使用的服务user跨项目生效
团队共享的服务project提交到 Git
临时测试local不影响他人

3.4. 实战：接入 GitHub MCP

理论讲完了，现在来实战。我们以 GitHub MCP 为例，完成一个完整的接入流程。

3.4.1. 添加服务器

步骤 1：执行添加命令

1
claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/

成功现象：终端显示 MCP server 'github' added successfully。

步骤 2：验证添加结果

1
claude mcp list

你应该能看到 github 出现在列表中。

3.4.2. OAuth 认证

GitHub MCP 需要 OAuth 认证才能访问你的仓库。

步骤 1：进入 Claude Code

1
claude

步骤 2：触发认证流程

1
› /mcp

在弹出的菜单中，选择 github，然后选择 Authenticate。

步骤 3：完成浏览器授权

浏览器会自动打开 GitHub 授权页面。点击 “Authorize” 授权 Claude Code 访问你的 GitHub 账户。

成功现象：浏览器显示 “Authorization successful”，终端显示认证完成。

3.4.3. 使用示例

认证完成后，你就可以让 Claude 操作 GitHub 了：

查看 PR 列表：

1
› 帮我看看这个仓库有哪些待审核的 PR

创建 Issue：

1
› 在 GitHub 上创建一个 Issue，标题是"修复登录页面的样式问题"，内容描述一下 CSS 布局错位的情况

审查代码：

1
› 帮我审查一下 PR #789 的代码变更，重点关注安全问题

查看仓库信息：

1
› 这个仓库最近一周有哪些提交？

3.4.4. 本节小结

GitHub MCP 接入流程：

步骤命令/操作成功现象
添加服务器claude mcp add --transport http github <URL>提示添加成功
认证/mcp → 选择 github → Authenticate浏览器显示授权成功
使用直接用自然语言描述需求Claude 调用 GitHub API 返回结果

3.5. 参考配置

我们刚才在不同章节里讲解了 MCP 的原理、接入方式、作用域管理和 GitHub 实战。至于那些 “复制粘贴就能用” 的服务器配置、模块划分和 20+ 个推荐的 MCP 服务，都搬到了
👉 点击查看：20+ 实用 MCP 服务器配置大全

Claude Code 与Codex、Gemini 的配置样例都能在里面找到。阅读 Toolkit 页面的条目，复制 JSON/claude
命令即可完成部署。需要了解更多拓展内容，可以继续参考本章前面的讲解。