# mcp-zoop

Подключает платежи бразильской платформы Zoop к ИИ-агентам. Позволяет оформлять чеки Pix, делить выручку между продавцами и отслеживать трансферы.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Автор: codespar
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/zoop
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/mcp-zoop

## Что делает

Сервер открывает ассистенту 28 инструментов для взаимодействия с API Zoop. С его помощью агент создаёт транзакции через Pix, карты или boleto, регистрирует покупателей и продавцов маркетплейса, а также токенизирует карты. Поддерживаются правила разделения платежей между продавцами, оформление возвратов и контроль подписок.

Управление выплатами вынесено в отдельные методы. Агент может проверять баланс продавца, запрашивать списки переводов на банковские счета и следить за спорами по чарджбэкам.

Для запуска понадобятся `ZOOP_API_KEY` и `ZOOP_MARKETPLACE_ID`. Без валидного ключа авторизация через Basic Auth отклонится, поэтому для отладки стоит заранее включить sandbox в кабинете разработчика.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ZOOP_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mcp-zoop -e ZOOP_API_KEY=<ZOOP_API_KEY> -- npx -y @codespar/mcp-zoop
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add zoop --env ZOOP_API_KEY=<ZOOP_API_KEY> -- npx -y @codespar/mcp-zoop
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zoop": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-zoop"
            ],
            "env": {
                "ZOOP_API_KEY": "<ZOOP_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "zoop": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-zoop"
            ],
            "env": {
                "ZOOP_API_KEY": "<ZOOP_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ZOOP_API_KEY=<ZOOP_API_KEY> zoop npx -y @codespar/mcp-zoop
```
Вместо <…> подставьте свои значения

## Когда брать
- делить платежи покупателей между несколькими продавцами по правилам сплита
- формировать транзакции и QR-коды для оплаты через Pix
- выводить средства на банковские счета продавцов маркетплейса
- отслеживать чарджбэки и балансы продавцов через чат с моделью

## Примеры запросов агенту
- Сделай сплит-платёж по Pix на 150 BRL и раздели сумму между продавцами `seller_1` и `seller_2`
- Проверь баланс продавца `sel_987` и создай перевод на его банковский счёт
- Покажи список открытых диспутов по транзакциям за последний месяц

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44583
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5458
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2188
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

Из того же набора: [codespar/mcp-dev-latam](https://affpapa.org/nevibecode/by/codespar/mcp-dev-latam.md) — 124 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md