添加 MCP 服务器

概述

本节介绍如何向 Claude Code 添加 MCP 服务器，包括 HTTP、SSE 与本地 stdio 三种方式。

添加远程 HTTP 服务器

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"

# API 密钥
claude mcp add --transport http api https://api.example.com/mcp \
  --header "X-API-Key: your-api-key"

多标头示例

claude mcp add --transport http custom-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token" \
  --header "X-Custom-Header: custom-value"

添加远程 SSE 服务器

SSE 已弃用，建议使用 HTTP。

claude mcp add --transport sse <name> <url>

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"

添加本地 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 mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

# 添加 Python 服务器
claude mcp add --transport stdio python-server -- python server.py

使用 `--` 参数分隔

# 运行 npx server
claude mcp add --transport stdio myserver -- npx server

# 运行 python server.py --port 8080
claude mcp add --transport stdio myserver --env KEY=value -- python server.py --port 8080

Windows 注意事项

# 使用 cmd /c 包装器
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

配置选项

环境变量

claude mcp add --transport stdio db \
  --env DB_URL=postgresql://user:pass@localhost/db \
  --env DB_TIMEOUT=30 \
  -- npx -y db-server

作用域

# 本地范围（默认）
claude mcp add --transport http github https://api.github.com/mcp/

# 项目范围
claude mcp add --transport http github --scope project https://api.github.com/mcp/

# 用户范围
claude mcp add --transport http github --scope user https://api.github.com/mcp/

超时设置

# 设置 10 秒超时
MCP_TIMEOUT=10000 claude

输出限制

# 设置 50,000 令牌限制
MAX_MCP_OUTPUT_TOKENS=50000 claude

身份验证

OAuth 2.0

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

# 2. 在 Claude Code 中进行身份验证
/mcp

API 密钥

claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer your-api-key"

环境变量

claude mcp add --transport stdio db \
  --env API_KEY=your-key \
  -- npx -y db-server

验证安装

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

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

# 在 Claude Code 中检查服务器状态
/mcp

常见问题

连接失败

检查网络与 URL
验证身份验证配置
查看错误日志

超时错误

提升 MCP_TIMEOUT
检查网络延迟
减少启动负载

Windows 执行错误

claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

最佳实践

HTTP 适合远程，stdio 适合本地。
使用环境变量管理凭证。
定期检查服务器状态。
SSE 已弃用，避免使用。

删除服务器

claude mcp remove github

重置配置

claude mcp reset-project-choices

添加 MCP 服务器

On this page