主题
Cursor 接入
Cursor 是基于 VS Code 的 AI 编辑器,0.45+ 原生支持 MCP(含远程 HTTP)。本页演示如何让 Cursor Composer / Chat 直接调用 Keepamore 的 Keepa 工具。
一、安装 Cursor
- 下载 Cursor(Windows / macOS / Linux)
- 启动后登录账号;订阅任意付费档以使用 Claude/GPT 等强模型(免费档也能用 cursor-small,但工具调用稳定性差)

二、配置 Keepamore MCP
Cursor 的 MCP 配置文件位于:
| 系统 | 路径 |
|---|---|
| macOS / Linux | ~/.cursor/mcp.json |
| Windows | %USERPROFILE%\.cursor\mcp.json |
也可以从 GUI 进入:Settings (Ctrl/Cmd+,) → Cursor Settings → MCP → Add new global MCP server。

填入:
json
{
"mcpServers": {
"keepamore": {
"url": "https://mcp.keepamore.com/mcp",
"headers": {
"X-API-Key": "km_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}保存后回到设置页,Keepamore 那一栏圆点应变为绿色,并显示 13 tools enabled。

如果你只想在某个工程里启用,把同样的 JSON 放进项目根目录的
.cursor/mcp.json即可(覆盖优先级高于全局)。
三、配置 AI 模型
Cursor 内置 Claude / GPT / Gemini / cursor-small 等,无需自配 Key(用 Cursor 订阅)。如果你想用自带的 OpenAI / Anthropic Key:
- Settings → Models → 打开
Override OpenAI Base URL或Anthropic API Key - 填入自己的 Key 并 Verify
推荐选 Claude 3.5 Sonnet / Claude Opus 4 / GPT-4.1,工具调用最稳。
四、配置 Keepa 数据分析师 Rules
Cursor 通过 Rules(旧名 .cursorrules)实现持久化 system prompt:
- 项目根目录新建
.cursor/rules/keepamore-keepa.mdc,内容:
mdc
---
description: Keepamore Keepa 数据分析助手规则
alwaysApply: true
---
(这里粘贴 prompt.md 里的完整 Keepa 数据分析师 prompt)- 或者全局 Rules:Settings → Rules → User Rules 直接粘贴整段 prompt

五、开始对话
在 Cursor 右侧 Chat / Composer 面板:
- 顶部模型选 Claude 3.5 Sonnet(或 GPT-4.1)
- 输入:
@keepa_get_product 帮我看下 B0DGHYDZSX 最近 30 天的价格走势Cursor 会拦截工具调用并弹出 Run / Reject 确认按钮,点 Run 后返回结果。
或者不用 @,直接自然语言提问,Cursor 会自动选工具:
找一下美国站宠物类目里月销过 200、Buy Box 在 15–40 美元的产品
故障排查
| 现象 | 原因 | 处理 |
|---|---|---|
| 设置页 Keepamore 圆点橙色/红色 | URL 或 header 错 | 检查 mcp.json JSON 合法性,刷新 MCP 服务器 |
Composer 看不到工具 | Composer 旧版未启用 MCP | 升级到 Cursor 0.46+ 并启用 Composer Agent |
| 401 / 403 | Key 错误 | 重新复制带 km_ 前缀的完整 Key |
| 模型不主动调工具 | 选了 cursor-small / 模型太弱 | 切换到 Claude / GPT-4 系列 |
| 修改 mcp.json 后不生效 | Cursor 没热重载 | 设置页 → MCP → 点 Refresh 图标,或重启 Cursor |
进阶:把 prompt 拆成多个 Rule
如果你的 .cursor/rules/ 已经有大量项目规则,可以把 Keepa prompt 拆成两份:
keepamore-tools.mdc(始终生效,告诉 AI 怎么调工具)keepamore-style.mdc(按需触发,控制回复格式)
具体写法见 Cursor Rules 官方文档。