Name: mcp-dev-brasil
Author: codespar

Проблема

ИИ-агенты могут писать код, анализировать данные и общаться. Но они не могут вести бизнес — принимать платежи, выставлять счета, отправлять товары или уведомлять клиентов. Особенно в Бразилии, где каждый сервис имеет свой собственный API, схему аутентификации и особенности.

Тем временем параллельно развиваются пять категорий агентской платежной инфраструктуры — протоколы оформления заказа, уровни авторизации, микроплатежные системы, фреймворки идентификации и инструменты эмиссии — и ни один из них не сочетается друг с другом должным образом.

MCP Dev Brasil устраняет оба этих разрыва. Традиционные бразильские сервисы + новые агентские платежные протоколы, доступные через единый интерфейс MCP.

Решение

MCP Brasil предоставляет ИИ-агентам типизированные инструменты для взаимодействия с бразильскими API и агентскими платежными протоколами. Каждый сервер обертывает реальный сервис — платежи, фискальные операции, логистику, обмен сообщениями, банковское дело, ERP, криптографию и теперь агентские протоколы — чтобы ваш агент мог выполнять полный бизнес-процесс.

🛒 Customer places order
  → 💳 Agent charges via Pix (Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal)
  → 📦 Agent generates shipping label (Melhor Envio)
  → 📱 Agent sends tracking via WhatsApp (Z-API)
  → 📊 Agent records in ERP (Omie)
  → 🏦 Agent reconciles balance (Stark Bank)

Шесть систем. Ноль вмешательств человека. Один агент.

Агентские платежные протоколы

"Этот мост больше похож на промежуточное ПО, чем на протокол." — Промежуточным ПО является MCP.

Три новых сервера, которые соединяют развивающийся стек агентских платежей:

Протокол	Сервер	Инструменты	Что он делает
Google UCP	`@codespar/mcp-ucp`	21	Универсальный коммерческий протокол — агентские покупки, корзина, оформление заказа, заказы, доставка, идентификация. Полный коммерческий стек Google для ИИ-агентов.
Stripe ACP	`@codespar/mcp-stripe-acp`	16	Агентский коммерческий протокол — оформление заказа ИИ-агентом, делегирование платежей, товары, счета. Работает в ChatGPT с более чем 1 млн продавцов Shopify.
x402	`@codespar/mcp-x402`	10	HTTP-нативные микроплатежи от Coinbase — когда агент сталкивается с 402, он оплачивает USDC в сетях Base/Solana и повторяет запрос. Чистый HTTP, без UI оформления заказа.
AP2	`@codespar/mcp-ap2`	13	Платежный протокол Google «агент-агенту» — авторизация, журналы аудита, ограниченные лимиты расходов. 60+ партнеров, включая Visa, Mastercard, Stripe, PayPal.

Спектр автономности

Каждый протокол находится на разном уровне автономности агента:

 Human-in-loop ◄──────────────────────────────► Fully autonomous

  ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐
  │   ACP   │   │   UCP   │   │   AP2   │   │   x402  │
  │ Stripe  │   │ Google  │   │ Google  │   │Coinbase │
  └─────────┘   └─────────┘   └─────────┘   └─────────┘
  User confirms   Commerce     User sets      No user.
  every purchase  lifecycle    rules, agent   Machine-to-
  in-chat         managed      acts within    machine at
                  by agent     budget/scope   HTTP layer

Стек конвергенции

Эти протоколы не конкурируют — они сходятся в слои:

┌─────────────────────────────────────────────┐
│  Application Layer        ACP / UCP         │  Chat UX, product discovery
├─────────────────────────────────────────────┤
│  Authorization Layer      AP2 / Mandates    │  Spend limits, audit trails
├─────────────────────────────────────────────┤
│  Tool Layer               MCP  ◄── WE ARE  │  Standardized agent tools
├─────────────────────────────────────────────┤
│  Settlement Layer         x402 / Pix / Card │  On-chain or traditional rails
└─────────────────────────────────────────────┘

