远程 MCP
发现 Ecommerce Data API 的 49 个工具，通过浏览器 OAuth 接入，也可使用 API Key 直连备用方式。
远程 MCP
同一个地址 https://ecommercedataapi.com/mcp 提供 49 个工具：
45 个独立业务工具与原有 4 个通用工具，并保留 1 个 MCP Prompt。
传输方式为 Streamable HTTP。WorkBuddy 等兼容客户端首选浏览器 OAuth，
也保留 API Key 直连方式。
可复制的配置和连接检查见 WorkBuddy 配置步骤。
工具与 Prompt
业务工具会在 MCP 工具列表中逐项展示。名称从规范 API URL 派生，可以直接选择具体业务：
| 工具 | 对应 REST 接口 |
|---|---|
amazon_asin_detail | POST /v1/amazon/asin/detail |
amazon_asin_competitor | POST /v1/amazon/asin/competitor |
每个业务工具都有独立的输入 schema，请按客户端展示的参数填写；完整业务说明见 API 目录。OCR 文件上传暂时只通过 REST 使用，不计入这 45 个业务工具。
原有通用工具继续保留，已有工作流仍可使用：
| 工具 | 用途 |
|---|---|
ecommerce_api_search | 搜索 API 目录 |
ecommerce_api_describe | 查看接口说明和参数 |
ecommerce_api_call | 按接口 code 和 input 调用 |
ecommerce_account | 查询账户积分 |
例如：“使用 amazon_asin_detail 查询 Amazon 美国站 ASIN B08CK5Z5Q1 的价格和评分。”
这是一次需要计费的数据查询。
保留的 MCP Prompt 名称为 ecommerce-data-api，标题为 Ecommerce Data API。
可选的 task 参数最多 4,000 个字符。选择模板只加载操作指引，不会查询数据或扣积分。
是否显示在斜杠菜单中由客户端决定；不选择 Prompt 也能用自然语言调用工具。
通过浏览器 OAuth 接入
- 使用生产地址添加 HTTP / Streamable HTTP MCP 服务。WorkBuddy 配置只需
type: "http"和url，不填写Authorization、Client ID 或 Client Secret。 - 兼容客户端会自动打开浏览器授权，登录 Ecommerce Data API。
- 选择现有有效 API Key 并确认授权，或在授权页明确点击创建并授权。
- 只有一把现有 Key 时会默认选中，但仍需确认。完成授权后返回客户端。
OAuth 不会将 API Key 原文交给客户端。可在 MCP 设置查看或撤销连接。
如果 WorkBuddy 旧配置含固定 Authorization 请求头，只删除本服务的该请求头后重新连接；
必要时仅清除此连接的旧授权缓存。保留其他 MCP 服务配置。
计费与密钥生命周期
MCP 和 REST 共用账户余额。每次数据调用按 API 目录消耗积分，一次聊天可能触发多次 付费查询。多把 API Key 共享余额，不提供 Key 级独立预算、权限或限流。
重置、删除或过期选中的 Key 后，访问会失效。OAuth 切换 Key 需要重新授权。 撤销 MCP 连接不会删除或禁用 REST API Key，也不会阻止 API Key 直连； 需要停止直连访问时，请重置或删除该 Key。失败的付费请求不会自动重试扣费。
其他接入方式
API Key 直连使用 Authorization: Bearer <api-key>，客户端会保存密钥，不启动浏览器 OAuth。
不要把 Key 写入 URL。
本地 stdio 仍使用 API Key，不会变成 OAuth 连接。新版工具列表需要 CLI 0.2.2
或更新版本，配置见多平台接入指南。
OAuth 客户端需支持 OAuth 2.1 与 PKCE S256。连接会针对 Ecommerce Data API MCP 资源
请求 ecommerce:tools offline_access。