mcp-iniciador

@codespar/mcp-iniciador

Iniciador 用 MCP サーバー — オープンファイナンス・ブラジルの PISP（Pix 決済開始アグリゲーター）です。Iniciador は ICP-Brasil 証明書を保有し、即時の Pix 送金フローにおいてブラジルの各銀行との DCR を仲介します。

クイックスタート

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "iniciador": {
      "command": "npx",
      "args": ["@codespar/mcp-iniciador"],
      "env": {
        "INICIADOR_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor / VS Code

.cursor/mcp.json に同じ設定を追加します。

ツール（9）

金融機関

ツール	Iniciador エンドポイント	備考
list_institutions	GET /institutions	Pix 決済開始に対応しているブラジルの銀行

同意

ツール	Iniciador エンドポイント	備考
create_consent	POST /consents	支払人が自身の銀行で承認するための決済同意
get_consent	GET /consents/{id}	現在の承認ステータス
revoke_consent	DELETE /consents/{id}	行使前に同意を取り消します

決済

ツール	Iniciador エンドポイント	備考
create_payment	POST /payments	同意の承認後に Pix 決済を開始します
get_payment	GET /payments/{id}	ステータス／E2E ID／却下理由
list_payments	GET /payments	日付範囲／ステータスで絞り込みます
cancel_payment	POST /payments/{id}/cancel	決済完了前に可能な限りキャンセルします

ヘルパー

ツール	備考
get_authorization_url	OFB 認証 URL をクライアント側で構築します（同意 ID + ISPB + リダイレクト）

認証

このサーバーでは Iniciador の API キー認証（X-API-KEY ヘッダー）を使用します。Pix 送金リクエスト自体は、消費者の銀行が発行した同意トークンでエンドツーエンドに署名されます。このトークンは、支払人が自身の銀行で同意を承認した後、Iniciador のバックエンドで組み込まれます。同意と銀行発行トークンの連携がエンドツーエンドで実装された段階で、一部のフローに必要な OAuth2 クライアントクレデンシャル認証が導入されます。

Iniciador のオンボーディング時に認証情報を発行してください。

• 本番環境：https://iniciador.com.br
• ドキュメント：https://docs.iniciador.com.br

サンドボックス／テスト

サンドボックスのエンドポイントは https://sandbox.iniciador.com.br です。INICIADOR_API_BASE で上書きできます。

環境変数

変数	必須	説明
INICIADOR_API_KEY	はい	Iniciador のオンボーディングで発行された API キー
INICIADOR_API_BASE	いいえ	API のベース URL を上書きします（デフォルトは https://api.iniciador.com.br）

Iniciador、Pluggy、Belvo の比較

このカタログには、得意分野の異なる 3 つの OFB アグリゲーターがあります。

アグリゲーター	強み	最適な用途
Iniciador	Pix 決済開始（PISP）	OFB 同意に基づく送金
Pluggy（@codespar/mcp-pluggy）	口座・取引の読み取り	照合、残高のポーリング
Belvo（@codespar/mcp-belvo）	ラテンアメリカ複数国のオープンファイナンス + 給与 + 税務	国境を越えた利用（BR + MX + CO + AR）

読み取りと書き込みの両方が必要なコマースエージェントでは、Pluggy／Belvo で口座情報や照合状況を確認し、Iniciador で Pix 決済を開始するよう組み合わせてください。

エンタープライズ

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

ライセンス

MIT