mcp-pagar-me

@codespar/mcp-pagar-me

Pagar.me 向け MCP サーバー — Stone エコシステムの注文、請求、分割決済に対応

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "pagar-me": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagar-me"],
      "env": {
        "PAGARME_API_KEY": "sk_your-key"
      }
    }
  }
}

Claude Code

claude mcp add pagar-me -- npx @codespar/mcp-pagar-me

Cursor / VS Code

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

{
  "servers": {
    "pagar-me": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagar-me"],
      "env": {
        "PAGARME_API_KEY": "sk_your-key"
      }
    }
  }
}

ツール（22）

ツール	用途
create_order	商品と決済を指定して、Pagar.me に注文を作成します
get_order	ID を指定して注文の詳細を取得します
list_orders	任意のフィルターを指定して注文を一覧表示します
create_charge	請求（Pix、boleto、またはクレジットカード）を作成します
get_charge	ID を指定して請求の詳細を取得します
create_recipient	分割決済用の受取人を作成します
get_balance	現在の口座残高を取得します
create_transfer	受取人への振込を作成します
refund	請求を全額または一部返金します
list_recipients	任意のフィルターを指定して受取人を一覧表示します
create_anticipation	受取人の売掛金の前払い（antecipação）を申請します
get_anticipation	ID を指定して前払いの詳細を取得します
get_anticipation_limits	受取人が利用できる前払い限度額を取得します
create_plan	サブスクリプションプランを作成します
update_plan	既存のサブスクリプションプランを更新します
create_subscription	顧客向けの継続課金サブスクリプションを作成します
cancel_subscription	継続課金サブスクリプションをキャンセルします
create_card_token	クレジットカードをトークン化します（PCI セーフ）。
create_withdrawal	受取人の残高を登録済みの銀行口座へ振り込む出金（saque）を作成します
register_webhook	イベント通知を受信する Webhook エンドポイントを登録します
capture_charge	事前承認済みの請求を確定します（オーソリ後に売上を確定するフロー）。
partial_refund	請求の一部を返金します（明示的な一部返金；

認証

Pagar.me は、シークレットキー（sk_xxx）をユーザー名、空のパスワードとする Basic Auth を使用します。

サンドボックス／テスト

Pagar.me はダッシュボードからテストモードを利用できます。実際の請求を避けるには、テストモードの API キーを使用してください。

認証情報の取得

1. Pagar.me Dashboard にアクセスします
2. アカウントを作成します
3. シークレットキー（テストモードの場合は sk_test_xxx）を取得します
4. PAGARME_API_KEY 環境変数を設定します

環境変数

変数	必須	説明
PAGARME_API_KEY	はい	Pagar.me ダッシュボードで取得したシークレットキー（sk_xxx）
PAGARME_PUBLIC_KEY	いいえ	create_card_token 専用の公開キー（pk_xxx）

ロードマップ

v0.3（予定）

• list_charges — フィルターを指定して請求を一覧表示します
• list_subscriptions — サブスクリプションを一覧表示します
• list_plans — プランを一覧表示します
• batch_charges — 1 回のリクエストで複数の請求を作成します
• list_webhooks / delete_webhook — Webhook を包括的に管理します

貢献に興味がありますか？PR を作成するか、ツールをリクエストしてください。

リンク

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

エンタープライズ

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

ライセンス

MIT