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

前置要求

在开始之前,请确保您拥有:
  • Claude Desktop 已安装并运行
  • MetaMCP 本地运行或已部署
  • 活动端点在 MetaMCP 中配置
  • API 密钥已生成(如果启用了身份验证)

基本配置

使用 mcp-proxy(推荐)

由于 MetaMCP 端点仅是远程的(SSE、可流式 HTTP),Claude Desktop 需要一个本地代理来连接。根据测试,mcp-proxy 是 API 密钥身份验证的推荐解决方案。
{
  "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"
      }
    }
  }
}

配置文件位置

编辑 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

身份验证方法

远程/生产设置

对于远程 MetaMCP 实例,只需替换 localhost URL:
{
  "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