多平台 MCP 接入

生产 MCP 地址：

https://ecommercedataapi.com/mcp

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

最快方式：把 API Key 和本页链接一起发给 AI

如果你用的 Agent 能修改自己的 MCP 配置（如 WorkBuddy、Claude Code、Cursor、 Codex、Hermes），不必手动编辑配置文件。先在 API 密钥页面 复制完整 Key，把它填进下面的模板，再整段发给 AI。Key 和文档链接一次给全，AI 就能直接写好配置，不用中途再向你索要。

请帮我把 Ecommerce Data API 添加为 MCP 服务器，写入你当前客户端的 MCP 配置。
文档：https://ecommercedataapi.com/docs/mcp-platforms
我的 API Key：<在这里粘贴你的 API Key>

要求：
1. 按文档中的 API Key 直连方式配置：传输方式 Streamable HTTP，URL 为 https://ecommercedataapi.com/mcp，请求头 Authorization: Bearer <上面的 Key>（Bearer 与 Key 之间一个英文空格）。
2. 只新增名为 ecommerce-data-api 的服务器，保留已有的其他 MCP 配置；不要把 Key 写进 URL。
3. 回复中不要复述完整 Key。
4. 配置完成后告诉我是否需要重启或重新连接；连接成功后用 ecommerce_account 查询剩余积分，暂时不要调用付费数据接口。

Key 会留在这段对话记录里。建议为 AI 客户端单独创建一把 Key，不再使用时在 API 密钥页重置或删除。ChatGPT 网页端无法由 AI 修改配置，请按下方 OAuth 步骤连接。

应该选择哪种方式？

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

ChatGPT 网页端

以下截图展示中文界面的 OAuth 连接流程。插件名称可以自定义；图中的 ecommercedataapi 和 ecommercedataapi-1 都是示例名称，请选择自己创建的插件。 不同账户或版本的入口名称可能略有差异。

1. 打开 ChatGPT 插件设置 chatgpt.com/settings/plugins-settings， 把默认权限设为允许使用低风险工具。

   

2. 打开插件页 chatgpt.com/plugins，点击右上角添加， 选择添加自定义 MCP 服务器。

   

3. 填写名称，服务器 URL 输入 https://ecommercedataapi.com/mcp，身份验证选择 OAuth。 阅读风险提示，确认信任此服务器后勾选确认框，点击创建为插件。

   

4. 在 ChatGPT 的连接确认窗口阅读权限说明，点击继续连接到该插件。

   

5. 登录 Ecommerce Data API，在连接 MCP 客户端页面选择有效 API Key， 点击同意连接。只有一把 Key 时会默认选中，但仍需点击按钮才会授权； 没有可用 Key 时，按页面提示明确点击创建并授权。 MCP 与 API 共用账户积分余额。

   

6. 授权后返回 ChatGPT，在插件 → 个人 → 由你创建中找到该插件， 点击右侧 … → 立即试用，进入对话。

   

7. 在对话中选择或 @ 提及该插件，然后发送： 使用 ecommerce_account 查询我的剩余积分，暂时不要调用付费数据接口。 返回账户余额即说明此次额度查询成功。

   

截图中的 3,149 credits、Key 名称和有效期仅为示例，以你账户的实际返回为准。 余额查询成功后，可以继续尝试商品、关键词等数据查询；这些查询可能消耗积分。

OAuth 访问令牌默认有效期为 30 天，刷新令牌为 90 天；成功刷新时会轮换刷新令牌并重新计算有效期。支持刷新令牌的客户端可自动续期。 如果旧连接曾出现过期后断开，请在 ChatGPT 中重新创建该插件并完成授权， 以重新获取包含 offline_access 的配置和刷新权限。无需重置 API Key。

ChatGPT 客户端：插件页使用 API Key 直连

如果客户端显示设置 → 插件 → MCP 页面，也可以按以下步骤配置：

1. 点击添加 → 添加 MCP 服务器，类型选择流式 HTTP，名称填写 Ecommerce Data API。
2. URL 填写 https://ecommercedataapi.com/mcp。
3. 在标头中添加一行：键填 Authorization，值填 Bearer <你的 API Key>。Bearer 与 Key 之间保留一个英文空格；Bearer 令牌环境变量留空。
4. 点击保存并启用服务器。在新对话中发送上面的余额查询，确认 ecommerce_account 可用。

此方式会把 API Key 原文交给客户端保存，不会打开浏览器 OAuth。不要把 Key 放进 URL、截图或共享配置文件；需要停止直连时重置或删除该 Key。

Hermes

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

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

WorkBuddy

WorkBuddy 统一使用 API Key 直连。最省事的是用上方模板把 Key 和本页链接发给 WorkBuddy，让它自己写配置；也可以按以下步骤手动配置。

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

WorkBuddy API Key 直连备用方式

1. 在API 密钥页面创建密钥，或复制已有的完整密钥。
2. 将下方 YOUR_API_KEY 替换为你的密钥，Bearer 与密钥之间保留一个英文空格。
3. 保存配置，在 WorkBuddy 中启用或重新连接该 MCP 服务器。

{
  "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 Code 里安装插件，会同时装好这个 MCP 服务和 Agent Skill：

/plugin install ecommerce-data-api --marketplace ecommercedataapi/ecommerce-data-api

只加 MCP 服务：

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 配置指南。