Как подключить AI-ассистента к Mindbox через MCP

MCP-сервер Mindbox подключает ваш проект к AI-ассистенту Claude или ChatGPT. После подключения агент работает с проектом по запросам в чате: собирает сценарии, фильтры и письма, объясняет условия фильтров, проверяет настройки.

Агент не работает с персональными данными и не собирает их

ИИ-модель работает только с теми данными Mindbox, к которым у сотрудника есть доступ. Персональные данные клиентов в нейросеть не попадают. Разрешение «Использование MCP» действует в каждом проекте отдельно, и владелец может его отозвать. Если отключить учетную запись сотрудника, ИИ потеряет доступ к Mindbox вместе с ней.

Что можно делать

  • Сценарии — собрать черновик сценария по описанию, доработать существующий, разобрать и проверить настройки.
  • Фильтры — собрать фильтр по описанию аудитории или объяснить условия готового фильтра.
  • Рассылки — собрать письмо для визуального редактора, посмотреть превью, настроить тему, получателей и расписание, отправить тест.
  • Персонализация — посмотреть настройки попапов и встроенных блоков и результаты их показов.
  • Акции — разобрать, почему акция не применилась к заказу или скидка оказалась меньше ожидаемой.
  • Аналитика — ответить на вопрос о метриках проекта, объяснить, почему изменились цифры, и дать ссылку на отчет для проверки. Подробнее — в статье Как анализировать метрики проекта через AI-ассистента.

Примеры запросов — в статье Как создавать и проверять сценарии через AI-ассистента.

Границы доступа

Агенту доступны только действия, которые поддерживает MCP-сервер. Основные перечислены выше. Агент выполняет их от имени сотрудника, который подключил MCP, и с его правами: если у сотрудника нет доступа к разделу или действию в Mindbox, агент его тоже не получит. Кроме того:

  • агент собирает и проверяет черновик сценария, может включить тестовый режим, но не запускает сценарий в работу;
  • агент отправляет тестовое письмо только после вашего подтверждения. Чтобы подтверждать и другие изменения, настройте подтверждение действий;
  • агент не отправляет рассылку по базе и не удаляет сценарии и рассылки.

Перед запуском проверьте результат в интерфейсе Mindbox.

Перед началом

  1. Права в Mindbox. Нужные права есть у групп безопасности: Владельцы, Маркетологи и Аналитики.

    Остальным сотрудникам владелец может выдать права «Использование MCP» и «Просмотр отчетов» для анализа аналитики.

mcp-connect-permission

  1. AI-клиент. Что доступно на разных тарифах:
Клиент и тариф Подключение MCP Скиллы Mindbox
Claude Free Да, один свой коннектор Частично: плагин недоступен, скиллы нужно загружать архивами вручную, и пока работают не все
Claude Pro, Max Да Да
Claude Team, Enterprise Коннектор добавляет владелец организации Claude Да
Приложение ChatGPT для компьютера (macOS, Windows) и Codex CLI Да Да
ChatGPT в браузере Только в режиме разработчика, на тарифах Plus и выше Только плагином, который подключил администратор воркспейса (Business, Enterprise)

Примечание

MCP-сервер Mindbox работает по открытому стандарту MCP с входом через OAuth, а скиллы Mindbox сделаны в открытом формате Agent Skills. Поэтому работать с Mindbox можно и в других AI-приложениях, которые умеют подключать удаленные MCP-серверы и устанавливать скиллы.

В таком приложении найдите в настройках раздел для MCP-серверов или коннекторов, укажите URL из шага 1 и установите скиллы из репозитория Mindbox. Ниже пошагово описаны Claude и ChatGPT.

Шаг 1. Скопируйте URL для подключения

Откройте «Настройки» → «Системные» → «Mindbox AI» и скопируйте значение поля «Ваш URL для подключения». URL один для всех сотрудников проекта: каждый входит под своей учетной записью.

mcp-connect-menu

mcp-connect-url

Когда вы подключите URL в AI-клиенте (шаг 2), в браузере откроется окно «Подключение к проекту». Введите адрес админки проекта в формате https://project_name.mindbox.ru — так, как его показывает браузер, — и нажмите «Продолжить». После этого откроется вход в Mindbox.

mcp-connect-codex-access

Если вы работаете с несколькими проектами

Подключение работает с одним проектом — тем, адрес которого вы указали при входе. Чтобы перейти на другой проект, сбросьте авторизацию MCP и пройдите вход заново, указав адрес нужного проекта. Если другой проект открывается под другой учетной записью Mindbox, сначала выйдите из Mindbox в браузере. В зависимости от AI-клиента сбросить авторизацию можно вручную в настройках коннектора или сервера либо попросить агента.

Шаг 2. Подключите Mindbox к AI-клиенту

