把 Storelift MCP 服务器添加到 Cursor

本指南的验证方式

Cursor 的文档：cursor.com。

版本

本指南介绍的是当前线上的服务器：npm 上的 storelift-mcp 1.1.1（2026-09-14）和托管端点 https://storelift.net/mcp，两者提供同样的 8 个工具：get_ai_visibility, get_charts, get_history, get_keywords, get_reviews, get_rivals, get_store_page, list_apps。

这个版本的工具全部是读取工具，不会改动你账号里的任何内容。本地服务器通过 stdio 响应，协议版本为 2024-11-05；托管端点通过 Streamable HTTP 响应，协议版本为 2025-06-18。端点是无状态的，没有会话 ID，也没有服务器推送的事件流。

前提条件

• 套餐：MCP 访问需要 Pro、Studio 或 Enterprise 套餐，用 API 密钥和用登录（OAuth）都一样。
• 密钥：Storelift → 设置 → API 密钥。密钥以 sl_live_ 开头。这个版本的密钥不带权限范围：一个密钥可以读取所在工作区的全部应用。只把它保存在客户端的配置里。
• 运行环境：本地服务器需要 Node.js 18 或更高版本（npx 会在首次运行时拉取这个包）。托管端点不需要安装任何东西。
• Cursor：编辑器和 Cursor CLI 读取同一个 mcp.json：项目内是 .cursor/mcp.json，对所有项目生效的是 ~/.cursor/mcp.json。

配置步骤

本地服务器，使用 API 密钥——把下面的内容加入 .cursor/mcp.json：

{
  "mcpServers": {
    "storelift": {
      "command": "npx",
      "args": [
        "-y",
        "storelift-mcp"
      ],
      "env": {
        "STORELIFT_API_KEY": "sl_live_..."
      }
    }
  }
}

或者使用托管端点并登录（OAuth）：遇到要求登录的服务器，Cursor 会在浏览器里打开登录页面。

{
  "mcpServers": {
    "storelift": {
      "url": "https://storelift.net/mcp"
    }
  }
}

Cursor 默认会在使用 MCP 工具前请你批准。在命令行里，cursor-agent mcp list-tools storelift 可以检查连接，并列出各个工具及其参数。

首次读取

这样问：“列出我在 Storelift 里的应用，再给我看第一个应用在美国的关键词排名。”助手会先调用 list_apps，再为你选的应用调用 get_keywords。list_apps 的返回大致如下（Storelift 示例数据，2026-09-28；你自己的账号返回的是你自己的应用）：

{
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "countries": [
        "us",
        "gb",
        "de"
      ],
      "keywords": [
        "sleep sounds",
        "white noise",
        "rain sounds"
      ]
    }
  ]
}

get_keywords 为每个追踪的关键词返回一行：

{
  "country": "us",
  "platform": "ios",
  "keywords": [
    {
      "term": "sleep sounds",
      "measured": true,
      "rank": null,
      "demand": 73,
      "searchDepth": 200
    },
    {
      "term": "white noise",
      "measured": true,
      "rank": 57,
      "demand": 37,
      "searchDepth": 200
    }
  ]
}

rank 是数字时，它就是排名；null 表示这个关键词已测量，但应用未上榜；measured: false 表示没能测量。这三种情况要分开看：把没测到的一天当成零，会得出错误的答案。

连接已经可用。接下来看三个入门任务：哪些关键词排名下降了，这些词上谁排在你前面，以及某个关键词今天没有测量时该怎么说，每个任务都附有应得到的回答。

移除访问权限

1. 在 Cursor 的 Customize 下关闭或移除这个服务器，或者从 mcp.json 里删掉 storelift 这一项。在 CLI 中，cursor-agent mcp disable storelift 会让它不再加载。
2. 在“Storelift → 设置 → API 密钥”中删除这个密钥。之后再用它发出的请求会被拒绝（本地服务器返回工具错误，托管端点返回 HTTP 401）；没有需要等待结束的会话。
3. 如果是通过登录（OAuth）连接的，请在“设置 → API → 已连接的 App”中移除这个连接；该连接的令牌在下一次请求时会收到 401。

故障排查

延伸阅读