# 把 Storelift MCP 服务器添加到 Claude Code

URL: https://storelift.net/zh/guide/storelift-mcp-claude-code/
Language: zh
Updated: 2026-10-13

把 Storelift MCP 服务器连接到 Claude Code 的步骤；版本、前提条件和错误响应都是在服务器上实测的。

## 本指南的验证方式

NOTE: 验证方式（2026-10-11）。服务器端用 storelift-mcp 1.1.1 实测：握手、工具列表、读取调用、错误响应和访问权限的移除。在 Claude Code 中看到的：2.1.296 · stdio, API 密钥: 能连接, 列出 8 个工具, 用移除命令可以干净地移除; 2.1.296 · Streamable HTTP, 请求头中的 API 密钥: 能连接, 列出 8 个工具。还没有试过从 Claude Code 内部调用工具；下面的步骤依据 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。

## 故障排查

| 你看到的 | 原因 | 怎么办 |
| --- | --- | --- |
| “No API key was sent…” | 本地服务器启动时没有密钥。工具仍会列出，但每次调用都返回这条信息。 | 在服务器配置里加上 STORELIFT_API_KEY，然后重启客户端。 |
| “This API key is not valid…” | 密钥输错了，或者已被删除。托管端点返回 HTTP 401。 | 在“设置 → API 密钥”中新建一个密钥，替换配置里的那个。 |
| “The Public API is available on the Pro and Studio plans…” | 账号的套餐没有开通 MCP 访问（HTTP 403）。在这个版本中，Pro、Studio 或 Enterprise 套餐可以访问。 | 在 storelift.net/pricing 升级；密钥会保留，套餐允许后即可继续使用。 |
| “fetch failed…” | 本地服务器连不上 Storelift：网络、代理或防火墙的问题。 | 确认这台机器能访问 https://storelift.net；只有在拿到了别的端点地址时才设置 STORELIFT_API。 |
| claude mcp list 里显示 ✘ Failed to connect | 服务器没有启动（没装 Node.js 或版本太旧），或者端点没有及时响应。 | 运行 node --version 查看；启动较慢时调大启动超时，例如 MCP_TIMEOUT=10000 claude。 |