MCP-сервер для Mindbox CDP
mindbox-mcp
MCP-сервер для CDP-платформы Mindbox: профили клиентов, подписки, заказы, сегменты и произвольные операции API
- 4 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Дает доступ к профилям и заказам клиентов
- run_operation может выполнить любую операцию, настроенную в проекте, включая изменение данных
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mindbox-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Дает доступ к профилям и заказам клиентов
- run_operation может выполнить любую операцию, настроенную в проекте, включая изменение данных
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту шесть инструментов для Mindbox: профиль клиента и его подписки, заказы, проверку принадлежности к сегменту, список товаров и универсальный вызов run_operation для операций, которых нет среди типовых инструментов. Запросы идут на api.mindbox.ru с идемпотентностью через transactionId и повторами с backoff. Важная деталь: системные имена операций Mindbox настраиваются индивидуально в каждом проекте заказчика и не относятся к универсальным встроенным методам, поэтому имена вроде Website.GetCustomerInfo это лишь распространенная конвенция, которую должен создать администратор проекта.
Для кого. Для маркетологов и разработчиков, которые используют Mindbox как CDP и хотят поднимать профили и сегменты клиентов через агента без выгрузки в Excel.
Подходит, если
- Нужно быстро посмотреть, что покупал клиент по email, без захода в интерфейс Mindbox
- Нужно проверить, попадает ли клиент в конкретный сегмент
- Нужен произвольный вызов операции Mindbox, настроенной в вашем проекте
Не подходит, если
- Системные имена операций в вашем проекте Mindbox не настроены: сервер вернет ProtocolError на дефолтные имена из примеров
- Нужны массовые изменения профилей клиентов без проверки: run_operation выполняет ровно то, что настроено в проекте, включая необратимые операции
Пример запроса к агенту
Покажи историю заказов клиента с этим email и проверь, входит ли он в сегмент постоянных покупателейMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
MINDBOX_API_KEYобязательная, секрет- Секретный ключ Mindbox из настроек проекта.
MINDBOX_ENDPOINT_IDобязательная- Идентификатор endpoint проекта Mindbox.
Ограничения
Имена операций (`operation`) не универсальны: их настраивает администратор проекта Mindbox, дефолты из README вроде Website.GetCustomerInfo сработают только если такая операция создана в вашем проекте. По умолчанию HTTP-режим слушает только 127.0.0.1, для работы за прокси нужно вручную открыть хост и указать MINDBOX_HTTP_ALLOWED_HOSTS для защиты от DNS-rebinding. Это неофициальный проект сообщества.
Как отключить. Удалите сервер из конфигурации MCP клиента, например claude mcp remove mindbox в Claude Code.
Частые вопросы
run_operation вызывает любую операцию Mindbox?
Только те, что настроены в вашем проекте под конкретным системным именем, универсального списка методов у Mindbox нет.
Можно вызывать асинхронные операции?
Да, run_operation с mode: "async" отправляет fire-and-forget события вроде просмотра или добавления в корзину.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыRetailCRM MCP
retailcrm-mcp
MCP-сервер RetailCRM: заказы, клиенты, товары, остатки, оплаты, задачи и аналитика магазина через API v5
Открытая CRM для малых команд с MCP: контакты, сделки и задачи доступны Claude и другим агентам, черновики ответов за вами
Минимальный MCP-сервер для amoCRM API v4: чтение и создание сделок, контактов и примечаний, OAuth2 и долгосрочный токен
MCP-сервер InSales
insales-mcp
MCP-сервер для платформы интернет-магазинов InSales: товары, заказы, клиенты и категории через админ API
Набор MCP-серверов для Wildberries, Ozon, Яндекс Маркета, Битрикс24, amoCRM, Авито, Директа, Метрики, Вебмастера и DaData, локально бесплатно
MCP-сервер для YCLIENTS
YCLIENTS MCP Server
MCP-сервер для YCLIENTS с более чем 30 инструментами: компании, услуги, сотрудники, клиенты, записи, онлайн-запись и аналитика
Коротко о README
README на русском объясняет модель авторизации Mindbox через заголовок secretKey и разницу между синхронными и асинхронными эндпоинтами API, дает инструкции подключения для Claude Desktop, Claude Code, Docker и Smithery, таблицу переменных окружения и предупреждение про индивидуальную настройку системных имен операций в каждом проекте.