Collega strumenti AI a Espobase
Il connettore di Espobase permette a Claude, ChatGPT, Cursor, VS Code e altri strumenti che supportano il Model Context Protocol (MCP) di lavorare con i tuoi progetti: leggere lo schema e il riferimento API, generare tipi, eseguire query di sola lettura, controllare log e utilizzo, e proporre modifiche al database che approvi tu.
Collega
Claude (claude.ai, Claude Desktop) e ChatGPT: aggiungi un connettore personalizzato con l'URL del server qui sotto e fai clic su Connetti. Accedi a Espobase (email, GitHub, Google, Apple o SSO), rivedi cosa può fare lo strumento e autorizzi l'accesso. Nessuna chiave da copiare.
https://app.espobase.com/api/mcp
In Claude: Settings › Connectors › Add custom connector. In ChatGPT: Settings › Connectors (o Apps).
Claude Code, Cursor, VS Code e altri client MCP: crea un token di accesso personale nella dashboard (Impostazioni account › Sviluppatore), dove trovi anche la configurazione pronta da incollare per ogni strumento. Ad esempio, in Claude Code:
claude mcp add --transport http espobase https://app.espobase.com/api/mcp \ --header "Authorization: Bearer <your token>"
Ti serve un account Espobase; il connettore funziona con tutti i piani.
Cosa può e non può fare uno strumento collegato
- Agisce come te: solo nelle organizzazioni e nei progetti a cui hai accesso, con il tuo ruolo.
- Vede solo ciò che hai consentito nella schermata di consenso (ad esempio schema, log, SQL di sola lettura).
- L'SQL è sempre di sola lettura: le istruzioni che modificherebbero dati o struttura vengono rifiutate, anche se sei il proprietario del progetto.
- Può proporre modifiche al database, ma mai applicarle. Rivedi tu l'SQL e lo applichi dalla scheda AI del tuo progetto.
- Non riceve mai password del database, chiavi API segrete o altre credenziali.
- Puoi scollegarlo in qualsiasi momento in Impostazioni account › Sviluppatore › App collegate; l'accesso termina subito.
Strumenti
| whoami | Il tuo account Espobase e le tue organizzazioni. |
| list_projects | I progetti a cui hai accesso, con stato, ambiente, regione e il tuo ruolo. |
| get_project | I dettagli di un progetto. |
| get_schema | Tabelle, colonne, relazioni, sicurezza a livello di riga e policy (solo la struttura). |
| get_api_reference | Endpoint REST, filtri, autenticazione e uso dell'SDK per scrivere il codice client. |
| generate_typescript_types | espobase.types.ts per query tipizzate con @espobase/client. |
| run_read_only_sql | Query SELECT, eseguite con l'utente di sola lettura del database del progetto. |
| get_logs | Log delle richieste recenti (percorsi, stato, tempi; mai corpi delle richieste o segreti). |
| get_usage | Richieste API, banda, spazio database e archiviazione file, utilizzo AI. |
| list_storage | Bucket, cartelle e nomi dei file (non il loro contenuto). |
| propose_schema_change | Un piano (tabelle, relazioni, policy…) e il suo SQL, da rivedere e applicare. |
| create_project | Un nuovo progetto, se hai consentito la creazione di progetti. |
Cosa chiedere
- “Elenca i miei progetti Espobase e riassumi lo schema del database del mio progetto principale.”
- “Quali tabelle del mio progetto hanno la sicurezza a livello di riga ma ancora nessuna policy?”
- “Scrivi una pagina Next.js che elenchi gli ultimi 20 ordini del mio progetto Espobase usando @espobase/client.”
- “Quante richieste API ha gestito il mio progetto questa settimana, e ci sono stati errori nei log?”
- “Proponi una tabella todos in cui ogni utente che ha effettuato l'accesso vede solo le proprie attività.”
I tuoi dati
Quando chiedi qualcosa al tuo strumento AI, il connettore restituisce la risposta a quello strumento: ad esempio nomi di tabelle e colonne, risultati di query, voci di log o nomi di file. Il provider AI tratta poi quei contenuti secondo i propri termini e la propria informativa sulla privacy. Espobase non riceve mai la tua conversazione con lo strumento AI. Riceve solo ciò che invia ogni chiamata a uno strumento: ad esempio la query SQL da eseguire o, per propose_schema_change, la tua richiesta di modifica, che viene conservata nella cronologia AI del progetto come le richieste scritte nella dashboard. Le chiamate agli strumenti vengono registrate (quale endpoint, quando, lo stato del risultato) per sicurezza e audit.
Leggi l'informativa sulla privacy di Espobase per sapere come trattiamo le tue informazioni.
Risoluzione dei problemi
- Uno strumento dice che manca uno scope: scollegalo e ricollegalo (o crea un token con quello scope).
- La tua organizzazione richiede il single sign-on (SSO): accedi a Espobase con SSO prima di collegare lo strumento.
- Un progetto non compare nell'elenco: potresti avere accesso solo ad alcuni progetti; chiedi a un amministratore dell'organizzazione.
Hai bisogno di aiuto? Contatta il supporto.