MCP 経由で Plaid を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Plaid をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Plaid + Gemini

Plaid を通じて AI が銀行データを読み取れるようにします。口座、リアルタイム残高、期間指定または差分同期での取引、名義人の本人情報、口座番号とルーティング番号、連携した銀行ごとの状態に加え、金融機関の検索と Link のトークン手順にも対応します。Plaid の client ID と secret を使い、サンドボックスでも本番でも使えます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

PLAID_CLIENT_ID, PLAID_SECRET

ステップ 1 — 認証情報を取得

1. dashboard.plaid.com で Plaid Dashboard にサインインし（サンドボックスなら無料アカウントで足ります）、開発者向け設定の Keys ページを開きます。
2. client_id を PLAID_CLIENT_ID に、使いたい環境の secret を PLAID_SECRET にコピーします。secret は環境ごとに別々です。Sandbox の secret はすぐに使えますが、Production の secret は Plaid があなたのチームを本番利用として承認してから使えるようになります。
3. コネクタをインストールします。Authorize with Provider の手順はありません。コネクタは Plaid の仕様どおり、PLAID_CLIENT_ID と PLAID_SECRET を client_id と secret としてすべての呼び出しの JSON ボディに入れて送ります（ヘッダーではありません）。
4. 環境を決めるのはコネクタの Base URL だけで、インストール直後は https://sandbox.plaid.com です。実際の銀行を使うには、コネクタの詳細を編集して Base URL を https://production.plaid.com に変え、本番用の secret を使います。このための環境変数はなく、secret は Base URL と同じ環境のものでなければなりません。
5. まず plaid_institutions_search を実行します（たとえば検索語 Chase と国コード US）。連携済みの銀行は不要なので、client ID と secret が正しいかだけを確認できます。

銀行の連携: Plaid では連携した銀行ログインの一つひとつを Item と呼び、Item ごとに専用の access_token があります。このトークンは、口座名義人が銀行を選んでログインする画面である Plaid Link から得られます。plaid_link_token_create が link_token を作り、あなたのアプリや Web ページがそれで Link を開きます。ログインが終わると Link は public_token（有効期間 30 分、1 回だけ使用可）を返し、plaid_item_public_token_exchange がそれを長期間有効な access_token と item_id に交換します。コネクタ自身は Link を表示できません。サンドボックスでは、どのテスト銀行にもユーザー名 user_good、パスワード pass_good でログインできます。また、Plaid の /sandbox/public_token/create エンドポイント（このコネクタのツールではありません）で Link を使わずにテスト用 Item を作り、その結果を plaid_item_public_token_exchange で交換することもできます。

access token が必要なツール: 次の 7 つのツールは 1 つの Item を読み取り、その access_token をパラメータとして受け取ります: plaid_item_get、plaid_accounts_get、plaid_accounts_balance_get、plaid_transactions_get、plaid_transactions_sync、plaid_identity_get、plaid_auth_get。plaid_institutions_search と plaid_link_token_create に必要なのは client ID と secret だけで、plaid_item_public_token_exchange には public_token が必要です。コネクタは access token を保存しません。会話の中や指示の中でトークンを AI に渡してください。client ID と secret と組み合わせるとその銀行のデータを読めるので、パスワードと同じように扱ってください。トークンは access-sandbox- または access-production- で始まり、その環境でしか使えません。

すべて POST、ほとんどが読み取り: Plaid の API はすべての呼び出しを POST で受け付けるため、コネクタも POST を使います。ただし何かを作成するのは plaid_link_token_create と plaid_item_public_token_exchange（Link 用トークンと access token）だけです。お金を動かしたり、口座を変更したり、Item を削除したりするツールはありません。

権限と読み取り専用の設定: Item が使えるのは、連携時に指定したプロダクト（plaid_link_token_create の products）だけです。plaid_transactions_get と plaid_transactions_sync には transactions、plaid_identity_get には identity、plaid_auth_get には auth が必要です。plaid_auth_get は口座番号とルーティング番号を完全な形で返し、plaid_identity_get は名義人の氏名、メールアドレス、電話番号、住所を返します。AI に不要であれば、コネクタのページでこの 2 つを無効にしてください。access token をすでに持っているなら、トークン用の 2 つのツールも無効にできます。

取引: plaid_transactions_get は期間（start_date と end_date、形式は YYYY-MM-DD）を指定して読み取ります。1 ページは既定で 100 件、options の count と offset で最大 500 件です。どこまでさかのぼれるかは銀行連携時に要求した履歴の長さによります。Plaid の既定は 90 日、最大は 730 日で、plaid_link_token_create はそれ以上を要求しません。plaid_transactions_sync は前回の呼び出し以降に追加、変更、削除された取引を返します。最初は cursor なしで呼び出し、has_more が true の間は next_cursor を渡し続けます。連携した直後は、取引が届くまで数分かかることがあります。

残高: plaid_accounts_get は Plaid がキャッシュしている残高とともに口座を一覧表示します。plaid_accounts_balance_get は銀行にリアルタイムで問い合わせるため時間がかかり、本番環境では Plaid との契約によって呼び出しごとに課金される場合があります。

レート制限: 環境とプロダクトによって異なります。上限を超えると Plaid は 429 と RATE_LIMIT_EXCEEDED を返します。少し待ってから再試行してください。

よくあるエラー: INVALID_API_KEYS は client ID か secret が誤っているか、secret が Base URL と別の環境のものであることを意味します。INVALID_ACCESS_TOKEN はトークンの入力ミスか、別の環境のトークンです。ITEM_LOGIN_REQUIRED は銀行のログイン情報が変わったか同意の期限が切れたことを意味し、名義人があなたのアプリで Link から再ログインする必要があります（コネクタからは開始できません）。連携直後の PRODUCT_NOT_READY は、取引をまだ読み込み中であることを示します。PRODUCTS_NOT_SUPPORTED は、その銀行または Item がそのプロダクトに対応していないことを意味します。

このコネクタは、Webhook、支払いと送金、投資と負債、収入と雇用の確認、リスクスコア、Link の更新モード、Item の削除には対応していません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Plaid のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「さっき access token を渡した銀行連携の口座を、現在残高と利用可能残高つきで一覧にしてください。」
• 「2026 年 9 月の事業用当座預金口座で 500 USD を超える取引をすべて、カテゴリ別にまとめて見せてください。」
• 「Plaid は米国の Chase で transactions と auth に対応していますか。」
• 「この銀行連携がまだ使えるか、再ログインが必要か、どのプロダクトが有効になっているかを確認してください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続