Come collegare Plaid a Cursor via MCP

💡 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 + Cursor

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.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

PLAID_CLIENT_ID, PLAID_SECRET

Step 1 — Ottieni le credenziali

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.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Plaid.

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."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Gemini
• Collegare a Meta Muse