mcp-dev-brasil
问题所在
AI 代理可以编写代码、分析数据和聊天。但它们无法经营业务——收款、开具发票、发货或通知客户。尤其是在巴西,每个服务都有自己的 API、身份验证模式和特性。
与此同时,五类代理支付基础设施正在并行发展——结账协议、授权层、微支付渠道、身份框架和发行工具——而且它们之间无法很好地兼容。
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)六个系统。零人工干预。一个代理。
代理支付协议
“这个桥接看起来更像是中间件,而不是协议。” — 中间件就是 MCP。
三个连接新兴代理支付堆栈的新服务器:
协议 | 服务器 | 工具 | 功能 |
| 21 | 通用商业协议 (Universal Commerce Protocol) — 代理购物、购物车、结账、订单、交付、身份验证。Google 为 AI 代理提供的完整商业堆栈。 | |
| 16 | 代理商业协议 (Agentic Commerce Protocol) — AI 代理结账、支付委托、产品、发票。在 ChatGPT 中与超过 100 万 Shopify 商户实时运行。 | |
| 10 | Coinbase 的 HTTP 原生微支付 — 当代理遇到 402 错误时,它会在 Base/Solana 上支付 USDC 并重试。纯 HTTP,无需结账 UI。 | |
| 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 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
21 | 通用商业协议 — 购物、购物车、结账、订单、交付、身份验证 | UCP API 密钥 | |
16 | 代理商业协议 — 结账会话、支付委托、产品、发票 | Stripe API 密钥 | |
10 | HTTP 微支付 — Base/Solana 上的 USDC,付费墙,机器对机器 | 协调器密钥 | |
13 | 代理授权、审计追踪、范围化支出限额 | AP2 API 密钥 |
💳 支付 (13 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
10 | 账单、Pix、boleto、订阅、转账 | API 密钥 | |
10 | 订单、收费、Pix 二维码、退款 | Bearer Token | |
8 | 发票、订阅、支付方式 | Basic Auth | |
8 | 官方中央银行 Pix API (cob, DICT) | OAuth2 + mTLS | |
20 | 市场支付、分账规则、卖家、订阅 | Basic Auth | |
10 | 订单、收费、收款人、转账 | Basic Auth | |
7 | 跨境支付、付款、汇率 | 集成密钥 | |
8 | Pix、boleto、分期付款、开放金融 | OAuth2 | |
10 | 循环计费、订阅、发票 | API 密钥 | |
8 | 信用卡、借记卡、boleto、循环支付 | 商户密钥 | |
8 | 开放银行、支付、Pix、转账 | OAuth2 | |
8 | Pix、boleto、转账、账单支付、充值 | OAuth2 | |
13 | Google 的代理对代理支付协议 | AP2 API 密钥 |
📄 税务 (3 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
8 | NFe/NFSe/NFCe 开具与管理 | Basic Auth | |
10 | NFe/NFSe/NFCe,CNPJ/CEP 查询 | OAuth2 | |
10 | 会计、开票、客户、产品 | OAuth2 |
📱 通信 (5 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
10 | WhatsApp 自动化 (Baileys) | API 密钥 | |
20 | WhatsApp 消息、联系人、群组、标签 | 实例 + Token | |
8 | 多渠道 (SMS, WhatsApp, RCS) | API Token | |
8 | 营销自动化、CRM、潜在客户 | Bearer Token | |
8 | 聊天机器人、消息、联系人、广播 | 访问密钥 |
🇧🇷 身份验证 (1 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
10 | CEP, CNPJ, 银行, 节假日, FIPE, DDD, 天气 | 无 (免费) |
🏦 银行 (2 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
10 | 转账、boleto、发票、Pix、余额 | 访问 Token | |
8 | 巴西开放金融 — 账户、交易、同意、投资 | OAuth2 |
📦 电子商务 / 物流 (3 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
18 | 运费报价、追踪、标签、购物车、代理机构 | Bearer Token | |
6 | 追踪、运费计算、CEP | OAuth | |
10 | 电子商务、订单、产品、库存、物流 | App Key + Token |
📊 ERP (3 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
10 | 客户、产品、订单、发票、财务 | App Key + Secret | |
10 | ERP、产品、订单、发票、库存管理 | OAuth2 | |
10 | ERP、产品、订单、发票、库存、应付账款 | API Token |
🪙 加密货币 / 稳定币 (5 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
10 | HTTP 微支付 — Base/Solana 上的 USDC | 协调器密钥 | |
10 | 法币到稳定币的入金/出金、钱包、转账 | API 密钥 | |
10 | USDC 支付、钱包、付款、转账 | API 密钥 | |
10 | 巴西加密货币交易所、交易、订单簿、提现 | API Key + Secret | |
10 | 拉丁美洲加密货币交易所、交易、资金、提现 | API Key + Secret |
🌎 拉丁美洲通用 (4 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
14 | 拉丁美洲市场 (18 个国家) — 产品、订单、卖家、发货 | OAuth2 | |
12 | 拉丁美洲支付 — 卡、PIX、结账、退款 | Bearer Token | |
10 | 通过开放金融实现的巴西新银行 — 账户、PIX、交易 | OAuth2 | |
12 | 巴西数字银行 — boleto、PIX、对账单、转账 | OAuth2 |
🇲🇽 墨西哥 (6 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
10 | 支付网关 — 卡、OXXO 现金、SPEI | Basic Auth | |
10 | CFDI 电子发票 (墨西哥 NFe) | Bearer Token | |
8 | 即时银行转账 (墨西哥的 PIX) | API 密钥 | |
10 | 多承运商物流 (Estafeta, DHL, FedEx) | Bearer Token | |
10 | 云 ERP | API 密钥 | |
10 | 开放金融聚合器 (MX/AR/CO) | Basic Auth |
🇦🇷 阿根廷 (5 个服务器)
服务器 | 工具 | 描述 | 身份验证 |
**[AFIP](packages/argentina |
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/codespar/mcp-dev-brasil'
If you have feedback or need assistance with the MCP directory API, please join our Discord server