Come collegare Plaid a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Plaid.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

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