Claude Code 接入实时 Amazon 数据完全指南（MCP）

1. 定义：Claude Code 是终端里的 agent

“Claude” 是 Anthropic 的 AI 接口家族，但本指南的主角是其中鉴权面最完整的一个：Claude Code——运行于终端的 agent 化编程工具。它的 --header 参数让 API key 的供给显式、可验证；Claude Desktop（桌面应用）与 claude.ai（网页客户端）作为备选路径在第 3 节对照。三者都讲 MCP，差别只在凭证怎么交到端点手里。

这是本指南的 operative 事实。Pangolinfo MCP 服务器只暴露一个端点——https://mcp.pangolinfo.com/mcp，一种鉴权方式：以 Authorization: Bearer 请求头携带 API key。端点上挂着 20 个工具（19 个数据工具加免费的自检工具 pangolinfo_capabilities）。Claude Code 用一条命令把 key 送进请求头；Desktop 用配置文件；网页连接器用对话框——能交进去的，就走通；交不进去的，就换条路。

因此接入问题不是”Claude 是否支持 MCP”——三个客户端都支持——而是你的客户端暴露了哪种鉴权面，以及当它没有暴露你需要的那一种时该怎么办。Pangolinfo 官网产品页在 “One Config · Works With Any MCP-Compatible AI Tool” 口径下把 Claude Code 列为已连接客户端：端点按设计是客户端无关的，摩擦如果存在，只存在于客户端一侧。

2. 论证：电商 Agent 不能做瞎子将军

先讲清楚背景。越来越多的电商公司把 Agent 接进日常经营：选品团队让 Agent 扫类目、算需求、排机会；运营让 Agent 盯评论、挖差评、预警口碑翻转；广告和定价团队让 Agent 跟踪竞品价格与 Buy Box 变化——输出结论，甚至直接参与运营动作：调价、补货、关广告。这些决策的共同点是：它们都发生在真实世界的 Amazon 之上，需要海量、实时、可验证的数据做燃料。没有数据的 Agent，就像没有侦察的将军：命令下得越果断，错得越离谱。

AI agent 的参数化知识——即训练中”学到”的内容——在这种场景下有三个结构性局限：时间冻结、无计数、无出处。它不知道昨天发生了什么，数不清”多少”，也给不出处。

Claude Code 把赌注抬得更高。它不只回答问题，还产出制品——脚本、报告、看板、定时监测任务——下游决策直接在这些制品上执行。聊天里的无根据断言是一句坏话；写进生成的脚本或定时报告里的同一断言，是一个坏系统。幻觉的成本随 agent 的能动性放大，而 Claude Code 的能动性高于聊天窗口。

看对照组。向一个没有数据连接的 Claude 提问：”AirPods Pro 3 的差评主要集中在哪些方面？”其典型回答只能给出看似合理的主题——降噪、佩戴、价格——但没有数字、没有时间、没有 verified purchase 标记。更严重的是存在代际污染风险：旧款 AirPods Pro 2 的记忆可能混入关于 Pro 3 的回答，而输出中没有任何机制让读者察觉这种替换。

论证于是成立：对商业问题而言，未接地（ungrounded）的 agent 的缺陷不在文采，而在可验证性。没有数字、时间戳或来源的主张不是发现，而是穿着发现外衣的假设。本指南的剩余部分，就是把假设替换为测量的操作步骤。

3. 三条路径对照：同一个端点，三种鉴权面

本篇的核心洞察：同一个 MCP 端点呈现三种不同的鉴权面，诚实的指南应当绕开窄的那个，而不是硬闯。这是与本系列Meta Muse 篇的关键差异：Muse 篇的自定义连接器安全凭证流完整接受了 Bearer key（2026-10-12 由我们团队在 Muse 客户端内走通）。而在 Claude 这一侧，网页连接器的鉴权面窄于端点所接受的范围——因此推荐路径是 CLI，在那里请求头被显式、可验证地传入。

