MCP-сервер для Mindbox CDP

mindbox-mcp

MCP-сервер для CDP-платформы Mindbox: профили клиентов, подписки, заказы, сегменты и произвольные операции API

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mindbox-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

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

claude mcp add --transport stdio --env 'MINDBOX_API_KEY=<ваш MINDBOX_API_KEY>' --env 'MINDBOX_ENDPOINT_ID=<значение MINDBOX_ENDPOINT_ID>' mindbox-mcp -- npx -y @theyahia/mindbox-mcp@1.2.0

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "mindbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mindbox-mcp@1.2.0"
      ],
      "env": {
        "MINDBOX_API_KEY": "<ваш MINDBOX_API_KEY>",
        "MINDBOX_ENDPOINT_ID": "<значение MINDBOX_ENDPOINT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "mindbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mindbox-mcp@1.2.0"
      ],
      "env": {
        "MINDBOX_API_KEY": "<ваш MINDBOX_API_KEY>",
        "MINDBOX_ENDPOINT_ID": "<значение MINDBOX_ENDPOINT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

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

code --add-mcp '{"name":"mindbox-mcp","type":"stdio","command":"npx","args":["-y","@theyahia/mindbox-mcp@1.2.0"],"env":{"MINDBOX_API_KEY":"<ваш MINDBOX_API_KEY>","MINDBOX_ENDPOINT_ID":"<значение MINDBOX_ENDPOINT_ID>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "mindbox-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mindbox-mcp@1.2.0"
      ],
      "env": {
        "MINDBOX_API_KEY": "<ваш MINDBOX_API_KEY>",
        "MINDBOX_ENDPOINT_ID": "<значение MINDBOX_ENDPOINT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

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

codex mcp add mindbox-mcp --env 'MINDBOX_API_KEY=<ваш MINDBOX_API_KEY>' --env 'MINDBOX_ENDPOINT_ID=<значение MINDBOX_ENDPOINT_ID>' -- npx -y @theyahia/mindbox-mcp@1.2.0

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.mindbox-mcp]
command = "npx"
args = ["-y", "@theyahia/mindbox-mcp@1.2.0"]
env = { MINDBOX_API_KEY = "<ваш MINDBOX_API_KEY>", MINDBOX_ENDPOINT_ID = "<значение MINDBOX_ENDPOINT_ID>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "mindbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mindbox-mcp@1.2.0"
      ],
      "env": {
        "MINDBOX_API_KEY": "<ваш MINDBOX_API_KEY>",
        "MINDBOX_ENDPOINT_ID": "<значение MINDBOX_ENDPOINT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "mindbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mindbox-mcp@1.2.0"
      ],
      "env": {
        "MINDBOX_API_KEY": "<ваш MINDBOX_API_KEY>",
        "MINDBOX_ENDPOINT_ID": "<значение MINDBOX_ENDPOINT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "mindbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mindbox-mcp@1.2.0"
      ],
      "env": {
        "MINDBOX_API_KEY": "<ваш MINDBOX_API_KEY>",
        "MINDBOX_ENDPOINT_ID": "<значение MINDBOX_ENDPOINT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "mindbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mindbox-mcp@1.2.0"
      ],
      "env": {
        "MINDBOX_API_KEY": "<ваш MINDBOX_API_KEY>",
        "MINDBOX_ENDPOINT_ID": "<значение MINDBOX_ENDPOINT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "mindbox-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@theyahia/mindbox-mcp@1.2.0"
      ],
      "environment": {
        "MINDBOX_API_KEY": "<ваш MINDBOX_API_KEY>",
        "MINDBOX_ENDPOINT_ID": "<значение MINDBOX_ENDPOINT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "mindbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mindbox-mcp@1.2.0"
      ],
      "env": {
        "MINDBOX_API_KEY": "<ваш MINDBOX_API_KEY>",
        "MINDBOX_ENDPOINT_ID": "<значение MINDBOX_ENDPOINT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "mindbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mindbox-mcp@1.2.0"
      ],
      "env": {
        "MINDBOX_API_KEY": "<ваш MINDBOX_API_KEY>",
        "MINDBOX_ENDPOINT_ID": "<значение MINDBOX_ENDPOINT_ID>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

MINDBOX_API_KEYсекрет, обязательная: Секретный ключ API Mindbox (server-side secretKey). Также принимается MINDBOX_SECRET_KEY.
MINDBOX_ENDPOINT_IDобязательная: ID точки интеграции (endpointId) в Mindbox.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 7ebe297.

Текст для агента

Получи MINDBOX_API_KEY и MINDBOX_ENDPOINT_ID в настройках проекта Mindbox и подключи сервер командой claude mcp add mindbox -e MINDBOX_API_KEY=ваш_ключ -e MINDBOX_ENDPOINT_ID=ваш_endpoint_id -- npx -y @theyahia/mindbox-mcp.

Другие способы из описания автора

{
  "mcpServers": {
    "mindbox": {
      "command": "npx",
      "args": ["-y", "@theyahia/mindbox-mcp"],
      "env": {
        "MINDBOX_API_KEY": "ваш_ключ",
        "MINDBOX_ENDPOINT_ID": "ваш_endpoint_id"
      }
    }
  }
}

Стандартная запись для claude_desktop_config.json.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает агенту шесть инструментов для Mindbox: профиль клиента и его подписки, заказы, проверку принадлежности к сегменту, список товаров и универсальный вызов run_operation для операций, которых нет среди типовых инструментов. Запросы идут на api.mindbox.ru с идемпотентностью через transactionId и повторами с backoff. Важная деталь: системные имена операций Mindbox настраиваются индивидуально в каждом проекте заказчика и не относятся к универсальным встроенным методам, поэтому имена вроде Website.GetCustomerInfo это лишь распространенная конвенция, которую должен создать администратор проекта.

Для кого. Для маркетологов и разработчиков, которые используют Mindbox как CDP и хотят поднимать профили и сегменты клиентов через агента без выгрузки в Excel.

Подходит, если

Нужно быстро посмотреть, что покупал клиент по email, без захода в интерфейс Mindbox
Нужно проверить, попадает ли клиент в конкретный сегмент
Нужен произвольный вызов операции Mindbox, настроенной в вашем проекте

Не подходит, если

Системные имена операций в вашем проекте Mindbox не настроены: сервер вернет ProtocolError на дефолтные имена из примеров
Нужны массовые изменения профилей клиентов без проверки: run_operation выполняет ровно то, что настроено в проекте, включая необратимые операции

Пример запроса к агенту

Покажи историю заказов клиента с этим email и проверь, входит ли он в сегмент постоянных покупателей

Ограничения

Имена операций (`operation`) не универсальны: их настраивает администратор проекта Mindbox, дефолты из README вроде Website.GetCustomerInfo сработают только если такая операция создана в вашем проекте. По умолчанию HTTP-режим слушает только 127.0.0.1, для работы за прокси нужно вручную открыть хост и указать MINDBOX_HTTP_ALLOWED_HOSTS для защиты от DNS-rebinding. Это неофициальный проект сообщества.

Как отключить. Удалите сервер из конфигурации MCP клиента, например claude mcp remove mindbox в Claude Code.

MCP

Транспорт: stdio, http
Авторизация: API-ключ

Переменные окружения
Переменные окружения
MINDBOX_API_KEY обязательная, секрет	Секретный ключ Mindbox из настроек проекта.
MINDBOX_ENDPOINT_ID обязательная	Идентификатор endpoint проекта Mindbox.

Проверка безопасности

Дает доступ к профилям и заказам клиентов
run_operation может выполнить любую операцию, настроенную в проекте, включая изменение данных

Коротко о README

README на русском объясняет модель авторизации Mindbox через заголовок secretKey и разницу между синхронными и асинхронными эндпоинтами API, дает инструкции подключения для Claude Desktop, Claude Code, Docker и Smithery, таблицу переменных окружения и предупреждение про индивидуальную настройку системных имен операций в каждом проекте.

Частые вопросы

run_operation вызывает любую операцию Mindbox?

Только те, что настроены в вашем проекте под конкретным системным именем, универсального списка методов у Mindbox нет.

Можно вызывать асинхронные операции?

Да, run_operation с mode: "async" отправляет fire-and-forget события вроде просмотра или добавления в корзину.

Salesforce DX MCP Server

Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск483

Скиллы Яндекс.Кит для управления магазином

kit-skills

Официальный

Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex

ПлагинВысокий рискРоссийский стекБез VPN28

YouGile MCP от Indalo

YouGile MCP

Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверВысокий рискРоссийский стекБез VPN

MCP-сервер портала Битрикс24

Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверВысокий рискРоссийский стекБез VPN

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

Частые вопросы

Похожие

Salesforce DX MCP Server

Скиллы Яндекс.Кит для управления магазином

YouGile MCP от Indalo

MCP-сервер портала Битрикс24