# 把 Storelift MCP 服务器添加到 Cursor

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

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

## 本指南的验证方式

NOTE: 验证方式（2026-10-11）。服务器端用 storelift-mcp 1.1.1 实测：握手、工具列表、读取调用、错误响应和访问权限的移除。在 Cursor 中看到的：cursor-agent 2025.09.17-25b418f · stdio, API 密钥: 能连接, 列出 8 个工具。还没有试过从 Cursor 内部调用工具；下面的步骤依据 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。

## 故障排查

| 你看到的 | 原因 | 怎么办 |
| --- | --- | --- |
| “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。 |
| 已经设置了 Authorization 请求头，托管端点仍然要求登录 | Cursor CLI 2025.09.17 连接时没有发送配置好的请求头，所以端点返回 401 并要求登录。 | 改用本地服务器（密钥放在 env 里），或者直接登录。 |