Come integrare Stripe nel tuo workflow AI con Aladia

Stripe è uno degli strumenti più potenti per gestire i pagamenti, ma sfruttarlo al massimo richiede solitamente molto codice. Con il connettore Stripe MCP di Aladia, puoi dare al tuo agente AI accesso diretto alle API Stripe — per cercare transazioni, creare link di pagamento, gestire abbonamenti e molto altro — senza scrivere una riga di integrazione.

Prima di iniziare

Per seguire questa guida avrai bisogno di:

• Un account Aladia (il piano Free è sufficiente)
• Una chiave API Stripe (trovala nel dashboard Stripe sotto Developers → API keys)
• Un client MCP compatibile (Claude Desktop, un agente custom, o la nostra interfaccia web)

Step 1: installa il connettore Stripe

Accedi al tuo dashboard Aladia e vai su Marketplace. Cerca "Stripe" e clicca Install. Ti verrà chiesto di inserire la tua chiave API Stripe (usa la chiave segreta, non la chiave pubblica). Aladia la cifra e la archivia in modo sicuro: non sarà mai esposta in chiaro.

Dopo l'installazione, il connettore compare nella tua lista di connettori attivi. Da qui puoi vedere le permissioni disponibili e limitare l'accesso a specifici team o utenti.

Step 2: configura i permessi

Nella pagina del connettore, trovi la sezione Permissions. Puoi scegliere quali operazioni sono abilitate:

• Read-only (consigliato per iniziare): il modello può cercare transazioni, clienti e abbonamenti, ma non può creare o modificare nulla.
• Full access: il modello può anche creare payment links, aggiornare abbonamenti, emettere rimborsi.

Per un agente di supporto clienti, read-only è spesso sufficiente. Per un agente di automazione billing, potresti abilitare operazioni specifiche di scrittura.

Step 3: usa il connettore con il tuo agente

Una volta installato, il connettore è disponibile all'endpoint MCP del tuo workspace. Configura il tuo client MCP con l'URL e il token API di Aladia (trovi entrambi in Settings → API).

Ecco alcuni esempi di cosa può fare il tuo agente:

• "Mostrami tutte le transazioni fallite degli ultimi 7 giorni"
• "Crea un payment link da €49 per il piano Pro"
• "Cerca il cliente mario@example.com e dimmi quando scade il suo abbonamento"
• "Quante nuove sottoscrizioni abbiamo avuto questa settimana?"

Monitoraggio e audit

Ogni chiamata al connettore Stripe viene registrata nel tab Usage del tuo dashboard Aladia. Puoi vedere esattamente quali operazioni sono state eseguite, da quale utente, con quale timestamp. Questo è fondamentale per la compliance e per identificare comportamenti anomali.

Se vuoi approfondire, consulta la nostra documentazione per un tutorial completo sulla configurazione avanzata e sull'integrazione con agenti custom.