Claude Code MCP服务器配置完全指南：三种方法详解

MCP（Model Context Protocol）是一个开源标准，用于 AI 工具集成。通过 MCP 服务器，Claude Code 可以连接到外部工具和数据源，包括数据库、API 和各种服务。本文基于 Claude 官方文档，介绍如何在 Claude Code 中配置和管理 MCP 服务器。

MCP能做什么？

配置 MCP 服务器后，可以让 Claude Code 执行以下操作：

• 实时数据访问：搜索引擎、数据库、API
• 文件系统操作：读写文件、目录管理
• 开发工具集成：GitHub、Jira、Slack等
• 自定义服务：连接任何支持MCP协议的外部服务

方法一：HTTP远程服务器

基本语法：

# 基本语法
claude mcp add --transport http <name> <url>

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

# 带 Bearer token 的示例
claude mcp add --transport http github --header "Authorization: Bearer ghp_xxx" https://api.githubcopilot.com/mcp

方法二：Stdio本地服务器

基本语法：

# 基本语法
claude mcp add --transport stdio <name> -- <command> [args...]

# 示例：添加时间服务器
claude mcp add --transport stdio time -- npx -y @anthropic/mcp-server-time

# 带环境变量的示例
claude mcp add --transport stdio github -e GITHUB_TOKEN=ghp_xxx -- npx -y @anthropic/mcp-server-github

方法三：JSON配置添加

# 添加 HTTP 服务器
claude mcp add-json weather-api '{"type":"http","url":"https://weather.example.com/mcp"}'

# 添加 Stdio 服务器
claude mcp add-json my-server '{"type":"stdio","command":"/path/to/server","args":["--verbose"]}'

三种作用域

MCP服务器支持三种作用域配置：

• local作用域（默认）：存储在项目根目录的 .mcp.json 文件中，仅当前项目可用
• project作用域：存储在项目的 .mcp.json 文件中，可提交到Git，团队共享
• user作用域：存储在 ~/.claude.json 中，跨所有项目可用，当前用户私有

作用域优先级：local > project > user。当同名服务器存在于多个作用域时，高优先级覆盖低优先级。

管理MCP服务器

# 列出所有已配置的 MCP 服务器
claude mcp list

# 获取特定服务器详情
claude mcp get <name>

# 删除 MCP 服务器
claude mcp remove <name>

# 重置项目批准选择
claude mcp reset-project-choices

环境变量扩展

Claude Code 在 .mcp.json 文件中支持环境变量扩展，方便安全管理敏感信息：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

最佳实践

• 安全性：不要在项目配置文件中硬编码API密钥，使用环境变量扩展
• 团队协作：将通用MCP服务器配置放在project作用域，提交到Git共享
• 按需加载：只添加当前项目需要的MCP服务器，避免过多服务器影响性能
• 版本锁定：使用具体版本号而非latest，确保团队成员环境一致

游侠云AI普通

收藏 链接