mcp-pagseguro

@codespar/mcp-pagseguro

PagSeguro/PagBank 用の MCP サーバー — 注文、請求、Pix、ボレート、クレジットカード決済

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "pagseguro": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagseguro"],
      "env": {
        "PAGSEGURO_TOKEN": "your-token",
        "PAGSEGURO_SANDBOX": "true"
      }
    }
  }
}

Claude Code

claude mcp add pagseguro -- npx @codespar/mcp-pagseguro

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "pagseguro": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagseguro"],
      "env": {
        "PAGSEGURO_TOKEN": "your-token",
        "PAGSEGURO_SANDBOX": "true"
      }
    }
  }
}

ツール（24）

ツール	用途
create_order	PagSeguro で注文を作成します（Pix、ボレート、またはクレジットカード）
get_order	ID で注文の詳細を取得します
list_orders	任意のフィルターを指定して注文を一覧表示します
create_charge	単独の請求を作成します
refund	請求を返金します（全額または一部）
get_pix_qrcode	注文の請求に関する Pix QR コードのペイロードと画像を取得します
create_customer	PagSeguro で顧客を作成します
get_balance	アカウント残高を取得します
create_subscription	PagSeguro で定期購読プランを作成します
list_subscriptions	任意のフィルターを指定して定期購読を一覧表示します
get_notifications	通知コードで支払い通知の詳細を取得します
create_split	マーケットプレイスの取引向けに分割決済の設定を作成します
get_dispute	ID で異議申し立て／チャージバックの詳細を取得します
pay_order	既存の注文に支払います（CREATED 状態の注文に請求／支払いを紐付けます）
get_charge	ID で請求の詳細を取得します
list_charges	任意のフィルターを指定して請求を一覧表示します
capture_charge	与信承認済みのクレジットカード請求を売上確定します
cancel_charge	まだ決済が完了していない請求をキャンセルします
create_boleto	ボレート請求を作成します
get_boleto	ID でボレート請求の詳細を取得します
get_public_keys	カードデータの暗号化に使用する PagSeguro 公開鍵を取得します（タイプ：card）
create_payout	銀行口座または Pix キー宛ての出金／振込を作成します
create_webhook	イベント通知を受け取るためのアプリケーションの Webhook URL を登録します
list_webhooks	登録済みのアプリケーション Webhook を一覧表示します

認証

PagSeguro は認証に Bearer トークンを使用します。PagBank 開発者ポータルでトークンを生成してください。

サンドボックス／テスト

PagSeguro は sandbox.api.pagseguro.com にサンドボックスを提供しています。利用するには PAGSEGURO_SANDBOX=true を設定してください。

認証情報の取得

1. PagBank Developer Portal にアクセスします
2. 開発者アカウントを作成します
3. API トークンを生成します
4. PAGSEGURO_TOKEN 環境変数を設定します

環境変数

変数	必須	説明
PAGSEGURO_TOKEN	はい	PagBank の Bearer トークン
PAGSEGURO_SANDBOX	いいえ	サンドボックスモードを使うには "true" に設定します

ロードマップ

v0.2（予定）

• create_subscription — 定期購読を作成します
• list_subscriptions — フィルターを指定してすべての定期購読を一覧表示します
• get_notifications — 支払い通知／Webhook を取得します
• create_split — 受取人間で分割する支払いを作成します
• get_dispute — 異議申し立て／チャージバックの詳細を取得します

v0.3（予定）

• create_plan — 定期購読プランを作成します
• get_installments — 支払いの分割払いオプションを取得します
• batch_refunds — 1 回のリクエストで複数の返金を処理します

貢献したいですか？PR を作成するか、ツールをリクエストしてください。

リンク

• PagBank のウェブサイト
• PagBank API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

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

ライセンス

MIT