mcp-stone

@codespar/mcp-stone

Stone 用 MCP サーバー — 決済（カード／Pix／boleto）、早期入金、売掛金、端末、オープンバンキング

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "stone": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stone"],
      "env": {
        "STONE_CLIENT_ID": "your-client-id",
        "STONE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "stone": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stone"],
      "env": {
        "STONE_CLIENT_ID": "your-client-id",
        "STONE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

ツール（21）

ツール	目的
get_balance	アカウント残高を取得します
list_transactions	アカウントの取引を一覧表示します
get_statement	指定期間のアカウント明細を取得します
create_payment	Stone 経由で支払いを作成します
get_payment	ID を指定して支払いの詳細を取得します
list_payments	任意のフィルターを指定して支払いを一覧表示します
create_transfer	銀行振込を作成します（内部または外部）
create_pix_payment	Stone 経由で Pix 支払い（送金）を作成します
create_pix_charge	支払いを受け取るための Pix 請求（QR Code／cob）を作成します
create_boleto	顧客への請求用に boleto bancário を作成します
create_card_charge	クレジットカードまたはデビットカードで請求します（Stone 決済）
tokenize_card	後で請求できるよう、カードを PCI に準拠した安全なトークンに変換します
refund_transaction	確定済みの取引を全額または一部返金します
cancel_transaction	承認済みの取引（未売上計上）をキャンセルします
create_anticipation	将来の売掛金を早期入金します（Stone の主力サービス「antecipação」）
get_anticipation_limits	加盟店の現在の早期入金限度額（最大／最小／利用可能）を取得します
list_receivables	売掛金（カード取引による将来の入金）を検索します
list_terminals	加盟店の Stone／TON 物理端末を一覧表示します
get_terminal_status	特定の POS 端末の現在の状態（オンライン／オフライン／最終確認時刻）を取得します
register_webhook	Stone イベント用の Webhook エンドポイントを登録します
list_webhooks	登録済みの Webhook エンドポイントを一覧表示します

認証

Stone は OAuth2 クライアントクレデンシャルを使用して認証します。サーバーがトークンの更新を自動的に管理します。

サンドボックス／テスト

Stone は開発者ポータルからサンドボックスを提供しています。

認証情報の取得

1. Stone Open Bank Documentation にアクセスします
2. 開発者として登録します
3. アプリケーションを作成し、OAuth2 認証情報を取得します
4. 環境変数を設定します

環境変数

変数	必須	説明
STONE_CLIENT_ID	はい	OAuth2 クライアント ID
STONE_CLIENT_SECRET	はい	OAuth2 クライアントシークレット
STONE_BASE_URL	いいえ	ベース URL を上書きします（デフォルトは https://api.openbank.stone.com.br/api/v1、サンドボックスは https://sandbox-api.openbank.stone.com.br/api/v1）
STONE_AUTH_URL	いいえ	OAuth2 トークン URL を上書きします（デフォルトは https://accounts.openbank.stone.com.br/auth/realms/stone_bank/protocol/openid-connect/token、サンドボックスは https://sandbox-accounts.openbank.stone.com.br/auth/realms/stone_bank/protocol/openid-connect/token）。0.2.2 まではトークン要求の送信先が存在しない login.openbank.stone.com.br だったため、すべてのツールが認証で失敗していました。

ロードマップ

v0.3（予定）

• list_pix_keys — 加盟店に登録されている Pix キーを一覧表示します
• create_recipient — マーケットプレイス／分割決済の受取人を作成します
• create_transfer_batch — 一括振込処理を実行します
• get_boleto — boleto の詳細を取得します
• create_scheduled_payment — 将来の日付で支払いを予約します
• list_payouts — 早期入金／決済の支払いを一覧表示します

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

リンク

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

エンタープライズ

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

ライセンス

MIT