mcp-zoop — MCP-сервер для Claude Code: что делает и как установить
Подключает платежи бразильской платформы Zoop к ИИ-агентам. Позволяет оформлять чеки Pix, делить выручку между продавцами и отслеживать трансферы.
claude mcp add mcp-zoop -e ZOOP_API_KEY=<ZOOP_API_KEY> -- npx -y @codespar/mcp-zoopЧто делает mcp-zoop
Сервер открывает ассистенту 28 инструментов для взаимодействия с API Zoop. С его помощью агент создаёт транзакции через Pix, карты или boleto, регистрирует покупателей и продавцов маркетплейса, а также токенизирует карты. Поддерживаются правила разделения платежей между продавцами, оформление возвратов и контроль подписок.
Управление выплатами вынесено в отдельные методы. Агент может проверять баланс продавца, запрашивать списки переводов на банковские счета и следить за спорами по чарджбэкам.
Для запуска понадобятся ZOOP_API_KEY и ZOOP_MARKETPLACE_ID. Без валидного ключа авторизация через Basic Auth отклонится, поэтому для отладки стоит заранее включить sandbox в кабинете разработчика.
Какие задачи решает
- делить платежи покупателей между несколькими продавцами по правилам сплита
- формировать транзакции и QR-коды для оплаты через Pix
- выводить средства на банковские счета продавцов маркетплейса
- отслеживать чарджбэки и балансы продавцов через чат с моделью
Примеры запросов агенту
- Сделай сплит-платёж по Pix на 150 BRL и раздели сумму между продавцами
seller_1иseller_2 - Проверь баланс продавца
sel_987и создай перевод на его банковский счёт - Покажи список открытых диспутов по транзакциям за последний месяц
Как установить mcp-zoop
Командой платформы
claude mcp add mcp-zoop -e ZOOP_API_KEY=<ZOOP_API_KEY> -- npx -y @codespar/mcp-zoopВместо <…> подставьте свои значения
Командой платформы
codex mcp add zoop --env ZOOP_API_KEY=<ZOOP_API_KEY> -- npx -y @codespar/mcp-zoopВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"zoop": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-zoop"
],
"env": {
"ZOOP_API_KEY": "<ZOOP_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"zoop": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-zoop"
],
"env": {
"ZOOP_API_KEY": "<ZOOP_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ZOOP_API_KEY=<ZOOP_API_KEY> zoop npx -y @codespar/mcp-zoopВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-zoop
Как установить mcp-zoop в Claude Code?
Выполните в терминале команду claude mcp add mcp-zoop -e ZOOP_API_KEY=<ZOOP_API_KEY> -- npx -y @codespar/mcp-zoop. Ключ скопируйте в панели управления Zoop.
Что делает MCP-сервер mcp-zoop?
Он предоставляет набор из 28 функций для прямого вызова API Zoop. Модель сможет оформлять платежи, токенизировать карты, регистрировать продавцов и управлять подписками.
Какие переменные окружения нужны для работы?
Требуются ZOOP_API_KEY и ZOOP_MARKETPLACE_ID. Сервер передаёт ключ через Basic Auth, где логином выступает сам API-ключ, а пароль остаётся пустым.
