Storelift

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

ИИ-слой

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

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

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

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

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

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

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

Версия

Гайд описывает сервер, который работает сейчас: 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 скачивает пакет при первом запуске). Для размещённого эндпоинта ничего устанавливать не нужно.
  • Claude Code. Подойдёт любая свежая версия; команды ниже взяты из claude mcp add --help и документации Claude Code по MCP.

Настройка

Локальный сервер с API-ключом (запускайте в каталоге проекта; по умолчанию сервер добавляется только для этого проекта):

Terminal
claude mcp add storelift -e STORELIFT_API_KEY=sl_live_... -- npx -y storelift-mcp

Или размещённый эндпоинт: устанавливать ничего не нужно, ключ передаётся в заголовке:

Terminal
claude mcp add --transport http storelift https://storelift.net/mcp --header "Authorization: Bearer sl_live_..."

Чтобы вместо ключа войти через OAuth, добавьте эндпоинт без заголовка, а затем выполните /mcp внутри Claude Code:

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

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. Выполните claude mcp remove storelift. Для подключения через вход Claude Code заодно удаляет сохранённые токены; /mcp → Clear authentication делает то же самое, не удаляя сервер.
  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 задавайте, только если вам выдали другой эндпоинт.
✘ Failed to connect в claude mcp listСервер не запустился (Node.js не установлен или слишком старый) либо эндпоинт не ответил вовремя.Выполните node --version; если сервер стартует медленно, увеличьте тайм-аут запуска, например MCP_TIMEOUT=10000 claude.

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

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

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

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

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