Подключение 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-сервера вручную.

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

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

Фильтрация сервисов (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?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.

Что можно делать с помощью 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, чтобы убедиться, что проблема не в них.