plaid-mcp
plaid-mcp
エフェメラル(一時的)なコンテナで実行されるAIアシスタント(Elowen)のための、常駐型Plaid MCPサーバーです。
plaid-mcpは、Plaidのシークレットと、リンクされたすべての金融機関の暗号化されたアクセストークンを保持する、長期間稼働する外部ホスト型サービスです。アシスタントは実行時に mcp__plaid__* ツールを呼び出しますが、生のアクセストークンを見ることはありません。Plaidがすでに公開情報とみなしている不透明な item_id および account_id の値のみを扱います。
Elowen (ephemeral container)
└─ calls mcp__plaid__* tools
└─ plaid-mcp (persistent, nanoclaw-hosted)
├─ Plaid SDK + PLAID_SECRET (never leaves this service)
├─ access_token store (SQLite, AES-256-GCM at rest)
└─ /link/start, /link/callback (HTTPS, browser-facing)
└─ Plaid REST API / Plaid Link JSサーフェス
単一のNode.jsプロセスが、完全に分離された2つのサーフェスを公開します。
MCPサーバー。
stdio(エージェントがこのバイナリをサブプロセスとして起動する)またはhttp(POST /mcpでのストリーミングHTTP、Bearer認証付き)のいずれか。MCP_TRANSPORTで選択します。前述の家計管理のユースケースでは、エフェメラルなエージェントコンテナの群れが1つの常駐サーバーを共有できるようにhttpを推奨します。HTTPSリンクミニアプリ (
/link/*)。銀行リンクの初回フロー時のみ使用されます。ユーザーはアシスタントから提供されたURLを開き、Plaid Link内で銀行にログインして完了します。その後、その金融機関のためにブラウザが必要になることはありません。
Related MCP server: plaid-mcp
MCPツール
ツール | 機能 |
| リンクされたすべてのアイテム。 |
| 1つまたはすべての金融機関のキャッシュされた口座リスト(タイプ、サブタイプ、マスク、最終残高)。 |
|
|
| 日付範囲指定の取引履歴。1ページあたり約250件、不透明なページネーションカーソルを使用。 |
| サーバーサイドでフィルタリングされた取引検索。コンパクトな行を返します。 |
|
|
| ポジションのスナップショット(ティッカー、数量、市場価値、取得原価)。 |
| 指定期間内の売買・配当履歴。 |
| クレジットカードのAPR/明細、学生ローン、住宅ローンの詳細。 |
|
|
|
|
| Plaidアイテムを取り消し、ローカルトークンを削除します。 |
すべてのツール応答は、単一の text コンテンツアイテム内のJSONです(structuredContent を表示しないクライアントを含む、すべてのMCPクライアントで動作します)。
初回リンクフロー
Elowenが
initiate_link({ institution_hint: "Chase" })を呼び出します。サーバーは以下の処理を行います。Plaidの
/link/token/createを呼び出す。link_sessions行を保存する(ステータスはpending)。{ url: "https://<LINK_BASE_URL>/link/start?s=<uuid>&sig=<hmac>", session_id, expires_at }を返す。
ElowenがユーザーにURLを送信します。
ユーザーがブラウザでURLを開きます。ページは公式CDNから
link_tokenを使用してPlaid Link JSを読み込み、「Open Plaid Link」ボタンを表示します。Plaid Linkの
onSuccessが{ public_token, institution }と署名済みセッションIDを/link/callbackにPOSTします。/link/callbackがpublic_tokenをaccess_token+item_idに交換し、アクセストークンをAES-256-GCMで暗号化して保存し、セッションをsucceededとマークします。Elowenが
link_status(session_id)をポーリングし、item_idを伴うsucceededを確認して処理を続行します。
署名付きURLパラメータ (s, sig) は LINK_SESSION_SECRET によってHMAC-SHA256でキー化されています。DB行が信頼の源泉であり、HMACはSQLiteに触れる前に不正なリクエストを安価に拒否するためのものです。
設定
すべての設定は環境変数(.env から読み込み)で行います。
変数 | 必須 | デフォルト | 説明 | ||
| はい | — | Plaidダッシュボードから取得 | ||
| はい | — | Plaidダッシュボードから取得。このサービスから外部へは出ません。 | ||
| いいえ |
|
|
|
|
| いいえ |
| 固定されたAPIバージョン | ||
| いいえ |
| カンマ区切りリスト。例: | ||
| いいえ |
| ISO国コードのカンマ区切りリスト | ||
| いいえ |
| Plaidに送信される安定した | ||
| はい | — | 32バイトの16進数 ( | ||
| はい | — | 32バイト以上の16進数。署名付きリンクURL用のHMACキー。 | ||
| いいえ |
| リンクセッションの有効期間 | ||
| はい | — | ブラウザがアクセスする公開HTTPSベースURL (例: | ||
| いいえ |
| HTTPポート。TLSは上位のnanoclawで終端されます。 | ||
| いいえ | — | 設定されている場合、 | ||
| いいえ |
|
|
| |
|
| — |
| ||
| いいえ |
| SQLiteパス。ここに永続ボリュームをマウントしてください。 | ||
| いいえ |
| Pinoログレベル。すべてのログはstderrに出力されます。 |
シークレットの生成方法:
make keysストレージ
$DB_PATH にSQLite (better-sqlite3) を使用します。重要なテーブルは2つです。
items—item_id(PK)、暗号化されたaccess_token_blob(BLOB)、金融機関名/ID、ステータス、同意有効期限。link_sessions— 短命なセッション。expires_atを過ぎた後の読み取り時、および60秒ごとのバックグラウンドスイープで自動的に期限切れになります。
アクセストークンは [1バイトのバージョン][12バイトのIV][16バイトのGCMタグ][Nバイトの暗号文] として保存されます。GCMタグが検証できない場合、復号は失敗します。
セキュリティモデル
MCP HTTPトランスポートは、すべてのリクエストで
Authorization: Bearer $MCP_BEARER_TOKENを要求します。これがないと、エージェント群がリンクされたすべての銀行口座をインターネットに公開することになります。ブラウザ向けの
/link/*ルートは署名(HMAC)されており、短命なDBベースのセッションにバインドされています。TLSは**上位(nanoclaw / Caddy / エッジ環境)**で終端されることを想定しています。コンテナ内部はプレーンなHTTPで通信するため、プロキシ経由でのみ公開してください。
すべてのPlaidトークンは保存時に暗号化されます。SQLiteファイルが流出したとしても、
PLAID_ENCRYPTION_KEYを持たない攻撃者はトークンを使用できません。MCPツールはアクセストークンをエージェントに返しません。不透明な
item_id/account_id文字列のみがMCP境界を越えます。
ローカル開発
npm install
make setup # creates .env from env.example
make keys >> .env # append fresh PLAID_ENCRYPTION_KEY / LINK_SESSION_SECRET / MCP_BEARER_TOKEN
# edit .env: PLAID_CLIENT_ID, PLAID_SECRET, LINK_BASE_URL
npm run dev # tsx with hot reloadローカルでのリンクテストにはHTTPSトンネルが必要です(Plaid Linkの onSuccess は http://localhost からは発火しません)。cloudflared、ngrok、または実際のCaddyリバースプロキシなどが使用可能です。取得した公開ホスト名を LINK_BASE_URL に設定してください。
Docker
make build
make up
make logsComposeファイルは ./data:/data をマウントしているため、SQLite DBは再起動後も保持されます。nanoclaw環境では、そのバインドマウントをクラスター管理の永続ボリュームに置き換えてください。
ホスト型インスタンスへのエージェントの接続
エージェントコンテナのMCPクライアント設定内:
{
"mcpServers": {
"plaid": {
"url": "https://plaid-mcp.your-domain.example/mcp",
"headers": {
"Authorization": "Bearer <MCP_BEARER_TOKEN>"
}
}
}
}エージェントは、nanoclawが他のエージェントシークレットに使用しているシークレット注入メカニズムを通じてBearerトークンを取得します。PLAID_SECRET やアクセストークンを直接見ることはありません。
ライセンス
内部利用。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Personal finance for AI agents — onboard, import statements, categorize & budget over MCP.
Read-only finance MCP server. Connects your banks, cards, payment apps, books and payroll into one ledger for your AI. Can't move money. Open source (AGPL-3.0), free during beta.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Persistent memory for AI assistants — one shared, OAuth-secured vault for every MCP client.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceSelf-hosted MCP server enabling Claude to query bank accounts, balances, and transactions through Plaid with OAuth and TLS.-
- AlicenseNot gradedqualityDmaintenanceA local MCP server that provides read-only SQL access to financial accounts via Plaid, enabling natural language queries about transactions, balances, and holdings.MIT
- FlicenseAqualityDmaintenancePersonal finance MCP server that integrates Plaid bank data with local SQLite memory for conversational budgeting, goal tracking, and transaction management.15-
- AlicenseNot gradedqualityBmaintenanceMCP server that exposes banking data (connections, accounts, balances, transactions) and agent skills, allowing AI agents to query and refresh financial data via stdio.154 npm6Apache 2.0