Skip to content

Cursor 接入

Cursor 是基于 VS Code 的 AI 编辑器,0.45+ 原生支持 MCP(含远程 HTTP)。本页演示如何让 Cursor Composer / Chat 直接调用 Keepamore 的 Keepa 工具。

一、安装 Cursor

  1. 下载 Cursor(Windows / macOS / Linux)
  2. 启动后登录账号;订阅任意付费档以使用 Claude/GPT 等强模型(免费档也能用 cursor-small,但工具调用稳定性差)
Cursor 主界面

二、配置 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

打开 MCP 设置

填入:

json
{
  "mcpServers": {
    "keepamore": {
      "url": "https://mcp.keepamore.com/mcp",
      "headers": {
        "X-API-Key": "km_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

保存后回到设置页,Keepamore 那一栏圆点应变为绿色,并显示 13 tools enabled

启用 MCP

如果你只想在某个工程里启用,把同样的 JSON 放进项目根目录的 .cursor/mcp.json 即可(覆盖优先级高于全局)。

三、配置 AI 模型

Cursor 内置 Claude / GPT / Gemini / cursor-small 等,无需自配 Key(用 Cursor 订阅)。如果你想用自带的 OpenAI / Anthropic Key:

  1. Settings → Models → 打开 Override OpenAI Base URLAnthropic API Key
  2. 填入自己的 Key 并 Verify

推荐选 Claude 3.5 Sonnet / Claude Opus 4 / GPT-4.1,工具调用最稳。

四、配置 Keepa 数据分析师 Rules

Cursor 通过 Rules(旧名 .cursorrules)实现持久化 system prompt:

  1. 项目根目录新建 .cursor/rules/keepamore-keepa.mdc,内容:
mdc
---
description: Keepamore Keepa 数据分析助手规则
alwaysApply: true
---

(这里粘贴 prompt.md 里的完整 Keepa 数据分析师 prompt)
  1. 或者全局 Rules:Settings → Rules → User Rules 直接粘贴整段 prompt

参考 Keepa 数据分析师 prompt

配置 Rules

五、开始对话

在 Cursor 右侧 Chat / Composer 面板:

  1. 顶部模型选 Claude 3.5 Sonnet(或 GPT-4.1)
  2. 输入:
@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 / 403Key 错误重新复制带 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 官方文档


下一步:Cline 接入 · Codex 接入