把 Storelift MCP 服务器添加到 Claude Code

本指南的验证方式

Claude Code 的文档：code.claude.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 会在首次运行时拉取这个包）。托管端点不需要安装任何东西。
• Claude Code：任意较新的版本即可；下面的命令来自 claude mcp add --help 和 Claude Code 的 MCP 文档。

配置步骤

本地服务器，使用 API 密钥（在项目目录下运行；默认范围只限当前项目）：

claude mcp add storelift -e STORELIFT_API_KEY=sl_live_... -- npx -y storelift-mcp

或者使用托管端点，无需安装，密钥放在请求头里：

claude mcp add --transport http storelift https://storelift.net/mcp --header "Authorization: Bearer sl_live_..."

想用登录（OAuth）代替密钥，就添加不带请求头的端点，然后在 Claude Code 里运行 /mcp：

claude mcp add --transport http storelift https://storelift.net/mcp

用 claude mcp list 检查连接；这一行应显示 ✔ Connected。

首次读取

这样问：“列出我在 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. 运行 claude mcp remove storelift。如果是登录方式的连接，Claude Code 还会删除它保存的令牌；/mcp → Clear authentication 可以只清除令牌而不移除服务器。
2. 在“Storelift → 设置 → API 密钥”中删除这个密钥。之后再用它发出的请求会被拒绝（本地服务器返回工具错误，托管端点返回 HTTP 401）；没有需要等待结束的会话。
3. 如果是通过登录（OAuth）连接的，请在“设置 → API → 已连接的 App”中移除这个连接；该连接的令牌在下一次请求时会收到 401。

故障排查

延伸阅读