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

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

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

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

NOTE: Как это проверялось (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-ключом (запускайте в каталоге проекта; по умолчанию сервер добавляется только для этого проекта):

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

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

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

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

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

{
"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. Выполните 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. |