跳转到主要内容
Claude Code 可以通过 Model Context Protocol (MCP)(一个用于 AI 工具集成的开源标准)连接到数百个外部工具和数据源。MCP 服务器为 Claude Code 提供对您的工具、数据库和 API 的访问权限。

使用 MCP 可以做什么

连接 MCP 服务器后,您可以要求 Claude Code:
  • 从问题跟踪器实现功能:“添加 JIRA 问题 ENG-4521 中描述的功能,并在 GitHub 上创建 PR。”
  • 分析监控数据:“检查 Sentry 和 Statsig 以检查 ENG-4521 中描述的功能的使用情况。”
  • 查询数据库:“根据我们的 Postgres 数据库,查找使用功能 ENG-4521 的 10 个随机用户的电子邮件。”
  • 集成设计:“根据在 Slack 中发布的新 Figma 设计更新我们的标准电子邮件模板”
  • 自动化工作流:“创建 Gmail 草稿,邀请这 10 个用户参加关于新功能的反馈会议。“

热门 MCP 服务器

以下是一些您可以连接到 Claude Code 的常用 MCP 服务器:
使用第三方 MCP 服务器需自担风险 - Anthropic 尚未验证所有这些服务器的正确性或安全性。 确保您信任要安装的 MCP 服务器。 使用可能获取不受信任内容的 MCP 服务器时要特别小心,因为这些可能会使您面临提示注入风险。
需要特定的集成? 在 GitHub 上查找数百个 MCP 服务器,或使用 MCP SDK 构建您自己的服务器。

安装 MCP 服务器

MCP 服务器可以根据您的需求以三种不同的方式进行配置:

选项 1:添加远程 HTTP 服务器

HTTP 服务器是连接到远程 MCP 服务器的推荐选项。这是云服务最广泛支持的传输方式。
# 基本语法
claude mcp add --transport http <name> <url>

# 真实示例:连接到 Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 带有 Bearer 令牌的示例
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

选项 2:添加远程 SSE 服务器

SSE(Server-Sent Events)传输已弃用。请在可用的地方使用 HTTP 服务器。
# 基本语法
claude mcp add --transport sse <name> <url>

# 真实示例:连接到 Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

# 带有身份验证标头的示例
claude mcp add --transport sse private-api https://api.company.com/sse \
  --header "X-API-Key: your-key-here"

选项 3:添加本地 stdio 服务器

Stdio 服务器作为本地进程在您的计算机上运行。它们非常适合需要直接系统访问或自定义脚本的工具。
# 基本语法
claude mcp add --transport stdio <name> <command> [args...]

# 真实示例:添加 Airtable 服务器
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server
理解 ”—” 参数: --(双破折号)将 Claude 自己的 CLI 标志与传递给 MCP 服务器的命令和参数分开。-- 之前的所有内容都是 Claude 的选项(如 --env--scope),-- 之后的所有内容都是运行 MCP 服务器的实际命令。例如:
  • claude mcp add --transport stdio myserver -- npx server → 运行 npx server
  • claude mcp add --transport stdio myserver --env KEY=value -- python server.py --port 8080 → 运行 python server.py --port 8080,环境中设置 KEY=value
这可以防止 Claude 的标志与服务器标志之间的冲突。

管理您的服务器

配置后,您可以使用以下命令管理 MCP 服务器:
# 列出所有已配置的服务器
claude mcp list

# 获取特定服务器的详细信息
claude mcp get github

# 删除服务器
claude mcp remove github

