Name: mcp-dev-brasil
Author: codespar

문제점

AI 에이전트는 코드를 작성하고, 데이터를 분석하며, 대화할 수 있습니다. 하지만 결제 수금, 송장 발행, 제품 배송, 고객 알림 등 비즈니스를 직접 운영할 수는 없습니다. 특히 브라질의 경우 모든 서비스가 고유한 API, 인증 방식, 특이사항을 가지고 있어 더욱 어렵습니다.

한편, 결제 프로토콜, 인증 계층, 소액 결제 레일, 신원 프레임워크, 발행 도구 등 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개의 시스템. 사람의 개입 제로. 하나의 에이전트.

에이전트 결제 프로토콜

"이 브릿지는 프로토콜이라기보다 미들웨어처럼 보입니다." — 그 미들웨어가 바로 MCP입니다.

새롭게 떠오르는 에이전트 결제 스택을 연결하는 3개의 새로운 서버:

프로토콜	서버	도구	기능
Google UCP	`@codespar/mcp-ucp`	21	Universal Commerce Protocol — 에이전트 쇼핑, 장바구니, 결제, 주문, 배송, 신원 확인. 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의 에이전트 간 결제 프로토콜 — 인증, 감사 추적, 범위가 지정된 지출 한도. 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는 도구 계층에 위치합니다 — 모든 애플리케이션, 인증 및 결제 프로토콜을 단일 인터페이스로 연결하는 미들웨어입니다.

이것이 중요한 이유

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 — 쇼핑, 장바구니, 결제, 주문, 배송, 신원 확인	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, 볼레토, 구독, 이체	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, 볼레토, 할부, 오픈 파이낸스	OAuth2
Vindi	10	정기 결제, 구독, 송장	API 키
Cielo	8	신용카드, 직불카드, 볼레토, 정기 결제	가맹점 키
Stone	8	오픈 뱅킹, 결제, Pix, 이체	OAuth2
Celcoin	8	Pix, 볼레토, 이체, 공과금 납부, 충전	OAuth2
AP2	13	Google의 에이전트 간 결제 프로토콜	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	챗봇, 메시징, 연락처, 브로드캐스트	액세스 키

🇧🇷 신원 확인 (1개 서버)

서버	도구	설명	인증
BrasilAPI	10	CEP, CNPJ, 은행, 공휴일, FIPE, DDD, 날씨	없음 (무료)

🏦 금융 (2개 서버)

서버	도구	설명	인증
Stark Bank	10	이체, 볼레토, 송장, Pix, 잔액	액세스 토큰
Open Finance	8	오픈 파이낸스 브라질 — 계좌, 거래, 동의, 투자	OAuth2

📦 이커머스 / 물류 (3개 서버)

서버	도구	설명	인증
Melhor Envio	18	배송 견적, 추적, 라벨, 장바구니, 대행사	Bearer 토큰
Correios	6	추적, 배송 계산, CEP	OAuth
VTEX	10	이커머스, 주문, 제품, 재고, 배송	앱 키 + 토큰

📊 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	LATAM 마켓플레이스 (18개국) — 제품, 주문, 판매자, 배송	OAuth2
Mercado Pago	12	LATAM 결제 — 카드, PIX, 결제, 환

mcp-dev-brasil

문제점

해결책