MP Manager
Подключение MCP-сервера~11 мин чтения

Подключение MCP-сервера MP Manager к ИИ-инструментам

Подключение MCP-сервера MP Manager к ИИ-инструментам: Claude Code, OpenCode, Codex, OpenClaw, Hermes Agent. Получите доступ к аналитике, генерации и управлению рекламой через ИИ.

Автор статьи

Анастасия Иншина

Эксперт по автоматизации продаж на маркетплейсах

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

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

Что такое 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-IdId вашей организации в 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.

  • modes: фильтрует инструменты по режиму доступа. По умолчанию возвращаются только инструменты чтения (read). Чтобы получить инструменты записи, укажите write.
    • По умолчанию (без параметра): ? - только read инструменты.
    • Чтение + запись: ?modes=write - доступны все инструменты.
    • Только чтение явно: ?modes=read - эквивалентно отсутствию параметра.
    • Комбинирование: ?modes=read,write - аналогична write, возвращает всё.

Пример: подключить аналитику + кампании с полным доступом (чтение и запись):

https://mcp.mpmgr.ru?services=analytics,auto-campaigns&modes=write

Пример: все сервисы, только чтение (поведение по умолчанию):

https://mcp.mpmgr.ru

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

Claude Code

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

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

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

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

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

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

    claude mcp add --scope project --transport http "MP Manager" https://mcp.mpmgr.ru?services=analytics --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?services=analytics",
      "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?services=analytics",
    "headers": {
      "Authorization": "Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER",
      "X-Organization-Id": "ВАШ_Id_ОРГАНИЗАЦИИ"
    }
  }
}

Claude Desktop

1. Найдите файл конфигурации

В зависимости от вашей операционной системы, файл claude_desktop_config.json находится здесь:

ОСПуть к файлу
Windows%APPDATA%\Claude\claude_desktop_config.json
macOS~/Library/Application Support/Claude/claude_desktop_config.json

2. Добавьте конфигурацию MCP-сервера

Откройте файл конфигурации и добавьте (или замените) блок mcpServers. Если файла не существует - создайте его.

Рабочий конфиг для Windows:

{
  "mcpServers": {
    "MP Manager": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "mcp-remote",
        "https://mcp.mpmgr.ru?services=analytics",
        "--header",
        "Authorization: Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER",
        "--header",
        "X-Organization-Id: ВАШ_Id_ОРГАНИЗАЦИИ"
      ]
    }
  }
}

Для macOS/Linux:

{
  "mcpServers": {
    "MP Manager": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.mpmgr.ru?services=analytics",
        "--header",
        "Authorization: Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER",
        "--header",
        "X-Organization-Id: ВАШ_Id_ОРГАНИЗАЦИИ"
      ]
    }
  }
}

3. Получите API-ключ и Id организации

  • API-ключ: создайте в личном кабинете MP Manager в разделе «Доступы → API ключи»
  • Id организации: узнайте по инструкции в том же разделе

4. Замените значения в конфиге

Вставьте свои данные вместо:

  • ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER - ваш API-ключ
  • ВАШ_Id_ОРГАНИЗАЦИИ - ваш Id организации

5. (Опционально) Фильтрация сервисов

Чтобы ограничить доступные инструменты, добавьте параметр services в URL:

https://mcp.mpmgr.ru?services=analytics

Пример: только аналитика

"url": "https://mcp.mpmgr.ru?services=analytics"

Доступные сервисы: auto-prices, auto-characteristics, auto-feedbacks, auto-campaigns, auto-generation, auto-mailings, auto-supplies, deeplinks, bff, meta, notifications, wb, ozon, yandex-market, analytics

6. Перезапустите Claude Desktop

Важно: Полностью закройте приложение:

  • Найдите иконку Claude в трее (системном лотке)
  • Нажмите правой кнопкой мыши → Quit (Выйти)
  • Запустите Claude Desktop заново

7. Проверьте подключение

После перезапуска:

  • В правом нижнем углу интерфейса Claude должна появиться иконка 🔌 или 🛠️
  • Или просто попробуйте спросить: «Покажи мой текущий баланс в MP Manager»

Диагностика проблем