两条套餐事实，如实陈述：免费计划允许 1 个自定义连接器；Pro / Max / Team / Enterprise 允许更多。网页端添加的连接器在同一账号下 Desktop 与移动端通用。菜单名称与套餐细节请以当前 Anthropic 帮助中心为准。

4. 三步走通：从注册到 Claude 调通

4.1 注册 Pangolinfo

打开 pangolinfo.com 首页，点击 “Start Free Trial”，跳转 tool.pangolinfo.com 完成注册。新账号即带免费档：每月 60 credits（按月重置）——本指南的全部实测只消耗个位数点数，免费额度足够跑通。

4.2 获取 API key

登录 tool.pangolinfo.com 控制台，在 API Key 页面复制你的 key。请使用长期 key（短期 key 过期会导致连接静默失效），并按环境独立签发。注意：永远不要把 key 粘贴进可能被分享或记录的聊天文本。

4.3 在 Claude 里接入

路径 1——Claude Code。在终端中，先导出上一步复制的 key，然后执行：

claude mcp add --transport http pangolinfo \
  https://mcp.pangolinfo.com/mcp \
  --header "Authorization: Bearer $PANGOLINFO_API_KEY"

用 claude mcp list 确认，再问 Claude Code 一句：”用 search_amazon 搜一下 wireless earbuds”。看到返回真实 ASIN 列表即为调通。

