Storelift

Storelift › Руководства › Добавление MCP-сервера Storelift в Cursor

ИИ-слой

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

Пошаговое подключение MCP-сервера Storelift к Cursor; версия, требования и ответы с ошибками измерены на самом сервере.

Начать бесплатно →Бесплатный план: 1 приложение, по 25 ключевых слов в 2 витринах, 30 дней истории, без карты и без срока. Pro — $20/мес.

Автор: Обновлено: 4 мин чтения

Отслеживание ключевых слов · история позиций отслеживаемых слов

Как проверялся этот гайд

Как это проверялось (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:

JSON
{
  "mcpServers": {
    "storelift": {
      "command": "npx",
      "args": [
        "-y",
        "storelift-mcp"
      ],
      "env": {
        "STORELIFT_API_KEY": "sl_live_..."
      }
    }
  }
}

Или размещённый эндпоинт со входом (OAuth): для серверов, которые этого требуют, Cursor открывает вход в браузере.

JSON
{
  "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; ваш аккаунт вернёт ваши приложения):

JSON
{
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "countries": [
        "us",
        "gb",
        "de"
      ],
      "keywords": [
        "sleep sounds",
        "white noise",
        "rain sounds"
      ]
    }
  ]
}

get_keywords возвращает по одной строке на каждое отслеживаемое ключевое слово:

JSON
{
  "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 задавайте, только если вам выдали другой эндпоинт.
Размещённый эндпоинт просит войти, хотя вы задали заголовок AuthorizationCursor CLI 2025.09.17 не отправлял заданный заголовок при подключении, поэтому эндпоинт отвечал 401 и просил войти.Используйте локальный сервер (ключ передаётся в env) или войдите.

Проверьте на своём приложении

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

Бесплатный план: 1 приложение, по 25 ключевых слов в 2 витринах, 30 дней истории, без карты и без срока. Pro — $20/мес.

Начать бесплатно →
Наборы конкурентов · слова, общие с конкурентом, и те, что есть только у него

Читайте также