《Claude Code 连接外部工具完全指南》通俗解读版

这篇文章的核心是教你如何通过 MCP（Model Context Protocol，模型上下文协议） 这个开源标准，让 Claude Code 连接数百个外部工具，从一个单纯的代码助手变成一个能操控各种软件的“超级管家”。

以下是文章涵盖的所有核心内容：

一、 MCP 是什么？能做什么？

概念：MCP 就像是一个“万能插座”。Claude Code 本身很聪明，但它原本无法直接访问你公司的数据库、JIRA 任务板或 Figma 设计稿。MCP 就是那个把 Claude Code 和这些外部工具连接起来的标准接口。

连接后能做的事（应用场景）：
文章列举了六大类应用场景：

从问题跟踪器实现功能：例如，“添加 JIRA 问题 ENG-4521 中描述的功能，并在 GitHub 上创建 PR。”
分析监控数据：例如，“检查 Sentry 和 Statsig 以检查 ENG-4521 中描述的功能的使用情况。”
查询数据库：例如，“根据我们的 PostgreSQL 数据库，查找使用功能 ENG-4521 的 10 个随机用户的电子邮件。”
集成设计：例如，“根据在 Slack 中发布的新 Figma 设计更新我们的标准电子邮件模板。”
自动化工作流：例如，“创建 Gmail 草稿，邀请这 10 个用户参加关于新功能的反馈会议。”
对外部事件做出反应：这是特殊功能。MCP 服务器可以作为“频道”将消息推送到你的会话中。当你不在时，Claude 可以对 Telegram 消息、Discord 聊天或 webhook 事件做出反应。

二、常用 MCP 服务器列表（“应用商店”）

文章列举了大量现成的 MCP 服务器，并给出了具体的安装命令。以下是部分代表性示例：

工具名称	用途	安装命令示例
Ticket Tailor	管理门票、订单的平台	`claude mcp add --transport http tickettailor https://mcp.tickettailor.ai/mcp`
Linear	管理问题、项目和工作流	`claude mcp add --transport http linear https://mcp.linear.app/mcp`
Hugging Face	访问 Hugging Face Hub 和 Gradio 应用	`claude mcp add --transport http hugging-face https://huggingface.co/mcp`
Amplitude	搜索和获取 Amplitude 数据洞察	`claude mcp add --transport http amplitude https://mcp.amplitude.com/mcp`
Atlassian Rovo	从 Claude 访问 Jira 和 Confluence	`claude mcp add --transport http atlassian https://mcp.atlassian.com/v1/mcp`
AWS Marketplace	发现、评估和购买云解决方案	`claude mcp add aws-marketplace --transport http https://marketplace-mcp.us-east-1.api.aws/mcp`
Asana	连接 Asana 协调任务和项目	`claude mcp add --transport streamable-http asana https://mcp.asana.com/v2/mcp`
Microsoft Learn	搜索微软官方文档辅助开发	`claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp`

注意：部分工具（如 ActiveCampaign, Benchling, NetSuite, Pigment）需要用户特定的 URL，需先获取自己的 URL 才能配置。

三、如何管理你的 MCP 服务器

配置完成后，有一套完整的管理命令：

列出所有服务器：claude mcp list
获取特定服务器详情：claude mcp get github
删除服务器：claude mcp remove github
检查状态：在 Claude Code 中输入 /mcp 命令。

高级管理技巧：

动态工具更新：Claude Code 支持 list_changed 通知。这意味着 MCP 服务器可以动态更新其可用工具、提示和资源，无需你断开重连，Claude Code 会自动刷新功能。
使用频道推送消息：如前所述，服务器可推送消息。要启用此功能，服务器需声明 claude/channel 功能，并在启动时使用 --channels 标志。

四、配置详解与高级设置

这部分是实际操作的关键细节：

1. Scope（作用域）标志
使用 --scope 标志决定配置保存在哪里，这对团队协作很重要：

local（默认）：仅在当前项目中对您可用（旧称 project）。
project：通过 .mcp.json 文件与项目中的每个人共享。
user：在所有项目中对您可用（旧称 global）。

2. 环境变量与超时设置

设置环境变量：使用 --env 标志，例如 --env KEY=value。
超时控制：使用 MCP_TIMEOUT 环境变量配置服务器启动超时（例如 MCP_TIMEOUT=10000 claude 设置 10 秒超时）。
输出限制：当 MCP 工具输出超过 10,000 个令牌时，Claude Code 会显示警告。可通过设置 MAX_MCP_OUTPUT_TOKENS 环境变量来增加限制。

3. 身份验证
对于需要 OAuth 2.0 认证的远程服务器，使用 /mcp 命令进行身份验证。

4. .mcp.json 中的环境变量扩展
这是一个高级且实用的功能。Claude Code 支持在配置文件中使用环境变量，方便团队共享配置但保留各自的敏感信息。

语法：
- ${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 将无法解析配置。

五、实战案例演示

文章提供了两个完整的端到端示例：

案例 1：使用 Sentry 监控错误

安装：claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
认证：输入 /mcp 并使用 Sentry 账户登录。
使用：
- “过去 24 小时内最常见的错误是什么？”
- “显示我错误 ID abc123 的堆栈跟踪”
- “哪个部署引入了这些新错误？”

案例 2：连接到 GitHub 进行代码审查

安装：claude mcp add --transport http github https://api.githubcopilot.com/mcp/
认证：通过 /mcp 选择 GitHub 进行身份验证。
使用：
- “审查 PR #456 并建议改进”
- “为我们刚发现的错误创建新问题”
- “显示分配给我的所有开放 PR”

禁用服务器：如果需要，可以通过设置环境变量禁用：ENABLE_CLAUDEAI_MCP_SERVERS=false claude

六、将 Claude Code 本身作为 MCP 服务器

这是一个“反向”使用的高级功能。你不仅可以连接工具，还可以把 Claude Code 变成一个 MCP 服务器，让其他应用程序连接它。

启动命令：claude mcp serve（启动为 stdio MCP 服务器）。

在 Claude Desktop 中使用：可以通过修改 claude_desktop_config.json 配置文件，让 Claude Desktop 连接到 Claude Code。

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude", // 如果 claude 不在 PATH 中，需使用完整路径
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

重要提示：
- 必须确保 command 字段指向正确的可执行文件路径（可用 which claude 查找），否则会报错（如 spawn claude ENOENT）。
- 此服务器向 MCP 客户端公开 Claude Code 的工具（如 View, Edit, LS 等）。
- 安全责任：你的 MCP 客户端需要负责为单个工具调用实现用户确认。

七、安全与风险提示

文章最后特别强调了安全性：

第三方服务器风险：使用第三方 MCP 服务器时，安全性和正确性的风险由用户自行承担。就像从网上下载软件一样，需要自行判断来源的可靠性。
组织托管配置：在企业环境中，建议通过托管配置实施集中管控，以确保安全与合规。

总结

这篇文章是一份从概念、安装、配置、管理到实战案例和高级定制的全链路指南。它不仅告诉你可以连接什么，还详细说明了如何安全地连接、如何通过环境变量灵活配置、如何处理身份验证、如何利用频道进行实时交互，以及如何将 Claude Code 本身转化为服务供其他应用调用。核心目的是让用户能够根据自己的需求，安全、高效地扩展 Claude Code 的能力边界。

On this page