# Добавление MCP-сервера Storelift в Cursor

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

Пошаговое подключение MCP-сервера Storelift к 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.

## Версия

Гайд описывает сервер, который работает сейчас: 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 значит, что измерить не удалось. Эти три состояния не смешиваются: если посчитать неизмеренный день нулём, ответ будет неверным.

Подключение работает. Дальше — три первые задачи: какие ключевые слова упали, кто по ним выше и что отвечать, когда у слова нет сегодняшнего замера; у каждой показан ответ, которого стоит ждать.

## Отключение доступа

1. В Cursor выключите или удалите сервер в разделе Customize либо удалите запись storelift из mcp.json. Из CLI команда cursor-agent mcp disable storelift отключает его загрузку.
2. Удалите ключ в Storelift → Настройки → API-ключи. Следующий запрос с этим ключом будет отклонён (ошибка инструмента на локальном сервере, HTTP 401 на размещённом эндпоинте); открытой сессии, окончания которой пришлось бы ждать, нет.
3. Если вы подключались через вход (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.net; STORELIFT_API задавайте, только если вам выдали другой эндпоинт. |
| Размещённый эндпоинт просит войти, хотя вы задали заголовок Authorization | Cursor CLI 2025.09.17 не отправлял заданный заголовок при подключении, поэтому эндпоинт отвечал 401 и просил войти. | Используйте локальный сервер (ключ передаётся в env) или войдите. |