Как проверялся этот гайд
Документация Cursor: cursor.com.
Версия
Гайд описывает сервер, который работает сейчас: storelift-mcp 1.1.1 в npm (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; эндпоинт не хранит состояние: нет ни идентификатора сессии, ни серверного потока событий.
Требования
- Тариф. Для доступа по 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 значит, что измерить не удалось. Эти три состояния не смешиваются: если посчитать неизмеренный день нулём, ответ будет неверным.
Подключение работает. Дальше — три первые задачи: какие ключевые слова упали, кто по ним выше и что отвечать, когда у слова нет сегодняшнего замера; у каждой показан ответ, которого стоит ждать.
Отключение доступа
- В Cursor выключите или удалите сервер в разделе Customize либо удалите запись
storeliftизmcp.json. Из CLI командаcursor-agent mcp disable storeliftотключает его загрузку. - Удалите ключ в Storelift → Настройки → API-ключи. Следующий запрос с этим ключом будет отклонён (ошибка инструмента на локальном сервере, HTTP 401 на размещённом эндпоинте); открытой сессии, окончания которой пришлось бы ждать, нет.
- Если вы подключались через вход (OAuth), удалите подключение в разделе Настройки → API → Подключённые приложения; токен этого подключения получит 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_API задавайте, только если вам выдали другой эндпоинт. |
| Размещённый эндпоинт просит войти, хотя вы задали заголовок Authorization | Cursor CLI 2025.09.17 не отправлял заданный заголовок при подключении, поэтому эндпоинт отвечал 401 и просил войти. | Используйте локальный сервер (ключ передаётся в env) или войдите. |
Проверьте на своём приложении
Вставьте ссылку на приложение и добавьте ключевые слова. Позиция, приложения выше вас и спрос измеряются каждый день.
Бесплатный план: 1 приложение, по 25 ключевых слов в 2 витринах, 30 дней истории, без карты и без срока. Pro — $20/мес.
Начать бесплатно →
