快速开始

三分钟在主流 MCP 客户端里用上 Keepamore。本页是总览 + 通用验证，详细的图文步骤请进 客户端接入分区 选择对应客户端。

前置条件

• 已注册 Keepamore 账号
• 已在api/mcp页面/keepamore-api购买api/mcp套餐（通用套餐或闲时套餐）
• 已复制 API Key（km_ 开头的 35 位字符串）——如忘记，前往 API Key 页"重置"重新获取

连接信息

Endpoint:  https://mcp.keepamore.com/mcp
Transport: Streamable HTTP（MCP 1.0）
Header:    X-API-Key: km_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

三步上手

1. 选客户端：进 客户端接入，按你的常用工具选一个：
   • 对话类：Chatbox · Cherry Studio · Claude Desktop
   • 编辑器：Cursor · Cline · Codex
   • Agent 平台：扣子 Coze · Refly AI
2. 配 MCP：照对应客户端教程填 URL + X-API-Key 头
3. 配助手提示词（可选但强烈推荐）：复制 Keepa 数据分析师 prompt 到客户端的助手 / Rules / Custom Instructions 中

验证是否成功

任选下面一个方式：

方式 A：客户端内调用

在对话中对 AI 说：

"调用 keepa_get_quota 查一下我的账号额度。"

如果返回套餐与剩余 units 信息，说明接入成功。

方式 B：curl 直接打 HTTP

curl -X POST https://mcp.keepamore.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: km_xxx" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

预期响应中包含 15 个 keepa_* 工具的 JSON schema。

故障排查

症状	可能原因	解决
401 缺少 API Key	客户端没带 Header	检查 X-API-Key 是否拼写正确、是否真的被发出
403 Key 无效	Key 已被重置/吊销	到主站重新获取
429 QUOTA_NO_SUBSCRIPTION	账号未购买套餐	前往主站购买
连不上 / 超时	网络或客户端不支持 Streamable HTTP	换一个支持 MCP 1.0 Streamable HTTP 的客户端
返回 empty reply	调用的是大接口（如 lightningdeal 全量）	已在服务端设置 120s idle timeout；若仍超时请缩小查询范围

---

下一步：选客户端开始接入 · MCP 协议细节 · 工具参考