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

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

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

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

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

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

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

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

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

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

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

Фильтрация сервисов (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 находится здесь:

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

Что можно делать с помощью 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 после любых изменений конфигурации.