构建与扩展官方原文

通过 MCP 将 Claude Code 连接到工具

了解如何使用 Model Context Protocol 将 Claude Code 连接到您的工具。

了解如何使用 Model Context Protocol 将 Claude Code 连接到您的工具。

Claude Code 可以通过 Model Context Protocol (MCP)（一种用于 AI 工具集成的开源标准）连接到数百个外部工具和数据源。 MCP 服务器使 Claude Code 能够访问您的工具、数据库和 API。

MCP 可以做什么

连接 MCP 服务器后，您可以要求 Claude Code：

实现问题跟踪器的功能：“添加 JIRA 问题 ENG-4521 中描述的功能并在 GitHub 上创建 PR。”
分析监控数据：“检查Sentry和Statsig以检查ENG-4521中描述的功能的使用情况。”
查询数据库：“根据我们的 PostgreSQL 数据库，查找使用功能 ENG-4521 的 10 个随机用户的电子邮件。”
集成设计：“根据 Slack 中发布的新 Figma 设计更新我们的标准电子邮件模板”
自动化工作流程：“创建 Gmail 草稿，邀请这 10 位用户参加有关新功能的反馈会议。”

安装 MCP 服务器

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

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

HTTP 服务器是连接到远程 MCP 服务器的推荐选项。这是基于云的服务最广泛支持的传输。

# Basic syntax
claude mcp add --transport http <name> <url>

# Real example: Connect to Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

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

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

警告

SSE（服务器发送事件）传输已弃用。如果可用，请改用 HTTP 服务器。

# Basic syntax
claude mcp add --transport sse <name> <url>

# Real example: Connect to Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

# Example with authentication header
claude mcp add --transport sse private-api https://api.company.com/sse \
  --header "X-API-Key: your-key-here"

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

Stdio 服务器在您的计算机上作为本地进程运行。它们非常适合需要直接系统访问或自定义脚本的工具。

# Basic syntax
claude mcp add [options] <name> -- <command> [args...]

# Real example: Add Airtable server
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

注意

重要：选项订购

所有选项（--transport、--env、--scope、--header）必须位于服务器名称之前。然后，--（双破折号）将服务器名称与传递到 MCP 服务器的命令和参数分开。

例如：

claude mcp add --transport stdio myserver -- npx server → 运行 npx server
claude mcp add --transport stdio --env KEY=value myserver -- python server.py --port 8080 → 在环境中运行 python server.py --port 8080 和 KEY=value

这可以防止 Claude 的标志与服务器的标志之间发生冲突。

管理您的服务器

配置完成后，您可以使用以下命令管理 MCP 服务器：

# List all configured servers
claude mcp list

# Get details for a specific server
claude mcp get github

# Remove a server
claude mcp remove github

# (within Claude Code) Check server status
/mcp

动态工具更新

Claude Code 支持 MCP list_changed 通知，允许 MCP 服务器动态更新其可用工具、提示和资源，而无需您断开连接并重新连接。当 MCP 服务器发送 list_changed 通知时，Claude Code 会自动刷新该服务器的可用功能。

提示

温馨提示：* 使用 --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 包装器以确保正确执行。

# This creates command="cmd" which Windows can execute
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

如果没有 cmd /c 包装器，您将遇到“连接已关闭”错误，因为 Windows 无法直接执行 npx。（有关 -- 参数的说明，请参阅上面的注释。）

插件提供的 MCP 服务器

插件可以捆绑 MCP 服务器，启用插件后自动提供工具和集成。插件 MCP 服务器的工作方式与用户配置的服务器相同。

插件 MCP 服务器如何工作：

插件在插件根目录的 .mcp.json 中定义 MCP 服务器或在 plugin.json 中内联
启用插件后，其 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 功能：

自动生命周期：会话启动时，启用插件的服务器会自动连接。如果您在会话期间启用或禁用插件，请运行 /reload-plugins 以连接或断开其 MCP 服务器
环境变量：使用 ${CLAUDE_PLUGIN_ROOT} 作为捆绑插件文件，使用 ${CLAUDE_PLUGIN_DATA} 作为在插件更新后仍然存在的持久状态
用户环境访问：访问与手动配置的服务器相同的环境变量
多种传输类型：支持 stdio、SSE 和 HTTP 传输（传输支持可能因服务器而异）

