About io.github.theYahia/mindbox-mcp
io.github.theYahia/mindbox-mcp is an MCP server in the Files category: mCP server for Mindbox CDP API — customer profiles, orders, segments. 3 tools.
Install
claude mcp add io-github-theyahia-mindbox-mcp -- npx -y @theyahia/mindbox-mcpnpx -y @theyahia/mindbox-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about io.github.theYahia/mindbox-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
@theyahia/mindbox-mcp
MCP-сервер для API Mindbox CDP — профили клиентов, заказы, сегменты, списки товаров и произвольные операции.
Возможности
- 6 инструментов для работы с Mindbox API
- Транспорт: stdio (по умолчанию) и Streamable HTTP (
--http) - Совместимость с Claude Desktop, Claude Code, Cursor, Smithery
- Skills для автоматизации типовых сценариев
Установка
Claude Desktop
{
"mcpServers": {
"mindbox": {
"command": "npx",
"args": ["-y", "@theyahia/mindbox-mcp"],
"env": {
"MINDBOX_API_KEY": "ваш_ключ",
"MINDBOX_ENDPOINT_ID": "ваш_endpoint_id"
}
}
}
}
Claude Code
claude mcp add mindbox -e MINDBOX_API_KEY=ваш_ключ -e MINDBOX_ENDPOINT_ID=ваш_endpoint_id -- npx -y @theyahia/mindbox-mcp
Streamable HTTP
MINDBOX_API_KEY=ваш_ключ MINDBOX_ENDPOINT_ID=ваш_endpoint_id npx @theyahia/mindbox-mcp --http
# MCP endpoint: http://localhost:3000/mcp
# Health check: http://localhost:3000/health
Порт настраивается через PORT (по умолчанию 3000).
Smithery
Файл smithery.yaml включён. Требуемые параметры: MINDBOX_API_KEY, MINDBOX_ENDPOINT_ID.
Авторизация
| Переменная | Описание |
|---|---|
MINDBOX_API_KEY |
Секретный ключ API Mindbox (также принимает MINDBOX_SECRET_KEY) |
MINDBOX_ENDPOINT_ID |
ID эндпоинта в Mindbox |
Заголовок авторизации: Authorization: Mindbox secretKey="...".
Инструменты (6)
| Инструмент | Описание |
|---|---|
get_customer |
Получение профиля клиента по email/телефону/ID |
create_order |
Создание заказа с привязкой к клиенту |
get_segments |
Получение сегментов клиента |
get_product_list |
Получение списка товаров |
update_customer |
Обновление профиля клиента |
run_operation |
Выполнение произвольной операции Mindbox API |
Skills
| Скилл | Описание | Триггер |
|---|---|---|
skill-customer-search |
Поиск клиента в Mindbox | "Найди клиента в Mindbox" |
skill-segment-stats |
Статистика сегментов | "Статистика сегментов" |
Примеры запросов
Найди клиента с email user@example.com
Создай заказ для клиента с телефоном +7900...
Какие сегменты у клиента user@example.com?
Покажи список товаров
Обнови имя клиента с ID 12345
Выполни операцию Custom.GetData с телом {"key": "value"}
Разработка
npm install
npm run dev # stdio
npm run dev:http # HTTP на порту 3000
npm test # Vitest
Лицензия
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.