# (在 Claude Code 中)检查服务器状态
/mcp
提示:
  • 使用 --scope 标志指定配置的存储位置:
    • local(默认):仅在当前项目中对您可用(在较旧版本中称为 project
    • project:通过 .mcp.json 文件与项目中的所有人共享
    • user:在所有项目中对您可用(在较旧版本中称为 global
  • 使用 --env 标志设置环境变量(例如 --env KEY=value
  • 使用 MCP_TIMEOUT 环境变量配置 MCP 服务器启动超时(例如 MCP_TIMEOUT=10000 claude 设置 10 秒超时)
  • 当 MCP 工具输出超过 10,000 个令牌时,Claude Code 将显示警告。要增加此限制,请设置 MAX_MCP_OUTPUT_TOKENS 环境变量(例如 MAX_MCP_OUTPUT_TOKENS=50000
  • 使用 /mcp 对需要 OAuth 2.0 身份验证的远程服务器进行身份验证
Windows 用户:在本机 Windows(不是 WSL)上,使用 npx 的本地 MCP 服务器需要 cmd /c 包装器以确保正确执行。
# 这创建了 Windows 可以执行的 command="cmd"
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package
没有 cmd /c 包装器,您会遇到”连接已关闭”错误,因为 Windows 无法直接执行 npx。(有关 -- 参数的说明,请参阅上面的注释。)

插件提供的 MCP 服务器

插件可以捆绑 MCP 服务器,在启用插件时自动提供工具和集成。插件 MCP 服务器的工作方式与用户配置的服务器相同。 插件 MCP 服务器的工作原理
  • 插件在插件根目录的 .mcp.json 中或在 plugin.json 中内联定义 MCP 服务器
  • 启用插件时,其 MCP 服务器会自动启动
  • 插件 MCP 工具与手动配置的 MCP 工具一起出现
  • 插件服务器通过插件安装进行管理(不是 /mcp 命令)
示例插件 MCP 配置 在插件根目录的 .mcp.json 中:
{
  "database-tools": {
    "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
    "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
    "env": {
      "DB_URL": "${DB_URL}"
    }
  }
}
或在 plugin.json 中内联:
{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}
插件 MCP 功能
  • 自动生命周期:服务器在插件启用时启动,但您必须重新启动 Claude Code 以应用 MCP 服务器更改(启用或禁用)
  • 环境变量:使用 ${CLAUDE_PLUGIN_ROOT} 表示插件相对路径
  • 用户环境访问:访问与手动配置的服务器相同的环境变量
  • 多种传输类型:支持 stdio、SSE 和 HTTP 传输(传输支持可能因服务器而异)
查看插件 MCP 服务器
# 在 Claude Code 中,查看所有 MCP 服务器,包括插件服务器
/mcp
插件服务器在列表中出现,并带有指示它们来自插件的指示符。 插件 MCP 服务器的优势
  • 捆绑分发:工具和服务器打包在一起
  • 自动设置:无需手动 MCP 配置
  • 团队一致性:安装插件时,每个人都获得相同的工具
有关使用插件捆绑 MCP 服务器的详细信息,请参阅插件组件参考

MCP 安装范围

MCP 服务器可以在三个不同的范围级别进行配置,每个级别都用于管理服务器可访问性和共享的不同目的。了解这些范围可以帮助您确定为特定需求配置服务器的最佳方式。

本地范围

本地范围的服务器代表默认配置级别,存储在您的项目特定用户设置中。这些服务器对您保持私密,仅在当前项目目录中工作时可访问。此范围非常适合个人开发服务器、实验配置或包含不应共享的敏感凭证的服务器。
# 添加本地范围的服务器(默认)
claude mcp add --transport http stripe https://mcp.stripe.com

# 显式指定本地范围
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

项目范围

项目范围的服务器通过在项目根目录中存储配置到 .mcp.json 文件来启用团队协作。此文件设计为检入版本控制,确保所有团队成员都可以访问相同的 MCP 工具和服务。添加项目范围的服务器时,Claude Code 会自动创建或更新此文件,使用适当的配置结构。
# 添加项目范围的服务器
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp
生成的 .mcp.json 文件遵循标准化格式:
{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}
出于安全原因,Claude Code 在使用来自 .mcp.json 文件的项目范围服务器之前会提示批准。如果您需要重置这些批准选择,请使用 claude mcp reset-project-choices 命令。

用户范围

用户范围的服务器提供跨项目可访问性,使其在您计算机上的所有项目中可用,同时对您的用户帐户保持私密。此范围适用于个人实用程序服务器、开发工具或您在不同项目中经常使用的服务。
# 添加用户服务器
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

选择正确的范围

根据以下条件选择您的范围:
  • 本地范围:个人服务器、实验配置或特定于一个项目的敏感凭证
  • 项目范围:团队共享服务器、项目特定工具或协作所需的服务
  • 用户范围:跨多个项目需要的个人实用程序、开发工具或经常使用的服务

范围层次结构和优先级

MCP 服务器配置遵循明确的优先级层次结构。当具有相同名称的服务器存在于多个范围时,系统通过首先优先考虑本地范围的服务器、其次是项目范围的服务器,最后是用户范围的服务器来解决冲突。此设计确保个人配置可以在需要时覆盖共享配置。

.mcp.json 中的环境变量扩展

Claude Code 支持 .mcp.json 文件中的环境变量扩展,允许团队共享配置,同时保持对计算机特定路径和 API 密钥等敏感值的灵活性。 支持的语法:
  • ${VAR} - 扩展为环境变量 VAR 的值
  • ${VAR:-default} - 如果设置了 VAR,则扩展为 VAR,否则使用 default
扩展位置: 环境变量可以在以下位置扩展:
  • command - 服务器可执行文件路径
  • args - 命令行参数
  • env - 传递给服务器的环境变量
  • url - 对于 HTTP 服务器类型
  • headers - 对于 HTTP 服务器身份验证
带有变量扩展的示例:
{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}
如果未设置必需的环境变量且没有默认值,Claude Code 将无法解析配置。

实际示例

示例:使用 Sentry 监控错误

# 1. 添加 Sentry MCP 服务器
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 2. 使用 /mcp 对您的 Sentry 帐户进行身份验证
> /mcp

# 3. 调试生产问题
> "过去 24 小时内最常见的错误是什么?"
> "显示错误 ID abc123 的堆栈跟踪"
> "哪个部署引入了这些新错误?"

示例:连接到 GitHub 进行代码审查

# 1. 添加 GitHub MCP 服务器
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# 2. 在 Claude Code 中,如果需要进行身份验证
> /mcp
# 为 GitHub 选择"身份验证"

# 3. 现在您可以要求 Claude 使用 GitHub
> "审查 PR #456 并建议改进"
> "为我们刚发现的错误创建新问题"
> "显示分配给我的所有打开的 PR"

示例:查询您的 PostgreSQL 数据库

# 1. 使用您的连接字符串添加数据库服务器
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:[email protected]:5432/analytics"

# 2. 自然地查询您的数据库
> "本月我们的总收入是多少?"
> "显示订单表的架构"
> "查找 90 天内未进行购买的客户"

使用远程 MCP 服务器进行身份验证

许多基于云的 MCP 服务器需要身份验证。Claude Code 支持 OAuth 2.0 以实现安全连接。
1

添加需要身份验证的服务器

例如:
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
2

在 Claude Code 中使用 /mcp 命令

在 Claude Code 中,使用命令:
> /mcp
然后按照浏览器中的步骤登录。
提示:
  • 身份验证令牌存储安全且自动刷新
  • /mcp 菜单中使用”清除身份验证”撤销访问权限
  • 如果浏览器不会自动打开,请复制提供的 URL
  • OAuth 身份验证适用于 HTTP 服务器

从 JSON 配置添加 MCP 服务器

如果您有 MCP 服务器的 JSON 配置,可以直接添加它:
1

从 JSON 添加 MCP 服务器

# 基本语法
claude mcp add-json <name> '<json>'

# 示例:添加带有 JSON 配置的 HTTP 服务器
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# 示例:添加带有 JSON 配置的 stdio 服务器
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'
2

验证服务器已添加

claude mcp get weather-api
提示:
  • 确保 JSON 在您的 shell 中正确转义
  • JSON 必须符合 MCP 服务器配置架构
  • 您可以使用 --scope user 将服务器添加到您的用户配置,而不是项目特定的配置

从 Claude Desktop 导入 MCP 服务器

如果您已在 Claude Desktop 中配置了 MCP 服务器,可以导入它们:
1

从 Claude Desktop 导入服务器

# 基本语法 
claude mcp add-from-claude-desktop 
2

选择要导入的服务器

运行命令后,您将看到一个交互式对话框,允许您选择要导入的服务器。
3

验证服务器已导入

claude mcp list 
提示:
  • 此功能仅适用于 macOS 和 Windows Subsystem for Linux (WSL)
  • 它从这些平台上的标准位置读取 Claude Desktop 配置文件
  • 使用 --scope user 标志将服务器添加到您的用户配置
  • 导入的服务器将具有与 Claude Desktop 中相同的名称
  • 如果已存在具有相同名称的服务器,它们将获得数字后缀(例如 server_1

将 Claude Code 用作 MCP 服务器

您可以将 Claude Code 本身用作 MCP 服务器,其他应用程序可以连接到它:
# 启动 Claude 作为 stdio MCP 服务器
claude mcp serve
您可以通过将此配置添加到 claude_desktop_config.json 在 Claude Desktop 中使用它:
{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}
配置可执行文件路径command 字段必须引用 Claude Code 可执行文件。如果 claude 命令不在系统的 PATH 中,您需要指定可执行文件的完整路径。要查找完整路径:
which claude
然后在您的配置中使用完整路径:
{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}
没有正确的可执行文件路径,您会遇到 spawn claude ENOENT 之类的错误。
提示:
  • 服务器提供对 Claude 工具(如 View、Edit、LS 等)的访问权限。
  • 在 Claude Desktop 中,尝试要求 Claude 读取目录中的文件、进行编辑等。
  • 请注意,此 MCP 服务器只是将 Claude Code 的工具暴露给您的 MCP 客户端,因此您自己的客户端负责为各个工具调用实现用户确认。

MCP 输出限制和警告

当 MCP 工具产生大量输出时,Claude Code 可帮助管理令牌使用情况,以防止压倒您的对话上下文:
  • 输出警告阈值:当任何 MCP 工具输出超过 10,000 个令牌时,Claude Code 显示警告
  • 可配置限制:您可以使用 MAX_MCP_OUTPUT_TOKENS 环境变量调整最大允许的 MCP 输出令牌
  • 默认限制:默认最大值为 25,000 个令牌
要增加产生大量输出的工具的限制:
# 为 MCP 工具输出设置更高的限制
export MAX_MCP_OUTPUT_TOKENS=50000
claude
这在使用以下 MCP 服务器时特别有用:
  • 查询大型数据集或数据库
  • 生成详细的报告或文档
  • 处理大量日志文件或调试信息
如果您经常遇到特定 MCP 服务器的输出警告,请考虑增加限制或配置服务器以对其响应进行分页或过滤。

使用 MCP 资源

MCP 服务器可以暴露资源,您可以使用 @ 提及来引用这些资源,类似于引用文件的方式。

引用 MCP 资源

1

列出可用资源

在您的提示中键入 @ 以查看来自所有连接的 MCP 服务器的可用资源。资源与文件一起出现在自动完成菜单中。
2

引用特定资源

使用格式 @server:protocol://resource/path 来引用资源:
> 您能分析 @github:issue://123 并建议修复吗?
> 请查看 @docs:file://api/authentication 处的 API 文档
3

多个资源引用

您可以在单个提示中引用多个资源:
> 比较 @postgres:schema://users 和 @docs:file://database/user-model
提示:
  • 引用时会自动获取资源并将其作为附件包含
  • 资源路径在 @ 提及自动完成中可进行模糊搜索
  • 当服务器支持时,Claude Code 会自动提供工具来列出和读取 MCP 资源
  • 资源可以包含 MCP 服务器提供的任何类型的内容(文本、JSON、结构化数据等)

将 MCP 提示用作斜杠命令

MCP 服务器可以暴露提示,这些提示在 Claude Code 中作为斜杠命令可用。

执行 MCP 提示

1

发现可用的提示

键入 / 以查看所有可用的命令,包括来自 MCP 服务器的命令。MCP 提示以 /mcp__servername__promptname 格式出现。
2

执行不带参数的提示

> /mcp__github__list_prs
3

执行带参数的提示

许多提示接受参数。在命令后面用空格分隔传递它们:
> /mcp__github__pr_review 456
> /mcp__jira__create_issue "登录流中的错误" high
提示:
  • MCP 提示从连接的服务器动态发现
  • 参数根据提示的定义参数进行解析
  • 提示结果直接注入到对话中
  • 服务器和提示名称被规范化(空格变为下划线)

企业 MCP 配置

对于需要对 MCP 服务器进行集中控制的组织,Claude Code 支持企业管理的 MCP 配置。这允许 IT 管理员:
  • 控制员工可以访问哪些 MCP 服务器:在整个组织中部署一组标准化的已批准 MCP 服务器
  • 防止未授权的 MCP 服务器:可选择限制用户添加自己的 MCP 服务器
  • 完全禁用 MCP:如果需要,完全删除 MCP 功能

设置企业 MCP 配置

系统管理员可以在托管设置文件旁边部署企业 MCP 配置文件:
  • macOS/Library/Application Support/ClaudeCode/managed-mcp.json
  • WindowsC:\ProgramData\ClaudeCode\managed-mcp.json
  • Linux/etc/claude-code/managed-mcp.json
managed-mcp.json 文件使用与标准 .mcp.json 文件相同的格式:
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    },
    "company-internal": {
      "type": "stdio",
      "command": "/usr/local/bin/company-mcp-server",
      "args": ["--config", "/etc/company/mcp-config.json"],
      "env": {
        "COMPANY_API_URL": "https://internal.company.com"
      }
    }
  }
}

使用允许列表和拒绝列表限制 MCP 服务器

除了提供企业管理的服务器外,管理员还可以使用 managed-settings.json 文件中的 allowedMcpServersdeniedMcpServers 控制用户可以配置哪些 MCP 服务器:
  • macOS/Library/Application Support/ClaudeCode/managed-settings.json
  • WindowsC:\ProgramData\ClaudeCode\managed-settings.json
  • Linux/etc/claude-code/managed-settings.json
{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "sentry" },
    { "serverName": "company-internal" }
  ],
  "deniedMcpServers": [
    { "serverName": "filesystem" }
  ]
}
允许列表行为(allowedMcpServers
  • undefined(默认):无限制 - 用户可以配置任何 MCP 服务器
  • 空数组 []:完全锁定 - 用户无法配置任何 MCP 服务器
  • 服务器名称列表:用户只能配置指定的服务器
拒绝列表行为(deniedMcpServers
  • undefined(默认):没有服务器被阻止
  • 空数组 []:没有服务器被阻止
  • 服务器名称列表:指定的服务器在所有范围内被显式阻止
重要说明
  • 这些限制适用于所有范围:用户、项目、本地,甚至来自 managed-mcp.json 的企业服务器
  • 拒绝列表具有绝对优先级:如果服务器同时出现在两个列表中,它将被阻止
企业配置优先级:企业 MCP 配置具有最高优先级,无法被用户、本地或项目配置覆盖。