Claude Code MCP 完全指南：三种安装方式、三级作用域、OAuth 认证与企业管控策略

# 基本语法
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 secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# 示例：连接 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"

# 基本语法（注意：所有选项必须在服务器名称之前，-- 之后是服务器命令）
claude mcp add [options] <name> -- <command> [args...]

# 示例：添加 Airtable 服务器
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

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

# 获取特定服务器的详情
claude mcp get github

# 移除服务器
claude mcp remove github

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

# 团队共享 GitHub MCP（写入 .mcp.json）
claude mcp add --scope project --transport http github https://mcp.github.com/mcp

# 个人全局工具（跨项目可用）
claude mcp add --scope user --transport http sentry https://mcp.sentry.io/mcp

{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": ["-y", "@myorg/db-mcp"],
      "env": {
        "DB_URL": "${DB_URL}"
      }
    }
  }
}

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

# 2. 在 Claude Code 中使用
> analyze the most recent errors in Sentry and suggest fixes

# 1. 添加 GitHub MCP
claude mcp add --transport http github https://mcp.github.com/mcp

# 2. 使用场景
> review PR #123 and leave comments on potential issues
> fetch the open issues and create a prioritized task list

# 1. 添加 PostgreSQL MCP（本地 stdio）
claude mcp add --transport stdio --env DATABASE_URL=postgresql://user:pass@localhost/db \
  postgres -- npx -y @modelcontextprotocol/server-postgres

# 2. 查询示例
> find all users who signed up in the last 7 days and show their usage stats

claude mcp add --transport http --oauth-redirect-port 9999 myservice https://api.example.com/mcp

claude mcp add --transport http \
  --oauth-client-id your-client-id \
  --oauth-client-secret your-client-secret \
  myservice https://api.example.com/mcp

# 用 @ 符号引用 MCP 资源
> analyze @sentry://recent-errors and fix the most critical ones
> update the code based on @figma://design/latest

{
  "mcpServers": {
    "approved-github": {
      "url": "https://mcp.github.com/mcp",
      "transport": "http"
    }
  }
}

{
  "allowedMcpServers": [
    { "url": "https://trusted-mcp.company.com" },
    { "command": "/usr/local/bin/approved-mcp" }
  ],
  "deniedMcpServers": [
    { "url": "https://blocked-service.com" }
  ]
}