Если сервер не появился:

  1. Проверьте синтаксис JSON - убедитесь, что нет лишних запятых
  2. Проверьте пробел после Bearer - должно быть Bearer (пробел обязателен)
  3. Убедитесь, что Node.js установлен - выполните в терминале node --version
  4. Посмотрите логи Claude Desktop - они находятся в:
    • Windows: %APPDATA%\Claude\logs\mcp*.log
    • macOS: ~/Library/Logs/Claude/mcp*.log

Теперь ваш Claude Desktop может работать с инструментами MP Manager через MCP-протокол.

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?services=analytics",
      "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?services=analytics"

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

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

OpenClaw

OpenClaw - бесплатный open-source ИИ-агент, который работает 24/7 в фоновом режиме на вашем VPS или домашнем компьютере. В отличие от чат-ботов, OpenClaw выполняет реальные действия: управляет файлами, браузером, автоматизирует задачи в мессенджерах (Telegram, Slack, Discord). Подключите Claude, GPT, DeepSeek или локальную модель - и ассистент получит доступ к инструментам MP Manager через MCP.

Способ 1: Control UI (рекомендуется)

Самый простой способ - через веб-интерфейс OpenClaw:

  1. Откройте Control UI вашего OpenClaw (по умолчанию http://localhost:3000)
  2. Перейдите в раздел MCP
  3. Нажмите Добавить сервер
  4. Выберите транспорт: HTTP (streamable-http)
  5. Вставьте URL: https://mcp.mpmgr.ru?services=analytics
  6. Добавьте заголовки:
    • Authorization: Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER
    • X-Organization-Id: ВАШ_Id_ОРГАНИЗАЦИИ
  7. Сохраните настройки

Способ 2: CLI-команда

Выполните в терминале:

openclaw mcp set "MP Manager" --url https://mcp.mpmgr.ru?services=analytics

Экспортируйте переменные окружения для авторизации:

export MP_MANAGER_MCP_API_KEY=ваш_секретный_ключ
export MP_MANAGER_MCP_ORG_ID=ваш_id_организации

Перезапустите шлюз, чтобы OpenClaw подтянул новые инструменты:

openclaw gateway restart

Проверка подключения

После настройки убедитесь, что инструменты импортировались:

openclaw skill set

Или просто спросите агента в чате Telegram/Slack: «Какие новые инструменты тебе доступны?»

Диагностика проблем

Если инструменты не появились:

  1. Проверьте логи: openclaw mcp status или openclaw mcp doctor
  2. Перезапустите шлюз: openclaw gateway restart
  3. Убедитесь, что URL корректный - проверьте, что нет опечаток в адресе сервера

Конфигурационный файл

Настройки MCP сохраняются в ~/.openclaw/workspace/config/mcporter.json. Убедитесь, что файл существует и имеет правильный синтаксис.

Фильтрация сервисов и режимов

Как и для других клиентов, вы можете добавить параметры services и modes в URL:

https://mcp.mpmgr.ru?services=analytics,auto-campaigns&modes=write

Hermes Agent

Hermes Agent - бесплатный open-source ИИ-помощник от команды Nous Research с долговременной памятью и автоматическим созданием навыков. В отличие от обычных чат-ботов, Hermes запоминает контекст прошлых бесед, обучается на вашем опыте и может работать через мессенджеры (Telegram, Discord, Slack, WhatsApp). Поддерживает коммерческие модели (OpenAI, Claude) и полностью бесплатные локальные нейросети через Ollama.

Установка поддержки MCP

Если Hermes установлен с полными зависимостями (uv pip install -e ".[all]"), поддержка MCP уже включена. Для отдельной установки:

cd ~/.hermes/hermes-agent
uv pip install -e ".[mcp]"

Для npm-based серверов убедитесь, что Node.js и npx доступны. Для Python MCP серверов рекомендуется использовать uvx.

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

Выполните в терминале:

hermes mcp add mpmgr --url https://mcp.mpmgr.ru?services=analytics \
  --header "Authorization: Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER" \
  --header "X-Organization-Id: ВАШ_Id_ОРГАНИЗАЦИИ"

После добавления проверьте подключение:

hermes mcp test mpmgr

Способ 2: Ручное редактирование config.yaml

Откройте или создайте файл ~/.hermes/hermes-agent/config.yaml и добавьте секцию mcp_servers:

mcp_servers:
  mpmgr:
    url: "https://mcp.mpmgr.ru?services=analytics"
    headers:
      Authorization: "Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER"
      X-Organization-Id: "ВАШ_Id_ОРГАНИЗАЦИИ"

Фильтрация инструментов

Hermes поддерживает гранулярную фильтрацию MCP-инструментов через конфигурацию - более детальную, чем URL-параметры. Это позволяет точно контролировать, какие инструменты доступны каждому серверу.

Белый список (включить только нужное):

mcp_servers:
  mpmgr:
    url: "https://mcp.mpmgr.ru"
    headers:
      Authorization: "Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER"
      X-Organization-Id: "ВАШ_Id_ОРГАНИЗАЦИИ"
    tools:
      include:
        - list_campaigns
        - get_analytics
        - get_prices
        - get_feedbacks
      prompts: false
      resources: false

Чёрный список (исключить опасное):

mcp_servers:
  mpmgr:
    url: "https://mcp.mpmgr.ru"
    headers:
      Authorization: "Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER"
      X-Organization-Id: "ВАШ_Id_ОРГАНИЗАЦИИ"
    tools:
      exclude:
        - delete_campaign
        - update_prices

Отключение утилитных обёрток:

Если не хотите, чтобы модель использовала resources/prompts от сервера:

    tools:
      prompts: false
      resources: false

Проверка подключения

После настройки перезапустите Hermes и проверьте доступные инструменты:

# В интерфейсе Hermes:
/reload-mcp

# Или просто спросите:
Tell me which MCP-backed tools are available right now.

Конфигурационный файл

Настройки MCP сохраняются в ~/.hermes/hermes-agent/config.yaml. Убедитесь, что файл существует и имеет правильный YAML-синтаксис.

Типичные паттерны использования

Локальный ассистент проекта:

mcp_servers:
  fs:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/project"]
  mpmgr:
    url: "https://mcp.mpmgr.ru?services=analytics"
    headers:
      Authorization: "Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER"
      X-Organization-Id: "ВАШ_Id_ОРГАНИЗАЦИИ"

Hermes может комбинировать данные из файловой системы и MP Manager: «Просмотри структуру проекта и создай issue в GitHub с описанием найденного бага».

Чтение + запись с фильтрацией:

mcp_servers:
  mpmgr:
    url: "https://mcp.mpmgr.ru?modes=write"
    headers:
      Authorization: "Bearer ВАШ_API_КЛЮЧ_ОТ_MP_MANAGER"
      X-Organization-Id: "ВАШ_Id_ОРГАНИЗАЦИИ"
    tools:
      include:
        - list_campaigns
        - update_prices
        - get_analytics
      prompts: false
      resources: false

Решение проблем

СимптомРешение
Сервер подключён, но инструменты отсутствуютПроверьте tools.include - возможно, нужные инструменты не в списке
Ничего не загрузилосьУбедитесь, что enabled: false не оставлено в конфиге, и HTTP-эндпоинт доступен
Меньше инструментов, чем рекламирует серверHermes учитывает вашу политику фильтрации - это ожидаемое поведение
Как отключить сервер без удаления конфигаИспользуйте enabled: false в секции сервера

После любых изменений конфигурации выполните /reload-mcp в интерфейсе Hermes.

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

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

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

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

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

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

  1. Перезапустите ИИ-клиент. Большинство клиентов загружают конфигурацию MCP только при старте.
  2. Проверьте заголовки. Убедитесь, что в поле Authorization добавлено слово Bearer перед ключом (например, Bearer mp_live_abc123...).
  3. Проверьте Id организации. Убедитесь, что вы скопировали Id организации из личного кабинета без пробелов и лишних символов.
  4. Проверьте синтаксис файла. Невалидный JSON или TOML может помешать клиенту считать настройки. Воспользуйтесь онлайн-валидаторами для проверки вашего конфигурационного файла.
  5. Проверьте query-параметры. Если вы использовали фильтрацию сервисов или режимов, попробуйте временно убрать все параметры из URL, чтобы убедиться, что проблема не в них. Параметр modes по умолчанию возвращает только инструменты чтения - для записи укажите ?modes=write.
  6. Для OpenClaw: выполните openclaw mcp doctor для автоматической диагностики и openclaw gateway restart после любых изменений конфигурации.