mcp-pagbrasil

@codespar/mcp-pagbrasil

PagBrasil 向け MCP サーバー — ブラジルで販売する海外加盟店向けのクロスボーダー決済代行会社です。Pix、Automatic Pix（PagStream）、Boleto Flash、PEC Flash、分割払いに対応した現地のクレジットカードを利用できます。PagBank／PagSeguroとは異なります。

クイックスタート

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 はフォーム URL エンコード形式（JSON ではありません）で、レスポンスは XML です。加盟店トークン（pbtoken）とシークレットフレーズは、すべてのリクエストで本文のフィールドとして送信されます。このサーバーは環境変数から両方の値を設定します。ツールのレスポンスでは、生の XML を xml としてエージェントに渡すため、フィールドが失われることはありません。

ツール（3）

ツール	エンドポイント	機能
create_order	POST /order/add	注文を作成／決済をリクエストします（pix、boleto、creditcard）。Pix のレスポンスには pix_code と pix_image が含まれ、boleto のレスポンスにはバーコードと PDF URL が含まれます
get_order	POST /order/get	注文の現在のステータスを取得します。決済完了を検出するためにポーリングします
refund_order	POST /order/refund	決済済みの注文を返金します（一部返金の場合は amount_brl を指定し、全額返金の場合は省略します）

環境変数

変数	必須	説明
PAGBRASIL_PBTOKEN	はい	PagBrasil ダッシュボードで発行される加盟店トークン
PAGBRASIL_SECRET	はい	ダッシュボードで発行されるシークレットフレーズ
PAGBRASIL_BASE_URL	いいえ	デフォルトは https://sandbox.pagbrasil.com/api です。本番環境のホストは、Payment Service Agreement の締結後に加盟店ごとに発行されます。ダッシュボードに表示される URL を設定してください

注意事項

• amount_brl は主要通貨単位を文字列で指定します。'125.00' は R$ 125,00 を意味します。
• order_number は customer_taxid ごとに一意である必要があります。同じ番号と同じ納税者番号の組み合わせでは冪等な no-op となり、同じ番号と異なる納税者番号の組み合わせは拒否されます（Duplicated order）。
• customer_taxid には有効な CPF または CNPJ が必要です。エージェントはユーザーに確認し、決して値をでっち上げてはいけません。

エンタープライズ

PagBrasil でエージェントが決済を行う際のガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT © CodeSpar