Подключение MCP-сервера

В этом руководстве мы расскажем, как подключить ваш аккаунт MP Manager к сторонним ИИ-инструментам, таким как Claude Code, OpenCode и Codex. Это позволит вам делегировать рутинные задачи анализа данных, работы с рекламой и аудита карточек товаров вашему ИИ-ассистенту.

Что такое MCP и зачем это нужно?

MCP (Model Context Protocol) — это открытый протокол, созданный для того, чтобы ИИ-ассистенты могли безопасно и стандартизированно получать доступ к внешним данным и выполнять различные действия.

Если говорить проще, MCP-сервер — это как универсальный «переводчик» или «шлюз», который позволяет вашему ИИ-ассистенту (например, Claude Code или OpenCode) «видеть» и «работать» с данными в вашем аккаунте MP Manager. Вы можете попросить ассистента на обычном русском языке проанализировать рекламные кампании, найти лучшие товары для продажи или провести аудит поставщика — и он сделает это, обращаясь к нашему серверу за нужной информацией и инструментами.

Мы запустили публичный MCP-сервер, который предоставляет вашему ИИ-помощнику прямой доступ к аналитике, инструментам генерации, управлению рекламой и другим функциям MP Manager. Вам больше не нужно переключаться между вкладками браузера, чтобы собрать данные для отчета — просто спросите своего ИИ-ассистента.

Готовое решение в MP Manager

Самый простой способ начать работу — воспользоваться встроенным ИИ-ассистентом прямо в интерфейсе MP Manager. Он уже подключен ко всем необходимым сервисам и готов к работе без какой-либо настройки. Для его использования достаточно иметь активный тариф AI. Найти ассистента можно в разделе «AI Инструменты — Ассистент».

Если же вы предпочитаете работать в привычной среде разработки (IDE) или использовать своего собственного ИИ-агента, воспользуйтесь инструкциями ниже для подключения MCP-сервера вручную.

Параметры подключения

Для подключения любого стороннего ИИ-инструмента вам понадобятся:

Параметр	Описание
`URL сервера`	`https://mcp.mpmgr.ru`
`Authorization`	Ваш персональный API-ключ от сервиса MP Manager. Важно: это не ключ от Wildberries, Ozon или Яндекс Маркета. Создать такой ключ можно на странице «Доступы — API ключи» в вашем личном кабинете MP Manager.
`X-Organization-Id`	Id вашей организации в MP Manager. Обязательный заголовок. Без него доступ предоставлен не будет. Узнать свой Id можно по инструкции: Как узнать Id организации
`Протокол / Транспорт`	Сервер использует стандартный Streamable HTTP (JSON-RPC), соответствующий последней спецификации MCP. Для большинства клиентов нужно выбирать транспорт типа `http` или `streamable-http`.

Фильтрация сервисов (Query-параметры)

По умолчанию сервер предоставляет доступ ко всем доступным сервисам MP Manager. Если вы хотите ограничить набор инструментов, видимых вашему ИИ-ассистенту, вы можете добавить query-параметры к URL сервера.

services: указывает на конкретный сервис. Вы можете перечислить несколько сервисов через запятую.
- Пример: ?services=auto_campaigns,auto_feedbacks — будут доступны только сервисы «Автокампании» и «Автоотзывы».
Логика исключения (!): Если перед названием сервиса поставить восклицательный знак (!), этот сервис будет исключён из списка доступных.
- Пример: ?services=!analytics — будут доступны все сервисы, кроме «Аналитики».
Комбинирование: Правила включения и исключения работают вместе. Сначала обрабатываются все исключения (!), а затем — список разрешённых сервисов.
- Важно: Если вы укажете и список разрешённых сервисов, и исключения, ИИ-ассистент получит доступ только к тем сервисам, которые не исключены и при этом входят в список разрешённых.

Список всех доступных сервисов: auto_prices, auto_characteristics, auto_feedbacks, auto_campaigns, auto_generation, auto_mailings, auto_supplies, deeplinks, bff, meta, notifications, wb, ozon, yandex_market.

Инструкции по подключению

Claude Code

Для Claude Code существует два способа настройки: через CLI-команды или правкой конфигурационных файлов. Мы рекомендуем использовать CLI как более простой и надёжный метод.

Способ 1: Настройка через CLI (рекомендуется)

Выполните в терминале одну из следующих команд. Замените <ваш_ключ> и <ваш_id_организации> на свои данные.

Добавить глобально (для всех проектов):

claude mcp add --scope user --transport http "MP Manager" https://mcp.mpmgr.ru --header "Authorization: Bearer <ваш_ключ>" --header "X-Organization-Id: <ваш_id_организации>"

Добавить для текущего проекта:

claude mcp add --scope project --transport http "MP Manager" https://mcp.mpmgr.ru --header "Authorization: Bearer <ваш_ключ>" --header "X-Organization-Id: <ваш_id_организации>"

