Name: mcp-dev-brasil
Author: codespar

課題

AIエージェントはコードを書いたり、データを分析したり、チャットしたりすることはできますが、ビジネスを運営すること、つまり決済の回収、請求書の発行、商品の発送、顧客への通知などはできません。特にブラジルでは、サービスごとに独自のAPI、認証パターン、癖があるため、なおさら困難です。

一方で、チェックアウトプロトコル、認証レイヤー、マイクロ決済レール、IDフレームワーク、発行ツールといった5つのカテゴリーのエージェント型決済インフラが並行してリリースされていますが、それらは互いにうまく連携できていません。

MCP Dev Brasilは、この両方のギャップを埋めます。 ブラジルの伝統的なサービスと新しいエージェント型決済プロトコルを、単一のMCPインターフェースを通じて利用可能にします。

解決策

MCP Brasilは、AIエージェントがブラジルの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)

6つのシステム。人間の介入はゼロ。1つのエージェント。

エージェント型決済プロトコル

「このブリッジはプロトコルというよりミドルウェアのように見える」 — そのミドルウェアこそがMCPです。

新興のエージェント型決済スタックを橋渡しする3つの新しいサーバー：

プロトコル	サーバー	ツール数	機能
Google UCP	`@codespar/mcp-ucp`	21	Universal Commerce Protocol — エージェントによるショッピング、カート、チェックアウト、注文、配送、ID管理。AIエージェントのためのGoogleの完全なコマーススタック。
Stripe ACP	`@codespar/mcp-stripe-acp`	16	Agentic Commerce Protocol — AIエージェントによるチェックアウト、決済委任、商品、請求書。100万以上のShopify加盟店でChatGPT上で利用可能。
x402	`@codespar/mcp-x402`	10	CoinbaseによるHTTPネイティブなマイクロ決済 — エージェントが402エラーに遭遇した際、Base/Solana上でUSDCを支払いリトライする。純粋なHTTPで、チェックアウトUIは不要。
AP2	`@codespar/mcp-ap2`	13	GoogleのAgent-to-Agent決済プロトコル — 認証、監査証跡、スコープ付き支出制限。Visa、Mastercard、Stripe、PayPalを含む60以上のパートナーが参加。

自律性のスペクトル

各プロトコルは、エージェントの自律性の異なるレベルに位置しています：

 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はツールレイヤーに位置します — すべてのアプリケーション、認証、決済プロトコルを1つのインターフェースで接続するミドルウェアです。

なぜこれが重要なのか

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	Universal Commerce Protocol — ショッピング、カート、チェックアウト、注文、配送、ID管理	UCP APIキー
Stripe ACP	16	Agentic Commerce Protocol — チェックアウトセッション、決済委任、商品、請求書	Stripe APIキー
x402	10	HTTPマイクロ決済 — Base/Solana上のUSDC、ペイウォール、マシン間決済	Facilitatorキー
AP2	13	エージェント認証、監査証跡、スコープ付き支出制限	AP2 APIキー

💳 決済 (13サーバー)

サーバー	ツール数	説明	認証
Asaas	10	請求、Pix、Boleto、サブスクリプション、送金	APIキー
PagSeguro	10	注文、課金、Pix QR、返金	Bearerトークン
iugu	8	請求書、サブスクリプション、決済手段	Basic認証
Pix BCB	8	公式中央銀行Pix API (cob, DICT)	OAuth2 + mTLS
Zoop	20	マーケットプレイス決済、分割ルール、販売者、サブスクリプション	Basic認証
Pagar.me	10	注文、課金、受取人、送金	Basic認証
EBANX	7	国境を越えた決済、ペイアウト、為替レート	統合キー
EFÍ/Gerencianet	8	Pix、Boleto、Carnet、オープンファイナンス	OAuth2
Vindi	10	継続課金、サブスクリプション、請求書	APIキー
Cielo	8	クレジットカード、デビット、Boleto、継続決済	加盟店キー
Stone	8	オープンバンキング、決済、Pix、送金	OAuth2
Celcoin	8	Pix、Boleto、送金、請求書支払い、チャージ	OAuth2
AP2	13	GoogleのAgent-to-Agent決済プロトコル	AP2 APIキー

📄 会計 (3サーバー)

サーバー	ツール数	説明	認証
Focus NFe	8	NFe/NFSe/NFCe発行および管理	Basic認証
Nuvem Fiscal	10	NFe/NFSe/NFCe、CNPJ/CEP検索	OAuth2
Conta Azul	10	会計、請求、顧客、商品	OAuth2

📱 通信 (5サーバー)

サーバー	ツール数	説明	認証
Evolution API	10	WhatsApp自動化 (Baileys)	APIキー
Z-API	20	WhatsAppメッセージング、連絡先、グループ、ラベル	インスタンス + トークン
Zenvia	8	マルチチャネル (SMS, WhatsApp, RCS)	APIトークン
RD Station	8	マーケティング自動化、CRM、リード	Bearerトークン
Take Blip	8	チャットボット、メッセージング、連絡先、ブロードキャスト	アクセスキー

🇧🇷 ID (1サーバー)

サーバー	ツール数	説明	認証
BrasilAPI	10	CEP, CNPJ, 銀行, 祝日, FIPE, DDD, 天気	なし (無料)

🏦 銀行 (2サーバー)

サーバー	ツール数	説明	認証
Stark Bank	10	送金、Boleto、請求書、Pix、残高	アクセストークン
Open Finance	8	オープンファイナンス・ブラジル — 口座、取引、同意、投資	OAuth2

📦 Eコマース / 物流 (3サーバー)

サーバー	ツール数	説明	認証
Melhor Envio	18	送料見積もり、追跡、ラベル、カート、配送業者	Bearerトークン
Correios	6	追跡、送料計算、CEP	OAuth
VTEX	10	Eコマース、注文、商品、在庫、配送	アプリキー + トークン

📊 ERP (3サーバー)

サーバー	ツール数	説明	認証
Omie	10	顧客、商品、注文、請求書、財務	アプリキー + シークレット
Bling	10	ERP、商品、注文、請求書、在庫管理	OAuth2
Tiny	10	ERP、商品、注文、請求書、在庫、買掛金	APIトークン

🪙 暗号資産 / ステーブルコイン (5サーバー)

サーバー	ツール数	説明	認証
x402	10	HTTPマイクロ決済 — Base/Solana上のUSDC	Facilitatorキー
UnblockPay	10	法定通貨-ステーブルコインのオンランプ/オフランプ、ウォレット、送金	APIキー
Circle	10	USDC決済、ウォレット、ペイアウト、送金	APIキー
Mercado Bitcoin	10	ブラジルの暗号資産取引所、取引、オーダーブック、出金	APIキー + シークレット
Bitso	10	ラテンアメリカの暗号資産取引所、取引、資金調達、出金	APIキー + シークレット

🌎 ラテンアメリカ全域 (4サーバー)

サーバー	ツール数	説明	認証
Mercado Libre	14	ラテンアメリカのマーケットプレイス (18カ国) — 商品、注文、販売者、配送	OAuth2
Mercado Pago	12	ラテンアメリカの決済 — カード、PIX、チェックアウト、返金	Bearerトークン
Nubank	10	オープンファイナンス経由のブラジルのネオバンク — 口座、PIX、取引	OAuth2
Banco Inter	12	ブラジルのデジタル銀行 — Boleto、PIX、明細、送金	OAuth2

🇲🇽 メキシコ (6サーバー)

サーバー	ツール数	説明	認証
**[C

mcp-dev-brasil

課題

解決策