# 默认添加（本地范围）
    claude mcp add --transport http stripe https://mcp.stripe.com
 
    # 显式指定本地范围
    claude mcp add --transport http stripe --scope local https://mcp.stripe.com

    ~/.claude/projects/<project-id>/mcp.json

 
    ### 配置文件格式
 
    生成的 `.mcp.json` 文件遵循标准化格式：
 
    ~~~json
 
```json
    {
      "mcpServers": {
        "shared-server": {
          "command": "/path/to/server",
          "args": [],
          "env": {}
        }
      }
    }
 
    ```### HTTP 服务器配置
 
    {
    "mcpServers": {
    "api-server": {
    "type": "http",
    "url": "https://api.example.com/mcp",
    "headers": {
    "Authorization": "Bearer ${API_KEY}"
    }
    }
    }
    }

    {
      "mcpServers": {
        "database-tools": {
          "command": "npx",
          "args": ["-y", "@bytebase/dbhub"],
          "env": {
            "DB_URL": "${DB_URL:-postgresql://localhost/db}"
          }
        }
      }
    }
 
    ```### 环境变量扩展
 
    Claude Code 支持 `.mcp.json` 文件中的环境变量扩展：
 
    > **支持的语法**:
    > - `$`{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 在使用来自 `.mcp.json` 文件的项目范围服务器之前会提示批准。
 
    ### 重置批准选择
 
    如果需要重置这些批准选择：
 
    ~~~bash
 
    ```bash
 
    claude mcp reset-project-choices
 
    ```## 用户范围
 
    ### 概述
 
    用户范围的服务器提供跨项目可访问性，使其在您计算机上的所有项目中可用，同时对您的用户帐户保持私密。
 
    ### 适用场景
 
    > - 个人实用程序服务器
    > - 开发工具
    > - 在不同项目中经常使用的服务
    > - 个人工作流自动化
 
    ### 添加用户范围服务器
 
    claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic
 
    ### 存储位置
 
    用户范围的服务器配置存储在：
 
    ```> ~/.claude/mcp.json

 
    ### 查看有效配置
 
bash

 
    ### 场景示例
    #### 场景 1: 个人实验
    ~~~bash
```bash
 
    # 本地范围
    claude mcp add --transport http experimental https://api.example.com/experimental
 
    ```#### 场景 2: 团队数据库
 
    # 项目范围
    claude mcp add --transport stdio db --scope project \
    --env DB_URL=${DB_URL} \
    -- npx -y @bytebase/dbhub
 
    #### 场景 3: 个人工具
 
    ~~~bash
 
    ```bash
 
    # 用户范围
 
    claude mcp add --transport stdio formatter --scope user \
      -- npx -y @my/formatter
 
    ```## 最佳实践
 
    ### 1. 敏感凭证使用本地范围
 
    # 包含 API 密钥的配置
    claude mcp add --transport http private-api --scope local \
    https://api.example.com/mcp \
    --header "Authorization: Bearer your-secret-key"
 
    ### 2. 团队共享使用项目范围
 
    ~~~bash
 
    ```bash
 
    # 团队共享的数据库配置
    claude mcp add --transport stdio team-db --scope project \
      --env DB_URL=$`{TEAM_DB_URL}` \
      -- npx -y @bytebase/dbhub
 
    ```### 3. 个人工具使用用户范围
 
    # 个人开发工具
 
    claude mcp add --transport stdio my-tools --scope user \
    -- npx -y @my/tools
 
    ### 4. 使用环境变量
 
    ~~~json
 
    ```json
 
    {
      "mcpServers": {
        "api-server": {
          "type": "http",
          "url": "${API_BASE_URL:-https://api.example.com}/mcp",
          "headers": {
            "Authorization": "Bearer $`{API_KEY}`"
          }
        }
      }
    }
 
    ```## 迁移配置
 
    ### 从本地迁移到项目
 
    # 1. 查看本地配置
    claude mcp get my-server
    # 2. 添加到项目范围
    claude mcp add --transport http my-server --scope project <url>
    # 3. 删除本地配置
    claude mcp remove my-server
 
    ### 从用户迁移到项目
 
    ~~~bash
 
    ```bash
 
    # 1. 查看用户配置
    claude mcp get my-server
 
    # 2. 添加到项目范围
```bash
    claude mcp add --transport http my-server --scope project <url>