查看插件 MCP 服务器：

# Within Claude Code, see all MCP servers including plugin ones
/mcp

插件服务器出现在列表中，并带有指示符显示它们来自插件。

插件 MCP 服务器的优点：

捆绑分发：工具和服务器打包在一起
自动设置：无需手动 MCP 配置
团队一致性：安装插件后，每个人都获得相同的工具

有关将 MCP 服务器与插件捆绑在一起的详细信息，请参阅插件组件参考。

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

本地范围

本地范围的服务器代表默认配置级别，并存储在项目路径下的 ~/.claude.json 中。这些服务器对您来说是私有的，并且只有在当前项目目录中工作时才能访问。此范围非常适合个人开发服务器、实验配置或包含不应共享的敏感凭据的服务器。

注意

MCP 服务器的术语“本地范围”与一般本地设置不同。 MCP 本地范围服务器存储在 ~/.claude.json（您的主目录）中，而常规本地设置使用 .claude/settings.local.json（在项目目录中）。有关设置文件位置的详细信息，请参阅设置。

# Add a local-scoped server (default)
claude mcp add --transport http stripe https://mcp.stripe.com

# Explicitly specify local scope
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

项目范围

项目范围的服务器通过将配置存储在项目根目录的 .mcp.json 文件中来实现团队协作。该文件旨在签入版本控制，确保所有团队成员都可以访问相同的 MCP 工具和服务。添加项目范围的服务器时，Claude Code 会使用适当的配置结构自动创建或更新此文件。

# Add a project-scoped server
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.json 中，并提供跨项目可访问性，使它们在您计算机上的所有项目中可用，同时对您的用户帐户保持私有。此范围非常适合您在不同项目中经常使用的个人实用服务器、开发工具或服务。

# Add a user server
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

选择正确的范围

根据以下条件选择您的范围：

本地范围：个人服务器、实验配置或特定于一个项目的敏感凭据
项目范围：团队共享服务器、项目特定工具或协作所需的服务
用户范围：跨多个项目、开发工具或常用服务所需的个人实用程序

注意

MCP 服务器存储在哪里？

用户和本地范围：~/.claude.json（在 mcpServers 字段中或项目路径下）
项目范围：项目根目录中的 .mcp.json（签入源代码管理）
托管：系统目录中的 managed-mcp.json（请参阅托管 MCP 配置）

范围层次结构和优先级

MCP 服务器配置遵循明确的优先级层次结构。当多个作用域存在同名服务器时，系统会通过优先考虑本地作用域的服务器、其次是项目作用域的服务器、最后是用户作用域的服务器来解决冲突。这种设计确保个人配置可以在需要时覆盖共享配置。### .mcp.json 中的环境变量扩展

Claude Code 支持 .mcp.json 文件中的环境变量扩展，允许团队共享配置，同时保持机器特定路径和 API 密钥等敏感值的灵活性。

支持的语法：

${VAR} - 扩展到环境变量 VAR 的值
${VAR:-default} - 如果设置则扩展为 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 将无法解析配置。

实际例子

{/* ### 示例：使用 Playwright 自动化浏览器测试

claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest

然后编写并运行浏览器测试：

Test if the login flow works with test@example.com

Take a screenshot of the checkout page on mobile

Verify that the search feature returns results
``` */}

### 示例：使用 Sentry 监视错误

