多平台 MCP 接入

生产 MCP 地址：

https://ecommercedataapi.com/mcp

该 Streamable HTTP 地址提供 49 个工具：45 个独立业务工具与原有 4 个通用工具， 并保留 1 个 MCP Prompt。业务工具名称从规范 API URL 派生，例如 amazon_asin_detail、amazon_asin_competitor。OCR 文件上传暂时只走 REST。

应该选择哪种方式？

OAuth 客户端需要支持 OAuth 2.1 与 PKCE S256。只接受固定 Bearer Token 的客户端可以使用 API Key 直连备用方式。

ChatGPT 网页端

1. 打开 ChatGPT 设置并启用 Developer mode（开发者模式）。
2. 添加生产地址的远程 MCP 服务器并选择 OAuth。
3. 登录 Ecommerce Data API。
4. 选择有效 Key 并确认，或明确点击创建并授权。只有一把 Key 时默认选中， 但仍需确认。
5. 返回 ChatGPT，新建对话并发送： 使用 ecommerce_account 查询我的剩余积分，暂时不要调用付费数据接口。

Hermes

添加远程服务器，传输方式选择 Streamable HTTP，填入生产地址；客户端提供时 选择 OAuth / 浏览器授权。登录、选择或创建并授权 Key、确认授权，然后刷新连接。

如果 Hermes 只有固定 Bearer Token 输入框，使用下方 API Key 备用方式。 协议兼容不代表某个 Hermes 版本的 OAuth 流程已经完成客户端实测。

WorkBuddy

WorkBuddy 远程接入首选浏览器 OAuth。只需配置：

{
  "mcpServers": {
    "ecommerce-data-api": {
      "type": "http",
      "url": "https://ecommercedataapi.com/mcp"
    }
  }
}

不要添加 Authorization、Client ID 或 Client Secret。兼容客户端会自动打开浏览器 授权。登录后选择现有有效 Key 并确认，或明确点击创建并授权。只有一把 Key 时默认选中， 但仍需确认。Key 原文不会交给 WorkBuddy。

用户级配置为 ~/.workbuddy/mcp.json，Windows 为 %USERPROFILE%\\.workbuddy\\mcp.json；项目级配置为 .workbuddy/mcp.json。已有 mcpServers 时只添加本服务条目，不要覆盖其他 MCP。

旧 WorkBuddy 配置如果含固定 Authorization 请求头，不会触发 OAuth。只删除本服务的 该请求头后重连；必要时仅清除此连接的旧授权缓存，不要清理其他 MCP 缓存。

WorkBuddy API Key 直连备用方式

仅在客户端没有浏览器 OAuth 时使用：

{
  "mcpServers": {
    "ecommerce-data-api": {
      "type": "http",
      "url": "https://ecommercedataapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

不要把 Key 写进 URL 或文档；此方式会将密钥原文保存在客户端，也不会建立浏览器 OAuth 连接。

连接后确认列表中出现 amazon_asin_detail 等独立业务工具及 ecommerce_api_search、ecommerce_api_describe、ecommerce_api_call、 ecommerce_account。保留的 Prompt 名称为 ecommerce-data-api，标题为 Ecommerce Data API，可选 task 最多 4,000 个字符。选择模板只加载指引，不查询数据、 不扣积分。斜杠菜单显示由客户端决定，直接用自然语言调用仍可用。

Claude Code 远程 OAuth

claude mcp add --transport http ecommerce-data-api https://ecommercedataapi.com/mcp

打开 /mcp，选择浏览器授权，登录、选择或创建并授权 Key、确认后返回 Claude Code。

Claude Code 本地 stdio

本地安装器和 stdio 连接仍使用 API Key，不会变成 OAuth：

curl -fsSL https://ecommercedataapi.com/install.sh | bash -s -- --yes --only claude-code

在安装器的本机输入中填写 Key。使用 CLI 0.2.2 或更新版本，再运行 ecomdata doctor 和 ecomdata mcp status。远程 URL 用户无需安装 CLI。

计费与 Key 生命周期

MCP 与 REST 共用账户余额，一次聊天可能触发多次付费数据查询。Key 不提供独立预算、 权限或限流。重置、删除或过期所选 Key 后访问会失效；OAuth 切换 Key 需要重新授权。

撤销 MCP 连接不会删除或禁用 REST Key，也不会阻止 API Key 直连。要停止直连访问，请 重置或删除该 Key。失败的付费请求不会自动重试扣费。

WorkBuddy 入口可参考 官方连接器说明 和 MCP 配置指南。