> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metamcp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop 集成

> 使用 mcp-proxy 配置 Claude Desktop 连接到 MetaMCP 端点

**Claude Desktop** 集成允许您直接通过 Claude 的界面访问 MetaMCP 工具。由于 Claude Desktop 只支持 stdio 服务器，您需要一个本地代理来连接到 MetaMCP 的远程端点。

## 前置要求

在开始之前，请确保您拥有：

* **Claude Desktop** 已安装并运行
* **MetaMCP** 本地运行或已部署
* **活动端点**在 MetaMCP 中配置
* **API 密钥**已生成（如果启用了身份验证）

## 基本配置

### 使用 mcp-proxy（推荐）

由于 MetaMCP 端点仅是远程的（SSE、可流式 HTTP），Claude Desktop 需要一个本地代理来连接。根据测试，`mcp-proxy` 是 API 密钥身份验证的推荐解决方案。

<CodeGroup>
  ```json 可流式 HTTP（推荐） theme={null}
  {
    "mcpServers": {
      "MetaMCP": {
        "command": "uvx",
        "args": [
          "mcp-proxy",
          "--transport",
          "streamablehttp",
          "http://localhost:12008/metamcp/your-endpoint-name/mcp"
        ],
        "env": {
          "API_ACCESS_TOKEN": "sk_mt_your_api_key_here"
        }
      }
    }
  }
  ```

  ```json SSE（替代） theme={null}
  {
    "mcpServers": {
      "MetaMCP": {
        "command": "uvx",
        "args": [
          "mcp-proxy",
          "http://localhost:12008/metamcp/your-endpoint-name/sse"
        ],
        "env": {
          "API_ACCESS_TOKEN": "sk_mt_your_api_key_here"
        }
      }
    }
  }
  ```

  ```json 多个端点 theme={null}
  {
    "mcpServers": {
      "MetaMCP-Dev": {
        "command": "uvx",
        "args": [
          "mcp-proxy",
          "--transport",
          "streamablehttp",
          "http://localhost:12008/metamcp/dev-tools/mcp"
        ],
        "env": {
          "API_ACCESS_TOKEN": "sk_mt_dev_key"
        }
      },
      "MetaMCP-Research": {
        "command": "uvx",
        "args": [
          "mcp-proxy",
          "http://localhost:12008/metamcp/research-tools/sse"
        ],
        "env": {
          "API_ACCESS_TOKEN": "sk_mt_research_key"
        }
      }
    }
  }
  ```
</CodeGroup>

## 配置文件位置

编辑 Claude Desktop 的配置文件：

* **macOS**：`~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**：`%APPDATA%\Claude\claude_desktop_config.json`
* **Linux**：`~/.config/claude/claude_desktop_config.json`

## 身份验证方法

<AccordionGroup>
  <Accordion icon="key" title="API 密钥身份验证">
    **最常见方法**使用环境变量：

    ```json theme={null}
    {
      "mcpServers": {
        "MetaMCP": {
          "command": "uvx",
          "args": [
            "mcp-proxy",
            "--transport",
            "streamablehttp",
            "http://localhost:12008/metamcp/your-endpoint-name/mcp"
          ],
          "env": {
            "API_ACCESS_TOKEN": "sk_mt_your_key_here"
          }
        }
      }
    }
    ```
  </Accordion>

  <Accordion icon="shield-minus" title="无身份验证">
    **对于没有身份验证的公共端点**：

    ```json theme={null}
    {
      "mcpServers": {
        "MetaMCP": {
          "command": "uvx",
          "args": [
            "mcp-proxy",
            "http://localhost:12008/metamcp/public-tools/sse"
          ]
        }
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## 远程/生产设置

对于远程 MetaMCP 实例，只需替换 localhost URL：

```json theme={null}
{
  "mcpServers": {
    "MetaMCP-Production": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "--transport",
        "streamablehttp",
        "https://your-metamcp-domain.com/metamcp/your-endpoint-name/mcp"
      ],
      "env": {
        "API_ACCESS_TOKEN": "sk_mt_production_key"
      }
    }
  }
}
```

## 重要说明

* **替换** `your-endpoint-name` 为您的实际端点名称
* **替换** `sk_mt_your_api_key_here` 为您的 MetaMCP API 密钥
* **mcp-proxy** 处理 stdio 和 HTTP/SSE 之间的协议转换
* **环境变量**是传递 API 密钥的安全方式
* 有关详细故障排除，请参阅 [issue #76](https://github.com/metatool-ai/metamcp/issues/76)