路径 2——Claude Desktop。在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "pangolinfo": {
      "url": "https://mcp.pangolinfo.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

重启 Claude Desktop。若你的 Desktop 版本不支持直接填写带请求头的远程 URL，可经 mcp-remote 桥接，在每次请求上注入 Authorization 头。

路径 3——claude.ai（带第 3 节的 caveat）。设置 → Customize → Connectors → Add custom connector → 粘贴 https://mcp.pangolinfo.com/mcp。仅当你的套餐/UI 提供自定义请求头字段时继续，在其中填写 Authorization: Bearer <key>。若无此字段，不要硬走这条路——改用路径 1 或 2。

验证状态，诚实声明。MCP 端点、20 个工具清单与第 5 节的全部调用，均于 2026-10-12 对 https://mcp.pangolinfo.com/mcp 经 MCP 协议直接真实执行。Claude Code 的 --header 写法经多家 MCP 服务商文档交叉核实；Desktop 配置为标准 MCP 客户端写法。两条客户端路径均未由我们团队在 Claude 客户端内端到端执行——但它们连接的端点行为与实测完全一致。

4.4 备选路径：Amazon Scraper Skill

如果你的 agent 住在开发环境（OpenClaw 或兼容的 Agent IDE），也可以走 Skill 形态：从 ClawHub 一键将Amazon Scraper Skill挂载进工作区，amzProductDetail / amzReview / amzBestSellers 三个引擎分别对应商品详情、评论与榜单抓取。背后是同一套 Pangolinfo 数据能力，差别只在接入面。

5. 对照实测：同一提示词，两种数据条件

测试协议（实测 2026-10-12）。以下调用均于 2026 年 10 月 12 日对 https://mcp.pangolinfo.com/mcp 真实执行，经由第 4 节已验证的端点。协议总耗 11 点，每月 60 credits 免费额度内。

步骤 1——发现（1 点）。search_amazon {"keyword":"wireless earbuds","site":"amz_us","page":1} 返回 5 条真实结果。测试目标：ASIN B0FQFB8FMG，Apple AirPods Pro 3。

步骤 2——投诉挖掘（5 点/页）。get_amazon_reviews {"asin":"B0FQFB8FMG","site":"amz_us","pageCount":1,"filterByStar":"critical","sortBy":"helpful"} 返回 4,269 条评论中的 1,392 条差评，最新评论日期为 2026 年 10 月 10 日——距测试仅两天，证明数据是实时的，而非缓存的历史快照。按 helpful 排序，差评主题集中为：

• 低频降噪差（空调与引擎轰鸣声漏进来）；
• 约 3 个月左右出现故障；
• 与 iPhone 配对困难；
• 与 iPad 7 功能不兼容；
• 电池与 Find My 相关问题。

每条评论均携带 verified purchase 标记与 helpful 票数——正是无数据对照组所缺失的出处标记。

对照组（无数据）。同一提示词仅凭参数化知识回答：只有主题名称，没有计数、没有日期、没有验证，且存在第 2 节所述的 Pro 2 代际污染的结构性风险。

推论。两种回答的差异不在文字质量，而在证据地位。有数据支撑的回答中，每一个实质主张都可核查：一个计数（4,269 条中的 1,392 条差评）、一个时间戳（2026-10-10）、一个购买标记。这就是”接地”（grounding）的全部内容：把断言替换为测量。

6. 成本与安全

MCP 调用按成功调用次数计费，点数标准与对应 REST API 端点一致——评论按页计费（当前定价每页 5 点），商品数据每页 1 点；免费档每月 60 credits（按月重置）。凭证以 Bearer 请求头传输；切勿把 API key 粘贴进可能被分享或记录的对话文本。纯只读研究场景下，首次使用点一次 allow 即可；建议按成员或环境签发独立 key，隔离用量。

7. FAQ

免费 API key 够跑通本教程吗？够。注册即得免费档：每月 60 credits（按月重置）；本指南的完整实测链路（search_amazon 发现 ASIN → get_amazon_reviews 抓评论 → critical 过滤挖投诉）共耗 11 点。跑通之后再决定是否升级付费档。

我在 claude.ai 上加了连接器但鉴权失败，怎么办？这是路径 3 的预期失败模式：网页端自定义连接器面向 OAuth 流程，静态 Bearer token 官方尚不支持。若你的套餐/UI 提供自定义请求头字段，在其中填写 Authorization: Bearer <key>；否则切换到 Claude Code 的 CLI 路径（路径 1），在那里请求头被显式传入。

claude.ai、Desktop、移动端的连接器互通吗？网页端添加的连接器在同一账号下 Desktop 与移动端通用。Claude Code 的连接只存在于执行 CLI 命令的那台机器本地。

我的 API key 在这些流程中安全吗？Key 以 Authorization: Bearer 请求头传输——经 CLI 参数、Desktop 配置文件或连接器的请求头字段——从不粘贴进聊天文本。请使用长期 key（短期 key 过期会导致集成静默失效），并按环境轮换。

本指南的哪些部分经过实际验证？MCP 端点、20 个工具清单与第 5 节全部调用均于 2026-10-12 真实执行。Claude Code 命令写法经多家 MCP 服务商文档交叉核实；Desktop 配置为标准 MCP 客户端写法。客户端侧菜单名称请以当前 Anthropic 帮助中心为准。

8. 系列导航

本指南是系列《AI Agent 接入实时 Amazon 数据完全指南（总纲）》的子篇。各篇：

• Meta Muse 篇——自定义 MCP 连接器，在 Muse 客户端内实测走通。
• Claude 篇——本篇：Claude Code、Desktop、网页端三条路径对照与鉴权面拆解。
• ChatGPT 篇——本系列下一篇：开发者模式自定义连接器、Token 鉴权、Custom GPT Actions 对照、会话边界说明。
• 腾讯 Workbuddy 篇——开放平台与 Skill 生态，国内版与国际版。即将推出。
• IDE agent 篇——编辑器内的 MCP 与 skill。即将推出。
• n8n / Make 篇——持续监测的定时 REST 工作流。即将推出。

每篇子文章复用同一套 AirPods Pro 3 第一次测试协议，跨 agent 的结果可比。

9. 相关阅读

• Amazon Data MCP——本指南接入 Claude 的完整 19 工具服务器
• Amazon Review API——MCP 评论工具背后的评论数据引擎
• Amazon Scraper Skill——Agent IDE / OpenClaw 环境的 Skill 形态接入
• Amazon Scraper API——面向批量与流水线作业的 REST 入口