mcpField
M
mcp-pagbrasil

mcp-pagbrasil

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-pagbrasil

mcp-pagbrasil 是 PagBrasil 的 MCP 服务，PagBrasil 是面向向巴西销售的境外商户的跨境收单机构。它让 AI Agent 通过工具创建订单、查询状态和发起退款，并与 PagBank/PagSeguro 相区分。

主要功能

  1. 01创建订单并发起付款请求
  2. 02支持 Pix、Boleto Flash、PEC Flash 与分期信用卡
  3. 03查询订单当前状态以确认结算
  4. 04按金额部分或全额退款
  5. 05以原始 XML 形式返回接口响应

适用场景

  1. 01为巴西买家生成 Pix 付款码或 Boleto 账单
  2. 02轮询订单状态以判断付款是否已结算
  3. 03在智能体流程中处理部分或全额退款

MCP 相关

该服务向 MCP 客户端暴露 create_order、get_order 和 refund_order 三个工具，分别对应 PagBrasil 的订单创建、查询和退款接口。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-pagbrasil": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-pagbrasil"
      ],
      "env": {
        "PAGBRASIL_PBTOKEN": "<PAGBRASIL_PBTOKEN>",
        "PAGBRASIL_SECRET": "<PAGBRASIL_SECRET>",
        "PAGBRASIL_BASE_URL": "<PAGBRASIL_BASE_URL>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-pagbrasil
需要配置的环境变量
PAGBRASIL_PBTOKEN密钥Merchant token (pbtoken) from the PagBrasil Dashboard
PAGBRASIL_SECRET密钥Secret phrase from the PagBrasil Dashboard
PAGBRASIL_BASE_URLAPI base URL. Defaults to https://sandbox.pagbrasil.com/api; production hosts are issued per-merchant.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-pagbrasil0.1.0

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
amount_brlstring是以巴西雷亚尔计价的金额，主单位，字符串格式（例如 '125.00'）
address_zipstring否买家的 CEP
address_citystring否买家所在城市
order_numberstring是每个 customer_taxid 下唯一的订单引用（幂等性锚点）
payment_typeenum是付款方式pix | boleto | creditcard
product_namestring否产品／扣款说明
address_statestring否买家所在州（UF）
customer_namestring是买家全名
address_streetstring否买家街道地址
customer_emailstring否买家邮箱
customer_phonestring否买家电话
customer_taxidstring是买家 CPF（个人）或 CNPJ（企业）——必须是有效的巴西税号

详细介绍

@codespar/mcp-pagbrasil

面向 PagBrasil 的 MCP 服务——为向巴西销售商品的国际商户提供跨境收单服务：Pix、自动 Pix（PagStream）、Boleto Flash、PEC Flash 和支持分期付款的本地信用卡。与 PagBank/PagSeguro 不同。

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "pagbrasil": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagbrasil"],
      "env": {
        "PAGBRASIL_PBTOKEN": "your-merchant-token",
        "PAGBRASIL_SECRET": "your-secret-phrase"
      }
    }
  }
}
Claude Code
claude mcp add pagbrasil -- npx @codespar/mcp-pagbrasil
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "pagbrasil": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagbrasil"],
      "env": {
        "PAGBRASIL_PBTOKEN": "your-merchant-token",
        "PAGBRASIL_SECRET": "your-secret-phrase"
      }
    }
  }
}

身份验证

每个请求都会将商户令牌（pbtoken）和密语作为请求正文中的字段传递——没有身份验证标头。此服务会从 PAGBRASIL_PBTOKEN 和 PAGBRASIL_SECRET 注入这两个值。

API 格式（值得了解）

PagBrasil 的 API 使用 form-urlencoded 格式（而非 JSON），并返回 XML。每个请求都会在正文中传递商户令牌（pbtoken）和密语——此服务会从环境变量中注入这两个值。工具响应会将原始 XML 放在 xml 中交给 Agent，因此不会丢失任何字段。

工具（3 个）

工具端点功能
create_orderPOST /order/add创建订单／发起付款（pix、boleto、creditcard）。Pix 响应包含 pix_code 和 pix_image；boleto 响应包含条形码和 PDF URL
get_orderPOST /order/get获取订单当前状态——轮询以检测结算情况
refund_orderPOST /order/refund退还已结算订单的款项（部分退款使用 amount_brl，全额退款则省略）

环境变量

变量必需描述
PAGBRASIL_PBTOKEN是PagBrasil 控制面板中的商户令牌
PAGBRASIL_SECRET是控制面板中的密语
PAGBRASIL_BASE_URL否默认为 https://sandbox.pagbrasil.com/api。签署支付服务协议后，PagBrasil 会为每个商户分配生产环境主机；请设置为控制面板提供的 URL

注意事项

  • amount_brl 以主要货币单位的字符串表示：'125.00' = R$ 125,00。
  • 每个 customer_taxid 对应的 order_number 必须唯一。编号和税号相同＝幂等空操作；编号相同但税号不同＝请求被拒绝（Duplicated order）。
  • customer_taxid 必须是有效的 CPF 或 CNPJ——Agent 应询问用户，绝不能自行编造。

企业版

需要为 PagBrasil 上由 Agent 发起的付款提供治理、预算限额和审计追踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、支付路由和合规模板。

许可证

MIT © CodeSpar

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。