Plaid su MCP: Pilota Plaid da qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Plaid, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Plaid

Lascia che la tua AI legga i dati bancari con Plaid: conti, saldi in tempo reale, transazioni per date o in sync incrementale, identità dei titolari, numeri di conto e routing e lo stato di ogni banca collegata, più la ricerca degli istituti e i token di Link. Con client ID e secret di Plaid, sandbox o produzione.

Setup

1. Accedi alla Plaid Dashboard su dashboard.plaid.com (per la sandbox basta un account gratuito) e apri la pagina Keys nelle impostazioni per sviluppatori.
2. Copia il tuo client_id in PLAID_CLIENT_ID e il secret dell'ambiente che vuoi usare in PLAID_SECRET. Ogni ambiente ha il suo secret: quello di Sandbox funziona subito, quello di Production solo dopo che Plaid ha abilitato il tuo team alla produzione.
3. Installa il connettore. Non c'è nessun passaggio Authorize with Provider: il connettore inserisce PLAID_CLIENT_ID e PLAID_SECRET come client_id e secret nel body JSON di ogni chiamata, come vuole Plaid, non in un header.
4. L'ambiente dipende solo dalla Base URL del connettore, che dopo l'installazione è https://sandbox.plaid.com. Per lavorare con banche reali modifica i dettagli del connettore, imposta la Base URL su https://production.plaid.com e usa il secret di produzione. Non esiste una variabile d'ambiente apposita, e il secret deve appartenere all'ambiente della Base URL.
5. Inizia con plaid_institutions_search, per esempio cercando Chase con il codice paese US: non serve nessuna banca collegata, quindi verifica solo che client ID e secret siano giusti.

Collegare una banca: Plaid chiama Item ogni accesso bancario collegato, e ogni Item ha il suo access_token. Questo token arriva da Plaid Link, la finestra in cui il titolare sceglie la banca e fa il login. plaid_link_token_create crea il link_token con cui la tua app o pagina web apre Link; dopo il login Link restituisce un public_token, valido 30 minuti e utilizzabile una sola volta, e plaid_item_public_token_exchange lo trasforma nell'access_token permanente più l'item_id. Il connettore non può mostrare Link da solo. Nella sandbox accedi a qualsiasi banca di test con lo username user_good e la password pass_good, oppure crei un Item di test senza Link tramite l'endpoint /sandbox/public_token/create di Plaid (non è un tool di questo connettore) e scambi il risultato con plaid_item_public_token_exchange.

Quali tool richiedono un access token: sette tool leggono un Item e vogliono il suo access_token come parametro: plaid_item_get, plaid_accounts_get, plaid_accounts_balance_get, plaid_transactions_get, plaid_transactions_sync, plaid_identity_get e plaid_auth_get. A plaid_institutions_search e plaid_link_token_create bastano client ID e secret, a plaid_item_public_token_exchange serve un public_token. Il connettore non salva gli access token: li dai all'AI nella conversazione o nelle tue istruzioni. Insieme a client ID e secret il token apre i dati di quella banca, quindi trattalo come una password. I token iniziano con access-sandbox- o access-production- e funzionano solo in quell'ambiente.

Tutto POST, quasi tutto lettura: l'API di Plaid accetta ogni chiamata come POST, e così fa il connettore, ma solo plaid_link_token_create e plaid_item_public_token_exchange creano qualcosa (un token Link e un access token). Nessun tool sposta denaro, modifica un conto o rimuove un Item.

Permessi e solo lettura: un Item raggiunge solo i prodotti con cui è stato collegato (la lista products di plaid_link_token_create): plaid_transactions_get e plaid_transactions_sync richiedono transactions, plaid_identity_get richiede identity, plaid_auth_get richiede auth. plaid_auth_get restituisce numeri di conto e routing number completi, plaid_identity_get nomi, email, telefoni e indirizzi dei titolari; disattivali nella pagina del connettore se l'AI non ne ha bisogno. Se hai già i tuoi access token, puoi disattivare anche i due tool per i token.

Transazioni: plaid_transactions_get legge un intervallo di date (start_date e end_date nel formato YYYY-MM-DD), 100 per pagina di default e fino a 500 con count e offset in options. Quanto indietro arriva dipende dallo storico richiesto al collegamento della banca: il default di Plaid è 90 giorni, il massimo 730, e plaid_link_token_create non ne chiede di più. plaid_transactions_sync restituisce ciò che è stato aggiunto, modificato o rimosso dall'ultima chiamata: parti senza cursor, poi ripassa next_cursor finché has_more è true. Subito dopo il collegamento le transazioni possono metterci qualche minuto ad arrivare.

Saldi: plaid_accounts_get elenca i conti con i saldi che Plaid ha in cache. plaid_accounts_balance_get interroga la banca in tempo reale, è più lento e in produzione può essere addebitato a chiamata, a seconda del tuo contratto con Plaid.

Limiti di frequenza: dipendono dall'ambiente e dal prodotto. Oltre il limite Plaid risponde 429 con RATE_LIMIT_EXCEEDED: aspetta un momento e riprova.

Errori comuni: INVALID_API_KEYS indica client ID o secret sbagliati, oppure un secret di un ambiente diverso da quello della Base URL. INVALID_ACCESS_TOKEN indica un token scritto male o dell'altro ambiente. ITEM_LOGIN_REQUIRED indica che l'accesso alla banca è cambiato o il consenso è scaduto: il titolare deve rifare il login tramite Link nella tua app, cosa che il connettore non può avviare. PRODUCT_NOT_READY subito dopo il collegamento indica che le transazioni si stanno ancora caricando. PRODUCTS_NOT_SUPPORTED indica che la banca o l'Item non offre quel prodotto.

Il connettore non gestisce webhook, pagamenti e bonifici, investimenti e passività, verifiche di reddito e impiego, punteggi di rischio, la modalità di aggiornamento di Link o la rimozione di Item.

Prerequisiti: PLAID_CLIENT_ID, PLAID_SECRET

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli Plaid e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Elenca i conti del collegamento bancario di cui ti ho appena dato l'access token, con saldo attuale e disponibile."
• "Mostrami tutte le transazioni sopra i 500 USD sul conto corrente aziendale a settembre 2026, raggruppate per categoria."
• "Plaid supporta Chase negli Stati Uniti per transactions e auth?"
• "Controlla se questo collegamento bancario funziona ancora o richiede un nuovo login, e quali prodotti sono attivi."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT