MCP 文档
常见问题
Pangolinfo MCP 接入、配置、鉴权、排错常见问题 — MCP 和 REST API 区别 / 工具列表为空 / 401 鉴权失败 / 切换 API Key 等。
是同一份数据，只是给不同场景准备的两种接入方式。
| 维度 | 🌟 MCP（远程 HTTP） | 🛠 REST API |
|---|---|---|
| 使用场景 | 在 AI Agent 对话里直接调 | 写脚本 / CI / 自动化批跑 |
| 接入成本 | 配一份 URL + Key | 每个脚本写 HTTP 客户端 |
| 响应形态 | AI 友好的结构化对象 | 标准 REST JSON |
| 凭证管理 | 客户端配置一次 | 每个项目各自塞 Key |
| 网络要求 | 必须能访问 mcp.pangolinfo.com | 必须能访问 api.pangolinfo.com |
简单原则：日常对话/选品/排查 → MCP；批量自动化 → REST API。 都用同一个 API Key、同一组计费体系。
按以下顺序排查：
- 客户端真的重启了吗 — 大多数客户端 reload 配置不会重连 MCP，必须完整退出进程后重启。
- URL 拼写 — 必须是
https://mcp.pangolinfo.com/mcp（注意末尾的/mcp路径，不能省略）。 - 字段名对不对 — 不同客户端字段不同（
url/serverUrl/endpoint/transportType），参考 客户端适配 对应客户端的模板。 - transport 类型 — Claude Code 需要
"type": "http"，Cline 需要"transportType": "streamableHttp"，不写会按本地 stdio 解析失败。 - 配置文件位置 — 项目级配置会覆盖全局；确认你改的是当前生效的那份。
- 客户端日志 — 大多数客户端有 MCP 调试日志（Cursor 在 Output → MCP 面板，Claude Code 在
~/.claude/logs/），看具体报错信息。
- 检查是否长期 Key：临时 Token 有效期仅 7 天或 14 天，到期会 401。回 Pangolinfo 控制台 → 个人中心 → API Key 取长期 Key（Permanent Token）。
- 检查 Header 格式：必须是
Authorization: Bearer <YOUR_API_KEY>，注意Bearer和 Key 之间有一个空格，Key 前后没有引号。 - 检查 Key 是否已禁用：账号被冻结、Key 被你或同事在控制台撤销，都会导致 401。
- 检查账号余额：积点为 0 也会拒绝鉴权，先充值或开通订阅。
- AI 拼错工具名：让 AI 先调
list_tools()拿最新名单，然后再点名调用。 - 客户端缓存了旧 schema：重启客户端 + Refresh MCP 面板。
- Pangolinfo 临时下线了某个工具：我们偶尔会因数据源故障下线个别工具（一般几小时内恢复），重新
list_tools()会反映最新状态。
推荐做法：
- 每人一把长期 Key：在 Pangolinfo 控制台 给每个团队成员生成独立的长期 Key（用量、计费分人统计）。
- 配置存放位置：让成员把 Key 写在 用户级 配置文件里（
~/.cursor/mcp.json、~/.claude.json），不要写进项目根的.mcp.json然后提交到 Git。 - 如果必须项目级共享：把项目级
.mcp.json加进.gitignore，提交一份.mcp.example.json占位即可。 - 撤销 Key：成员离职后在控制台直接撤销对应 Key，该 Key 立即失效，不影响其他人。
- 走公司代理：大部分客户端会读
HTTPS_PROXY环境变量。在启动 AI 客户端的终端里export HTTPS_PROXY=http://your-proxy:port即可。 - 检查 DNS 污染：
nslookup mcp.pangolinfo.com看是否能解析到正常 IP。 - 切到 REST API：如果远程 MCP 完全无法接入，但
api.pangolinfo.com能通，可临时改用 REST API 自己写脚本调用。 - 联系我们：企业内网完全隔离的客户，可在 Pangolinfo 控制台 提交工单咨询专线接入。
完全一样——MCP 是 REST API 的语义包装，每次成功调用扣的积点与对应 REST 接口一致。各工具的积点成本见 Tool 参考。
用量查询：Pangolinfo 控制台 → 个人中心 → 用量统计，可按工具 / 时段 / API Key 维度查。
- 缩范围调用：让 AI 用更精准的参数（指定
page=1而不是抓全量评论）。 - 多轮串联：先取摘要字段，再按需深挖。例如先
search_amazon看搜索结果概览，再对感兴趣的 ASIN 跑get_amazon_product。 - 批量类工具分批：
map_batch_submit单次最多 100 条，超量会被截断，让 AI 分批调用。 - 客户端上下文窗口：如果是客户端模型自身上下文不够（不是 MCP 截断），换更大上下文窗口的模型。
- 可用性：MCP server 与 REST API 共享同一套基础设施，可用性按官方 SLA 承诺。
- 数据新鲜度：Amazon 商品 / 评论 / 搜索结果都是 实时抓取（每次调用都重新抓，不是缓存）；Google Trends 是 Google 官方延迟（约 24h）；WIPO 是官方库延迟（约周级）。
- 状态监控：如服务异常我们会在 Pangolinfo 控制台 顶部公告，也可订阅状态页邮件通知。
还没解决？
- 再翻一下 客户端适配 看对应客户端的字段细节
- 或直接在 Pangolinfo 控制台 提交工单，附上客户端 MCP 日志，我们一般 24h 内响应
在此页面