```bash
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

使用您的 Sentry 帐户进行身份验证：

/mcp

然后调试生产问题：

What are the most common errors in the last 24 hours?

Show me the stack trace for error ID abc123

Which deployment introduced these new errors?

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

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

如果需要，请为 GitHub 选择“身份验证”进行身份验证：

/mcp

然后使用 GitHub：

Review PR #456 and suggest improvements

Create a new issue for the bug we just found

Show me all open PRs assigned to me

示例：查询您的 PostgreSQL 数据库

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

然后自然地查询你的数据库：

What's our total revenue this month?

Show me the schema for the orders table

Find customers who haven't made a purchase in 90 days

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

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

添加需要认证的服务器

例如：

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

在 Claude Code 中使用 /mcp 命令

在 Claude 代码中，使用以下命令：

/mcp

然后按照浏览器中的步骤进行登录。

提示

温馨提示：

身份验证令牌安全存储并自动刷新
使用 /mcp 菜单中的“清除身份验证”来撤销访问权限
如果您的浏览器没有自动打开，请复制提供的 URL 并手动打开
如果身份验证后浏览器重定向失败并出现连接错误，请将浏览器地址栏中的完整回调 URL 粘贴到 Claude Code 中显示的 URL 提示中
OAuth 身份验证适用于 HTTP 服务器

使用固定的OAuth回调端口

某些 MCP 服务器需要提前注册特定的重定向 URI。默认情况下，Claude Code 为 OAuth 回调选择一个随机可用端口。使用 --callback-port 修复端口，使其与 http://localhost:PORT/callback 形式的预注册重定向 URI 匹配。

您可以单独使用 --callback-port（通过动态客户端注册）或与 --client-id 一起使用（通过预配置的凭据）。

# Fixed callback port with dynamic client registration
claude mcp add --transport http \
  --callback-port 8080 \
  my-server https://mcp.example.com/mcp

使用预配置的 OAuth 凭据某些 MCP 服务器不支持自动 OAuth 设置。如果您看到类似“不兼容的身份验证服务器：不支持动态客户端注册”的错误，则服务器需要预先配置的凭据。首先通过服务器的开发人员门户注册 OAuth 应用程序，然后在添加服务器时提供凭据。

向服务器注册 OAuth 应用程序

通过服务器的开发人员门户创建应用程序，并记下您的客户端 ID 和客户端密钥。

许多服务器还需要重定向 URI。如果是这样，请选择一个端口并以 http://localhost:PORT/callback 格式注册重定向 URI。在下一步中使用与 --callback-port 相同的端口。

使用您的凭据添加服务器

选择以下方法之一。用于 `--callback-port` 的端口可以是任何可用端口。它只需要与您在上一步中注册的重定向 URI 匹配即可。

克劳德·MCP 添加

使用 --client-id 传递应用程序的客户端 ID。 --client-secret 标志提示使用屏蔽输入的秘密：

claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

克劳德 mcp add-json

将 oauth 对象包含在 JSON 配置中，并将 --client-secret 作为单独的标志传递：

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \
  --client-secret

claude mcp add-json （仅限回调端口）

在使用动态客户端注册时，使用不带客户端 ID 的 --callback-port 来修复端口：

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"callbackPort":8080}}'

CI / 环境变量

通过环境变量设置秘密以跳过交互式提示：

MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

在 Claude Code 中进行身份验证

在 Claude Code 中运行 /mcp 并按照浏览器登录流程进行操作。

提示

温馨提示：

客户端密钥安全地存储在您的系统钥匙串 (macOS) 或凭证文件中，而不是存储在您的配置中
如果服务器使用没有密钥的公共 OAuth 客户端，则仅使用 --client-id，而不使用 --client-secret
--callback-port 可与或不与 --client-id 一起使用
这些标志仅适用于 HTTP 和 SSE 传输。它们对 stdio 服务器没有影响
使用 claude mcp get <name> 验证是否为服务器配置了 OAuth 凭据

覆盖 OAuth 元数据发现

如果您的 MCP 服务器在标准 OAuth 元数据端点 (/.well-known/oauth-authorization-server) 上返回错误，但公开工作的 OIDC 端点，您可以告诉 Claude Code 直接从您指定的 URL 获取 OAuth 元数据，绕过标准发现链。

在 .mcp.json 中服务器配置的 oauth 对象中设置 authServerMetadataUrl：

{
  "mcpServers": {
    "my-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "authServerMetadataUrl": "https://auth.example.com/.well-known/openid-configuration"
      }
    }
  }
}

URL 必须使用 https://。此选项需要 Claude Code v2.1.64 或更高版本。

从 JSON 配置添加 MCP 服务器

如果您有 MCP 服务器的 JSON 配置，则可以直接添加：

从 JSON 添加 MCP 服务器

# Basic syntax
claude mcp add-json <name> '<json>'

# Example: Adding an HTTP server with JSON configuration
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# Example: Adding a stdio server with JSON configuration
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

# Example: Adding an HTTP server with pre-configured OAuth credentials
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret

验证服务器是否已添加

claude mcp get weather-api

提示

温馨提示：

确保 JSON 在您的 shell 中正确转义
JSON 必须符合 MCP 服务器配置架构
您可以使用 --scope user 将服务器添加到您的用户配置中，而不是特定于项目的配置

从 Claude Desktop 导入 MCP 服务器

如果您已经在 Claude Desktop 中配置了 MCP 服务器，则可以导入它们：

从 Claude Desktop 导入服务器

# Basic syntax 
claude mcp add-from-claude-desktop 
```### 选择要导入的服务器

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

  
### 验证服务器是否已导入