mcp-connect-claude-member

  1. Откройте Customize в левой боковой панели → Connectors.
  2. Нажмите Add → Add custom connector.
  3. Введите название Mindbox и URL из шага 1. Если окно предложит настройки авторизации, оставьте их по умолчанию. Нажмите Add.
  4. Нажмите Connect. В браузере откроется окно «Подключение к проекту»: введите адрес админки и нажмите «Продолжить». Если вы уже авторизованы в Mindbox, вход пройдет автоматически.
  5. На экране «Разрешить доступ» проверьте, что доступ запрашивает Claude, и нажмите «Разрешить доступ».
  6. Откройте новый чат.
  1. В приложении ChatGPT для компьютера откройте Settings → MCP servers и нажмите Add server.
  2. Выберите Streamable HTTP, введите имя mindbox и URL из шага 1, сохраните.
  3. Нажмите Restart, затем Authenticate рядом с сервером.
  4. В браузере откроется окно «Подключение к проекту»: введите адрес админки и нажмите «Продолжить». На экране «Разрешить доступ» нажмите «Разрешить доступ».
  5. Откройте новый чат.

Настройки MCP общие для приложения ChatGPT и Codex CLI: сервер, добавленный в одном месте, доступен в другом.

Как подключить через Codex CLI

Выполните в терминале и пройдите вход в браузере:

codex mcp add mindbox --url ВСТАВЬТЕ_СЮДА_URL
codex mcp login mindbox

Чтобы проверить подключение, спросите в новом чате: «Какие инструменты Mindbox тебе доступны?» Агент перечислит инструменты для сценариев, фильтров, рассылок и отчетов. Если агент отвечает, что не видит Mindbox, проверьте, что коннектор или сервер включен.

Как настроить подтверждение действий агента

Рекомендуем разрешить без подтверждения инструменты, которые только читают данные, и оставить подтверждение для инструментов, которые что-то меняют. Так перед каждым изменением вы увидите, что собирается сделать агент.

  • Claude: «Customize» → «Connectors» → Mindbox → «Tool permissions». Для каждого инструмента выберите «Always allow», «Needs approval» или «Blocked».
  • ChatGPT и Codex: в файле ~/.codex/config.toml (в Windows — %USERPROFILE%\.codex\config.toml) найдите раздел [mcp_servers.mindbox] и добавьте в него строку default_tools_approval_mode = "writes". Режим writes спрашивает подтверждение для всех инструментов, которые не помечены как только читающие. Режим approve выполняет все действия без подтверждения — на рабочем проекте его не используйте. Можно не править файл самому, а попросить об этом агента.

Шаг 3. Установите плагин Mindbox

Скилл — это инструкция, которая учит агента конкретной работе. Плагин — набор скиллов, который устанавливается одной кнопкой. Без скиллов агент тоже выполнит задачу, но дольше и с большим числом ошибок.

Скиллы Mindbox собраны в плагин mindbox. Плагин опубликован в репозитории Mindbox на GitHub. Аккаунт на GitHub не нужен. Описание в репозитории на английском и рассчитано на разработчиков — устанавливайте по шагам ниже.

  1. Откройте Customize → Plugins и нажмите Add → Add marketplace.

    mcp-connect-claude-plugins-menu

  2. В поле URL введите mindbox-cloud/agent-skills и выберите вариант «Use "mindbox-cloud/agent-skills"».

  3. Оставьте включенной опцию Sync automatically — так плагин будет обновляться сам. Нажмите Sync.

    mcp-connect-claude-plugins

  4. В списке плагинов найдите mindbox и установите его.

  5. Откройте новый чат.

На бесплатном тарифе плагины недоступны. Скиллы можно загрузить вручную архивами в Customize → Skills → + → Upload a skill, но пока не все скиллы Mindbox проходят загрузку. Без скиллов агент тоже работает с Mindbox, но дольше и с большим числом ошибок. В Team и Enterprise в организации должны быть включены скиллы и Cowork, это делает владелец организации.

  1. Напишите в новом чате приложения ChatGPT для компьютера или выполните в терминале:

    codex plugin marketplace add mindbox-cloud/agent-skills

  2. Перезапустите приложение.

  3. Откройте вкладку Plugins, найдите плагин mindbox и нажмите +.

  4. Откройте новый чат.

В Business и Enterprise администратор воркспейса может добавить плагин сразу для всех: «Admin» → «Plugins» → «Add» → «Import marketplace» → mindbox-cloud/agent-skills.

Чтобы проверить установку, спросите в новом чате: «Какие скиллы Mindbox тебе доступны?» В ответе должны быть скиллы из плагина mindbox.

Что дальше

Предыдущая
Как дать согласие на использование Mindbox AI
Следующая
Как создавать и проверять сценарии через AI-ассистента