接入 MCP

MCP（Model Context Protocol）是 AI 客户端调用外部工具的开放协议。MaxAEO 的 MCP 服务器把四个开放接口包装成工具，接入后你可以直接对 AI 助手说「帮我问问豆包和 DeepSeek 怎么回答这个问题，看看有没有引用我们官网」，由它完成提交、等待和读取结果。

项目	值
地址	`https://maxaeo.cn/geoapi/geodata/developer/mcp`
传输方式	Streamable HTTP（无状态，仅返回 JSON）
鉴权	请求头 `Authorization: Bearer <API Key>`
工具	`list_platforms`、`submit_task`、`get_task`、`list_tasks`，见 MCP 工具参考
计费与限流	与开放 API 完全一致：成功的任务扣点数，共用账户的余额与限流额度

准备 API Key

在开发者控制台 → API Key 页创建一个 Key，建议单独为 MCP 创建（如命名为「MCP - 我的电脑」），方便在用量统计里区分，也便于单独停用。见管理 API Key。

配置客户端

在终端执行：

claude mcp add --transport http maxaeo https://maxaeo.cn/geoapi/geodata/developer/mcp \
  --header "Authorization: Bearer $MAXAEO_API_KEY"

执行前先 export MAXAEO_API_KEY="gdev_…"。添加后运行 claude mcp list，看到 maxaeo 为已连接状态即可。

编辑 ~/.cursor/mcp.json（全局）或项目下的 .cursor/mcp.json：

{
  "mcpServers": {
    "maxaeo": {
      "url": "https://maxaeo.cn/geoapi/geodata/developer/mcp",
      "headers": {
        "Authorization": "Bearer gdev_你的完整Key"
      }
    }
  }
}

保存后在 Cursor 设置的 MCP 页面确认 maxaeo 已启用并列出 4 个工具。

在项目下创建 .vscode/mcp.json。用 inputs 在首次启动时输入 Key，避免把 Key 写进文件：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "maxaeo-api-key",
      "description": "MaxAEO API Key",
      "password": true
    }
  ],
  "servers": {
    "maxaeo": {
      "type": "http",
      "url": "https://maxaeo.cn/geoapi/geodata/developer/mcp",
      "headers": {
        "Authorization": "Bearer ${input:maxaeo-api-key}"
      }
    }
  }
}

然后在 Copilot Chat 的 Agent 模式中启用 maxaeo 的工具。

对只能启动本地命令的客户端（如 Claude Desktop 的配置文件方式），用 mcp-remote 把远程服务器桥接为本地进程（需要安装 Node.js）：

{
  "mcpServers": {
    "maxaeo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maxaeo.cn/geoapi/geodata/developer/mcp",
        "--header",
        "Authorization:${MAXAEO_AUTH}"
      ],
      "env": {
        "MAXAEO_AUTH": "Bearer gdev_你的完整Key"
      }
    }
  }
}

Authorization:${MAXAEO_AUTH} 中冒号后不留空格，空格放在环境变量的值里，可以避开部分客户端对参数中空格的处理问题。

Cherry Studio 等其他客户端：添加 MCP 服务器时，传输类型选择 Streamable HTTP（可流式传输的 HTTP），填写：

URL：https://maxaeo.cn/geoapi/geodata/developer/mcp
请求头：Authorization，值为 Bearer gdev_你的完整Key

只要客户端支持 Streamable HTTP 和自定义请求头，都可以用同样的方式接入。

验证连接

连接时服务器就会校验 Key：Key 无效时客户端会显示连接失败或未授权（HTTP 401）。连接成功后，可以对 AI 助手说：

列出 MaxAEO 支持的平台和单价。

助手会调用 list_platforms 并展示结果。这一步不消耗点数。

使用示例

接入后，直接用自然语言描述需求即可，例如：

「问一下豆包：适合程序员的机械键盘推荐。等结果出来后，列出它引用的网页。」
「把『国产项目管理工具哪个好用』分别发给 DeepSeek 和 Kimi，用 P2，比较两边推荐了哪些品牌。」
「开启思考模式问 DeepSeek 同一个问题，告诉我它这次实际有没有开启思考。」
「我刚才提交的任务结果丢了，帮我在今天的任务里按『机械键盘』找回来。」

服务器在连接时会向 AI 助手说明推荐的调用流程：先 list_platforms，再 submit_task，然后反复 get_task 直到任务结束；提交结果不明时先用 list_tasks 查找，不要重复提交。