```bash
claude mcp list

提示

温馨提示：

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

使用 Claude.ai 的 MCP 服务器

如果您已使用 Claude.ai 帐户登录 Claude Code，则您在 Claude.ai 中添加的 MCP 服务器将自动在 Claude Code 中可用：

在 Claude.ai 中配置 MCP 服务器

在 claude.ai/settings/connectors 添加服务器。在团队和企业计划中，只有管理员可以添加服务器。

验证 MCP 服务器

在 Claude.ai 中完成任何必需的身份验证步骤。

查看和管理 Claude Code 中的服务器

在 Claude Code 中，使用命令：

/mcp

Claude.ai 服务器出现在列表中，并带有指示符显示它们来自 Claude.ai。

要在 Claude Code 中禁用 claude.ai MCP 服务器，请将 ENABLE_CLAUDEAI_MCP_SERVERS 环境变量设置为 false：

ENABLE_CLAUDEAI_MCP_SERVERS=false claude

使用 Claude Code 作为 MCP 服务器

您可以使用 Claude Code 本身作为其他应用程序可以连接到的 MCP 服务器：

# Start Claude as a stdio MCP server
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 的查看、编辑、LS 等工具的访问。
在 Claude Desktop 中，尝试要求 Claude 读取目录中的文件、进行编辑等。
请注意，此 MCP 服务器仅向您的 MCP 客户端公开 Claude Code 的工具，因此您自己的客户端负责实现各个工具调用的用户确认。

MCP 输出限制和警告

当 MCP 工具产生大量输出时，Claude Code 帮助管理令牌使用情况，以防止淹没您的对话上下文：

输出警告阈值：当任何 MCP 工具输出超过 10,000 个令牌时，Claude Code 将显示警告
可配置限制：您可以使用 MAX_MCP_OUTPUT_TOKENS 环境变量调整允许的最大 MCP 输出令牌
默认限制：默认最大值为 25,000 个代币

要增加产生大输出的工具的限制：

# Set a higher limit for MCP tool outputs
export MAX_MCP_OUTPUT_TOKENS=50000
claude

当使用 MCP 服务器时，这特别有用：* 查询大型数据集或数据库

生成详细的报告或文档
处理大量日志文件或调试信息

警告

如果您经常遇到特定 MCP 服务器的输出警告，请考虑增加限制或配置服务器以分页或过滤其响应。

响应 MCP 启发请求

MCP 服务器可以使用启发向您请求中间任务的结构化输入。当服务器需要它自己无法获取的信息时，Claude Code 会显示一个交互式对话框，并将您的响应传递回服务器。您无需进行任何配置：当服务器请求时，会自动出现诱导对话框。

服务器可以通过两种方式请求输入：

表单模式：Claude Code 显示一个对话框，其中包含服务器定义的表单字段（例如，用户名和密码提示）。填写字段并提交。
URL 模式：Claude Code 打开浏览器 URL 进行身份验证或批准。在浏览器中完成流程，然后在 CLI 中确认。

要自动响应诱导请求而不显示对话框，请使用 Elicitation 挂钩。

如果您正在构建使用诱导的 MCP 服务器，请参阅 MCP 诱导规范以获取协议详细信息和架构示例。

使用 MCP 资源

MCP 服务器可以公开您可以使用@提及引用的资源，类似于引用文件的方式。

###参考MCP资源

列出可用资源

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

引用特定资源

使用 @server:protocol://resource/path 格式引用资源：

Can you analyze @github:issue://123 and suggest a fix?

Please review the API documentation at @docs:file://api/authentication

多个资源引用

您可以在单个提示中引用多个资源：

Compare @postgres:schema://users with @docs:file://database/user-model

提示

温馨提示：

引用时自动获取资源并作为附件包含在内
资源路径在@提及自动完成中可模糊搜索
Claude Code 在服务器支持时自动提供列出和读取 MCP 资源的工具
资源可以包含 MCP 服务器提供的任何类型的内容（文本、JSON、结构化数据等）

使用 MCP 工具搜索进行扩展

当您配置了许多 MCP 服务器时，工具定义可能会占用上下文窗口的很大一部分。 MCP 工具搜索通过按需动态加载工具而不是预加载所有工具来解决此问题。

它是如何工作的

当 MCP 工具描述占用上下文窗口的 10% 以上时，Claude Code 会自动启用工具搜索。您可以调整此阈值或完全禁用工具搜索。触发时：

MCP 工具被推迟而不是预先加载到上下文中
Claude在需要时使用搜索工具发现相关的MCP工具
仅将 Claude 实际需要的工具加载到上下文中
从您的角度来看，MCP 工具继续像以前一样工作

对于 MCP 服务器作者如果您正在构建 MCP 服务器，则启用工具搜索后，服务器说明字段将变得更加有用。服务器说明可帮助 Claude 了解何时搜索您的工具，类似于技能的工作方式。

添加清晰的描述性服务器指令来解释：

您的工具处理什么类别的任务
Claude 何时应搜索您的工具
您的服务器提供的关键功能

配置工具搜索

默认情况下启用工具搜索：MCP 工具会延迟并按需发现。当 ANTHROPIC_BASE_URL 指向非第一方主机时，默认情况下会禁用工具搜索，因为大多数代理不会转发 tool_reference 块。如果您的代理这样做，请明确设置 ENABLE_TOOL_SEARCH。此功能需要支持 tool_reference 块的模型：Sonnet 4 及更高版本，或 Opus 4 及更高版本。 Haiku 模型不支持工具搜索。

使用 ENABLE_TOOL_SEARCH 环境变量控制工具搜索行为：

价值	行为
（未设置）	默认启用。 `ANTHROPIC_BASE_URL` 为非第一方主机时禁用
`true`	始终启用，包括非第一方 `ANTHROPIC_BASE_URL`
`auto`	当 MCP 工具超过上下文的 10% 时激活
`auto:<N>`	在自定义阈值处激活，其中 `<N>` 是百分比（例如，`auto:5` 表示 5%）
`false`	已禁用，所有 MCP 工具均已预先加载

# Use a custom 5% threshold
ENABLE_TOOL_SEARCH=auto:5 claude

# Disable tool search entirely
ENABLE_TOOL_SEARCH=false claude

或者在 settings.json env 字段中设置值。

您还可以专门使用 disallowedTools 设置禁用 MCPSearch 工具：

{
  "permissions": {
    "deny": ["MCPSearch"]
  }
}

使用 MCP 提示符作为命令

MCP 服务器可以公开提示，这些提示可作为 Claude Code 中的命令使用。

###执行MCP提示

发现可用的提示

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

执行不带参数的提示

/mcp__github__list_prs

执行带有参数的提示

许多提示接受参数。在命令后传递它们，以空格分隔：

/mcp__github__pr_review 456

/mcp__jira__create_issue "Bug in login flow" high

提示

温馨提示：

MCP 提示是从连接的服务器动态发现的
根据提示定义的参数解析参数
提示结果直接注入到对话中
服务器和提示符名称已标准化（空格变为下划线）

托管 MCP 配置

对于需要集中控制 MCP 服务器的组织，Claude Code 支持两种配置选项：

与managed-mcp.json独占控制：部署一组固定的MCP服务器，用户无法修改或扩展
基于策略的允许列表/拒绝列表：允许用户添加自己的服务器，但限制允许的服务器

这些选项允许 IT 管理员：* 控制员工可以访问哪些 MCP 服务器：在整个组织内部署一组标准化的经批准的 MCP 服务器

防止未经授权的 MCP 服务器：限制用户添加未经批准的 MCP 服务器
完全禁用 MCP：如果需要，完全删除 MCP 功能

选项 1：使用 Managed-mcp.json 进行独占控制

当您部署 managed-mcp.json 文件时，它会对所有 MCP 服务器进行独占控制。用户无法添加、修改或使用除此文件中定义的服务器之外的任何 MCP 服务器。对于想要完全控制的组织来说，这是最简单的方法。

系统管理员将配置文件部署到系统范围的目录中：

macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
Linux 和 WSL：/etc/claude-code/managed-mcp.json
Windows: C:\Program Files\ClaudeCode\managed-mcp.json

注意

这些是需要管理员权限的系统范围路径（不是像 ~/Library/... 这样的用户主目录）。它们旨在由 IT 管理员部署。

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"
      }
    }
  }
}

选项 2：使用允许列表和拒绝列表进行基于策略的控制

管理员可以允许用户配置自己的 MCP 服务器，同时对允许的服务器实施限制，而不是采取独占控制。此方法使用托管设置文件中的 allowedMcpServers 和 deniedMcpServers。

注意

在选项之间进行选择：当您想要部署一组固定的服务器而不需要用户自定义时，请使用选项 1 (managed-mcp.json)。当您希望允许用户在策略限制内添加自己的服务器时，请使用选项 2（允许列表/拒绝列表）。

限制选项

允许列表或拒绝列表中的每个条目都可以通过三种方式限制服务器：

按服务器名称 (serverName)：匹配服务器的配置名称
按命令 (serverCommand)：匹配用于启动 stdio 服务器的确切命令和参数
按 URL 模式 (serverUrl)：使用通配符支持匹配远程服务器 URL

重要提示：每个条目必须恰好具有 serverName、serverCommand 或 serverUrl 之一。

配置示例

{
  "allowedMcpServers": [
    // Allow by server name
    { "serverName": "github" },
    { "serverName": "sentry" },

    // Allow by exact command (for stdio servers)
    { "serverCommand": ["npx", "-y", "@modelcontextprotocol/server-filesystem"] },
    { "serverCommand": ["python", "/usr/local/bin/approved-server.py"] },

    // Allow by URL pattern (for remote servers)
    { "serverUrl": "https://mcp.company.com/*" },
    { "serverUrl": "https://*.internal.corp/*" }
  ],
  "deniedMcpServers": [
    // Block by server name
    { "serverName": "dangerous-server" },

    // Block by exact command (for stdio servers)
    { "serverCommand": ["npx", "-y", "unapproved-package"] },

    // Block by URL pattern (for remote servers)
    { "serverUrl": "https://*.untrusted.com/*" }
  ]
}

基于命令的限制如何工作

精确匹配：

命令数组必须完全匹配 - 命令和所有参数都按正确的顺序
示例：["npx", "-y", "server"] 将与 ["npx", "server"] 或 ["npx", "-y", "server", "--flag"] 不匹配

Stdio 服务器行为：

当允许列表包含任何 serverCommand 条目时，stdio 服务器必须匹配这些命令之一
当存在命令限制时，Stdio 服务器无法单独通过名称传递
这确保管理员可以强制执行哪些命令被允许运行

非 stdio 服务器行为：

当白名单中存在 serverUrl 条目时，远程服务器（HTTP、SSE、WebSocket）使用基于 URL 的匹配
如果不存在 URL 条目，远程服务器将回退到基于名称的匹配
命令限制不适用于远程服务器

基于 URL 的限制如何工作

URL 模式支持使用 * 的通配符来匹配任何字符序列。这对于允许整个域或子域非常有用。

通配符示例：* https://mcp.company.com/* - 允许特定域上的所有路径

https://*.example.com/* - 允许 example.com 的任何子域
http://localhost:*/* - 允许本地主机上的任何端口

远程服务器行为：

当允许列表包含任何 serverUrl 条目时，远程服务器必须匹配这些 URL 模式之一
当存在 URL 限制时，远程服务器无法仅通过名称传递
这确保管理员可以强制允许哪些远程端点

示例：仅限 URL 的白名单

{
  "allowedMcpServers": [
    { "serverUrl": "https://mcp.company.com/*" },
    { "serverUrl": "https://*.internal.corp/*" }
  ]
}

结果：

HTTP 服务器位于 https://mcp.company.com/api： ✅ 允许（匹配 URL 模式）
HTTP 服务器位于 https://api.internal.corp/mcp： ✅ 允许（匹配通配符子域）
HTTP 服务器位于 https://external.com/mcp：❌ 已阻止（与任何 URL 模式都不匹配）
具有任何命令的 Stdio 服务器： ❌ 已阻止（没有名称或命令条目匹配）

示例：仅限命令的白名单

{
  "allowedMcpServers": [
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

结果：

具有 ["npx", "-y", "approved-package"] 的 Stdio 服务器： ✅ 允许（与命令匹配）
具有 ["node", "server.js"] 的 Stdio 服务器：❌ 已阻止（与命令不匹配）
名为“my-api”的 HTTP 服务器：❌ 已阻止（没有可匹配的名称条目）

示例：混合名称和命令白名单

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

结果：

名为“local-tool”且带有 ["npx", "-y", "approved-package"] 的 Stdio 服务器： ✅ 允许（与命令匹配）
名为“local-tool”且带有 ["node", "server.js"] 的 Stdio 服务器：❌ 已阻止（命令条目存在但不匹配）
名为“github”且带有 ["node", "server.js"] 的 Stdio 服务器：❌ 已阻止（当命令条目存在时，stdio 服务器必须匹配命令）
名为“github”的 HTTP 服务器： ✅ 允许（与名称匹配）
名为“other-api”的 HTTP 服务器：❌ 已阻止（名称不匹配）

示例：仅限名称白名单

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "internal-tool" }
  ]
}

结果：

名为“github”的 Stdio 服务器，带有任何命令： ✅ 允许（无命令限制）
名为“internal-tool”的 Stdio 服务器，可使用任何命令： ✅ 允许（无命令限制）
名为“github”的 HTTP 服务器： ✅ 允许（与名称匹配）
任何名为“其他”的服务器： ❌ 已阻止（名称不匹配）

允许列表行为 (`allowedMcpServers`)

undefined（默认）：无限制 - 用户可以配置任何 MCP 服务器
空阵列 []：完全锁定 - 用户无法配置任何 MCP 服务器
条目列表：用户只能配置按名称、命令或 URL 模式匹配的服务器

拒绝列表行为 (`deniedMcpServers`)

undefined（默认）：没有服务器被阻止
空阵列 []：没有服务器被阻止
条目列表：指定服务器在所有范围内被明确阻止

重要提示

选项1和选项2可以组合：如果managed-mcp.json存在，则具有独占控制权，用户无法添加服务器。允许列表/拒绝列表仍然适用于托管服务器本身。
拒绝列表具有绝对优先级：如果服务器与拒绝列表条目（按名称、命令或 URL）匹配，即使它位于允许列表中，也会被阻止
基于名称、基于命令和基于 URL 的限制协同工作：如果服务器与 名称条目、命令条目或 URL 模式匹配则通过（除非被拒绝列表阻止）

注意****使用 managed-mcp.json 时：用户无法通过 claude mcp add 或配置文件添加 MCP 服务器。 allowedMcpServers 和 deniedMcpServers 设置仍适用于筛选实际加载的托管服务器。

通过 MCP 将 Claude Code 连接到工具

MCP 可以做什么

热门 MCP 服务器

Notion

Canva

Figma

Slack

Atlassian

Linear

monday.com

Intercom

Box

Gamma

Vercel

Granola

Asana

Miro

Sentry

PubMed

n8n

苏帕巴斯

点击

抱脸

上下文7

条纹

微软学习

粘土

NetSuite

网络流

阿雷夫斯

临床试验

Cloudflare 开发者平台

学者门户

智能表

坡道

缩放信息

生物Rxiv

WordPress.com

网络化

雪花

制作

NPI 注册表

GoDaddy

谷歌云 BigQuery

CMS 覆盖范围

收集

化学BL

十六进制

ICD-10 代码

贝宝

开放目标

数据块

氛围勘探

AWS 市场

维克斯

彭多

克拉维约

邮差猪

类似网站

Crypto.com

生物渲染

阿蒂奥

大师

特里瓦戈

温莎.ai

Synapse.org

果酱

共识

横梁

顺时针

回圈

最后一分钟.com

外展

混合面板

比特利

CData 连接人工智能

MT 通讯社

广场

埃及人

塔架