mcp-pluggy

@codespar/mcp-pluggy

Pluggy 向けの MCP サーバー — Open Finance Brasil のアグリゲーター（ITP/TPP）です。Pluggy は ICP-Brasil 証明書を保有し、ブラジルの各銀行と Dynamic Client Registration を実行するため、N 個の API ではなく、1 つの API と連携できます。

クイックスタート

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "pluggy": {
      "command": "npx",
      "args": ["@codespar/mcp-pluggy"],
      "env": {
        "PLUGGY_CLIENT_ID": "your-client-id",
        "PLUGGY_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Cursor / VS Code

.cursor/mcp.json または VS Code の MCP 統合に同じ設定を追加します。

ツール（16）

コネクターとカテゴリー

ツール	Pluggy エンドポイント	備考
list_connectors	GET /connectors	名前／種類／国／サンドボックスで絞り込み
get_connector	GET /connectors/{id}	単一のコネクター定義
list_categories	GET /categories	取引の分類体系

Connect token

ツール	Pluggy エンドポイント	備考
create_connect_token	POST /connect_token	クライアントに Pluggy Connect ウィジェットを埋め込みます

アイテム（銀行口座の接続）

ツール	Pluggy エンドポイント	備考
create_item	POST /items	認証情報を使って新しい銀行接続を作成します
list_items	GET /items	既存の接続を一覧表示します
get_item	GET /items/{id}	単一の接続
update_item	PATCH /items/{id}	認証情報を更新／同期を開始します
delete_item	DELETE /items/{id}	接続を取り消します

口座、取引、本人確認情報

ツール	Pluggy エンドポイント	備考
list_accounts	GET /accounts?itemId=...	当座／貯蓄／クレジット／投資
get_account	GET /accounts/{id}	単一の口座
list_transactions	GET /transactions?accountId=...	日付範囲で絞り込み
get_transaction	GET /transactions/{id}	単一の取引
list_identities	GET /identity?itemId=...	法的氏名、書類、住所

決済（PISP）

ツール	Pluggy エンドポイント	備考
create_payment_intent	POST /payments/intents	Pluggy Payments のインテントを開始します
get_payment_intent	GET /payments/intents/{id}	ステータスをポーリングします

認証

Pluggy は OAuth2 のクライアント認証情報フローを使用します。

1. クライアントは clientId と clientSecret を指定して POST /auth を呼び出し、API キーを取得します
2. 以降のリクエストでは、X-API-KEY として API キーを含めます

Pluggy ダッシュボードで認証情報を発行します。

• 本番環境：https://dashboard.pluggy.ai
• ドキュメント：https://docs.pluggy.ai

サンドボックス／テスト

Pluggy は、合成アカウントと取引データを含むサンドボックス用コネクターを提供しています。サンドボックスでも同じ API エンドポイント（https://api.pluggy.ai）を使用します。/connectors が返すコネクター一覧には、サンドボックス用の銀行（Pluggy Bank、BR · Pluggy Bank）が含まれます。

環境変数

変数	必須	説明
PLUGGY_CLIENT_ID	yes	Pluggy ダッシュボードのクライアント ID
PLUGGY_CLIENT_SECRET	yes	Pluggy ダッシュボードのクライアントシークレット
PLUGGY_API_BASE	no	API ベース URL の上書き（デフォルトは https://api.pluggy.ai）

CodeSpar 経由で Pluggy を使う理由

MCP サーバーだけが必要な場合は、パッケージを直接インストールしてください。Pluggy、Pix、NF-e、WhatsApp、ダッシュボードガバナンスを必要とするコマースエージェントを構築する場合は、マネージドプランをご覧ください。

エンタープライズ

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

ライセンス

MIT