CodeSpar находится на уровне инструментов — это промежуточное ПО, которое соединяет каждый протокол приложений, авторизации и расчетов через единый интерфейс.

Почему это важно

Agent needs to buy something
  ├── Full commerce?       → Google UCP (search → cart → checkout → delivery)
  ├── Retail checkout?     → Stripe ACP (create_checkout → complete_checkout)
  ├── API micropayment?    → x402 (pay_request → USDC $0.001 → data returned)
  ├── Agent-to-agent?      → AP2 (authorize_payment → execute_payment)
  └── Brazilian merchant?  → Asaas / Zoop / PagSeguro (traditional rails)

All via MCP. Same interface. One agent.

Быстрый старт — Агентские протоколы

# Google UCP — full agentic commerce (early access)
npx @codespar/mcp-ucp

# Stripe ACP — agentic checkout (test mode, free)
npx @codespar/mcp-stripe-acp

# x402 — HTTP micropayments (testnet, free)
npx @codespar/mcp-x402

# AP2 — agent authorization (early access)
npx @codespar/mcp-ap2

Быстрый старт

С Claude Desktop

Добавьте в ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_..."
      }
    },
    "zoop": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zoop"],
      "env": {
        "ZOOP_API_KEY": "your-api-key",
        "ZOOP_MARKETPLACE_ID": "your-marketplace-id"
      }
    }
  }
}

С любым MCP-клиентом

npx @codespar/mcp-stripe-acp   # Agentic Commerce Protocol
npx @codespar/mcp-x402         # HTTP micropayments
npx @codespar/mcp-ap2          # Agent authorization
npx @codespar/mcp-zoop         # Payments (marketplace, split)
npx @codespar/mcp-nuvem-fiscal # Fiscal
npx @codespar/mcp-melhor-envio # Logistics
npx @codespar/mcp-z-api        # WhatsApp
npx @codespar/mcp-omie         # ERP
npx @codespar/mcp-stark-bank   # Banking
npx @codespar/mcp-dev-brasil-api   # CEP, CNPJ (no key needed!)

Попробуйте сейчас (без API-ключа)

BrasilAPI — это бесплатный и публичный сервис. Попробуйте в своем терминале:

npx @codespar/mcp-dev-brasil-api

Затем спросите своего агента: "Какой адрес у CEP 01001-000?" или "Найди CNPJ 00.000.000/0001-91"

Полный цикл

Вот что отличает MCP Brasil — это не отдельные коннекторы, а полный бизнес-процесс по вертикалям:

Шаг	Вертикаль	Сервер	Что делает агент
1	💳 Платеж	Zoop	Создает запрос Pix, распределяет средства продавцам
2	📄 Фискальный	Nuvem Fiscal	Выпускает NFe/NFSe после подтверждения оплаты
3	📦 Логистика	Melhor Envio	Рассчитывает стоимость доставки, создает этикетку
4	📱 Сообщения	Z-API	Отправляет трек-код через WhatsApp
5	📊 ERP	Omie	Записывает заказ, обновляет инвентарь
6	🏦 Банкинг	Stark Bank	Сверяет баланс, создает отчеты

Для оркестрации всех 6 шагов с управлением, рабочими процессами утверждения и журналами аудита — используйте CodeSpar.

Серверы

⚡ Агентские протоколы (4 сервера)

Сервер	Инструменты	Описание	Аутентификация
Google UCP	21	Универсальный коммерческий протокол — покупки, корзина, оформление заказа, заказы, доставка, идентификация	UCP API Key
Stripe ACP	16	Агентский коммерческий протокол — сессии оформления заказа, делегирование платежей, товары, счета	Stripe API Key
x402	10	HTTP микроплатежи — USDC в Base/Solana, пейволлы, машина-машина	Facilitator Key
AP2	13	Авто

mcp-dev-brasil