添加远程 MCP

在兼容客户端中添加以下 Streamable HTTP 地址：

https://ecommercedataapi.com/mcp

该地址提供 49 个工具：45 个独立业务工具与原有 4 个通用工具， 并保留 1 个 MCP Prompt：ecommerce-data-api。 业务工具包括 amazon_asin_detail、amazon_asin_competitor；OCR 文件上传暂时只走 REST。

WorkBuddy：首选浏览器 OAuth

按 WorkBuddy 配置步骤接入。 配置只需 type: "http" 和 url，不要填写 Authorization、Client ID 或 Client Secret。 兼容客户端会自动打开浏览器，完成登录与授权。

在授权页选择现有有效 Key 并确认，或明确点击创建并授权。 只有一把现有 Key 时默认选中，但仍需确认。Key 原文不会交给 WorkBuddy。

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

在 ChatGPT 网页端添加

1. 打开 ChatGPT 网页设置并启用 Developer mode（开发者模式）。
2. 添加远程 MCP 服务器，填入上面的地址，选择 OAuth 身份验证。
3. 登录 Ecommerce Data API。
4. 选择现有 Key 并确认，或明确创建并授权一把 Key。单 Key 默认选中后仍需确认。
5. 返回 ChatGPT，新建对话。
6. 发送：“使用 ecommerce_account 查询我的剩余积分，暂时不要调用付费数据接口。”

OAuth 连接绑定账号、所选 Key ID 和当前凭据指纹，不向客户端发送 API Key 原文。

工具与 Prompt

连接后确认列表中能看到 amazon_asin_detail 等独立工具。 需要付费查询时，可以请求 Amazon 美国站 ASIN B08CK5Z5Q1 的价格和评分。 原有 ecommerce_api_search、ecommerce_api_describe、 ecommerce_api_call、ecommerce_account 继续保留。

ecommerce-data-api Prompt 的标题为 Ecommerce Data API，可选 task 参数最多 4,000 个字符。选择模板只加载指引，不查询数据、不扣积分。斜杠菜单是否显示由客户端决定， 直接用自然语言调用工具不依赖 Prompt。

计费与访问权限

MCP 与 REST 共用账号余额。每次数据查询按 API 目录扣除积分，一次聊天可能触发多次查询。 多把 Key 共享余额，不提供 Key 级独立权限、预算或限流。

重置、删除或过期所选 Key 后，访问会失效。OAuth 切换 Key 需要重新授权。 撤销 MCP 连接不会删除或禁用 REST Key，也不会阻止使用该 Key 直连。 需要停止直连时，请重置或删除 Key。失败的付费请求不会自动重试扣费。

备用方式与常见问题

• **只有 Bearer Token 输入框：**可使用有效 API Key 作为备用方式。客户端发送 Authorization: Bearer <api-key> 并保存密钥原文，不打开浏览器 OAuth。不要把 Key 放进 URL。
• 授权时没有可选 Key：明确点击创建并授权；仅打开页面不会自动创建 Key。
• **OAuth 失败：**确认支持 Streamable HTTP、OAuth 2.1 和 PKCE S256。 在客户端检查回调和连接状态；协议兼容不代表客户端授权流程已实测通过。
• **没有工具：**重连、新建对话并检查服务器状态。
• **余额不足：**补充积分后重试，系统不会自动重试付费请求。

本地 stdio 仍使用 API Key 配置，不是 OAuth。新版工具需要 CLI 0.2.2 或更新版本。 Hermes、WorkBuddy、Claude Code 的配置见多平台接入指南。