Способ 2: Ручное редактирование конфигурации

Claude Code использует два разных файла конфигурации в зависимости от версии и способа установки. Мы приведём примеры для обоих вариантов.

Вариант A: Файл ~/.claude/settings.json

Найдите или создайте файл ~/.claude/settings.json и добавьте в него блок mcpServers.

{
  "mcpServers": {
    "MP Manager": {
      "type": "http",
      "url": "https://mcp.mpmgr.ru",
      "headers": {
        "Authorization": "Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER",
        "X-Organization-Id": "ВАШ_Id_ОРГАНИЗАЦИИ"
      }
    }
  }
}

Вариант B: Файл ~/.claude.json

В более старых версиях Claude Code используется файл ~/.claude.json. Синтаксис аналогичен, но без корневого объекта mcpServers.

{
  "MP Manager": {
    "type": "http",
    "url": "https://mcp.mpmgr.ru",
    "headers": {
      "Authorization": "Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER",
      "X-Organization-Id": "ВАШ_Id_ОРГАНИЗАЦИИ"
    }
  }
}

OpenCode

Для настройки в OpenCode необходимо добавить конфигурацию в файл opencode.json. Он находится в папке .config/opencode/ в домашней директории вашего пользователя:

macOS / Linux: ~/.config/opencode/opencode.json
Windows: %USERPROFILE%\.config\opencode\opencode.json

Добавьте или измените блок mcp в этом файле, как показано в примере ниже.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "MP Manager": {
      "type": "remote",
      "url": "https://mcp.mpmgr.ru",
      "headers": {
        "Authorization": "Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER",
        "X-Organization-Id": "ВАШ_Id_ОРГАНИЗАЦИИ"
      }
    }
  }
}

Пример с фильтрацией сервисов

Если вы хотите подключить только сервисы для работы с кампаниями и отзывами, ваш URL будет выглядеть так:

      "url": "https://mcp.mpmgr.ru?services=auto_campaigns,auto_feedbacks",

Codex (OpenAI)

Для настройки Codex используется конфигурационный файл config.toml, расположенный в папке .codex вашей домашней директории:

macOS / Linux: ~/.codex/config.toml
Windows: %USERPROFILE%\.codex\config.toml

Откройте или создайте этот файл и добавьте в него следующую секцию. Обратите внимание на синтаксис TOML.

[mcp_servers."MP Manager"]
url = "https://mcp.mpmgr.ru"

[mcp_servers."MP Manager".headers]
Authorization = "Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER"
X-Organization-Id = "ВАШ_Id_ОРГАНИЗАЦИИ"

После внесения изменений в config.toml перезапустите Codex, чтобы новые настройки вступили в силу. Проверить активные MCP-сервера можно командой codex config list.

Что можно делать с помощью MCP-сервера?

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

Поиск и анализ ниши: «Проанализируй топ-10 брендов в нише колготок за последний месяц. Подбери лучшие товары для продажи в 2026 году».
Аудит поставщиков: «Проведи аудит поставщика X. Проверь его карточки товаров, цены и отзывы».
Управление рекламой: «Посмотри мои рекламные кампании за последнюю неделю и скажи, где я перерасходую бюджет. Предложи, как улучшить показатели».
Анализ отзывов: «Найди и сгруппируй основные жалобы покупателей в отзывах за последние 50 заказов».
Комплексный аудит кабинета: «Проведи полный аудит моего кабинета на Wildberries. Найди проблемные места в карточках товаров и дай рекомендации по их улучшению».

Ассистент сам разберется, к каким сервисам и данным MP Manager ему нужно обратиться, чтобы выполнить вашу задачу.

Решение возможных проблем

Если после настройки ИИ-ассистент сообщает, что не видит новых инструментов, проверьте следующее:

Перезапустите ИИ-клиент. Большинство клиентов загружают конфигурацию MCP только при старте.
Проверьте заголовки. Убедитесь, что в поле Authorization добавлено слово Bearer перед ключом (например, Bearer mp_live_abc123...).
Проверьте Id организации. Убедитесь, что вы скопировали Id организации из личного кабинета без пробелов и лишних символов.
Проверьте синтаксис файла. Невалидный JSON или TOML может помешать клиенту считать настройки. Воспользуйтесь онлайн-валидаторами для проверки вашего конфигурационного файла.
Проверьте query-параметры. Если вы использовали фильтрацию сервисов, попробуйте временно убрать все параметры из URL, чтобы убедиться, что проблема не в них.

Что такое MCP и зачем это нужно?​

Готовое решение в MP Manager​

Параметры подключения​

Фильтрация сервисов (Query-параметры)​

Инструкции по подключению​

Claude Code​

Способ 1: Настройка через CLI (рекомендуется)​

Способ 2: Ручное редактирование конфигурации​

OpenCode​

Пример с фильтрацией сервисов​

Codex (OpenAI)​

Что можно делать с помощью MCP-сервера?​

Решение возможных проблем​