Collega serviziConnettori
Dati e contenuti
Database, fogli di calcolo, sistemi di contenuti, archiviazione di file e ricerca che puoi collegare a un’app: Supabase, Neon, Firebase, Airtable, Notion, Google Sheets, WordPress, Contentful, Storyblok, Webflow, AWS S3, Cloudinary e Algolia.
Ogni app ha già un database, l’accesso e le e-mail suoi: è Cloud. Collega uno di questi quando i dati vivono già altrove, quando vuoi che vivano in un account tuo, o quando all’app serve qualcosa che Cloud non fa, come conservare i file caricati.
Questa pagina ha una voce per ogni servizio. Per come funziona il collegamento in generale (il pulsante o le chiavi, Test connection, la scelta di quali app usano un servizio, i permessi), vedi Connettori.
| Servizio | A cosa serve | Come si collega |
|---|---|---|
| Supabase | Il tuo progetto Supabase al posto del backend integrato | Indirizzo del progetto e chiavi |
| Neon | Il tuo Postgres, con le tue regole sulle righe | L’indirizzo della Data API |
| Firebase | Firestore e accesso dal tuo progetto Firebase | Tre valori dalla console di Firebase |
| Airtable | Tabelle come database | Un pulsante, o un token |
| Notion | Pagine e database | Un pulsante, o un token |
| Google Sheets | Un foglio di calcolo come database | Un pulsante, o una chiave API |
| WordPress | Articoli e pagine di un sito WordPress | Indirizzo del sito e una password per le applicazioni |
| Contentful | Voci da un CMS headless | Space ID e un token di consegna |
| Storyblok | Storie da un CMS headless | Un token di accesso pubblico |
| Webflow | Raccolte dal CMS di Webflow | Un token del sito |
| AWS S3 | File caricati dalle persone | Regione, bucket e una chiave di accesso |
| Cloudinary | Immagini e file, ridimensionati alla consegna | Cloud name, upload preset e chiavi |
| Algolia | Ricerca mentre si digita | Application ID e due chiavi |
Alcune cose valgono per tutti:
- Le chiavi segrete restano sui server di Setherion e la tua app pubblicata chiama il servizio tramite Setherion. Al browser arrivano solo i valori pubblici per natura: la chiave anon di Supabase, le impostazioni di Firebase, il cloud name e l’upload preset di Cloudinary, la chiave di sola ricerca di Algolia e una chiave API di Google Sheets.
- I servizi che ti fatturano direttamente mostrano Billed by e il loro nome nella loro pagina, e ti chiedono di accettarlo prima di collegare. Ne fanno parte Neon, Firebase, Supabase, Airtable, Cloudinary, Algolia e AWS S3. Notion, Google Sheets, WordPress, Contentful, Storyblok e Webflow mostrano No usage charges.
- Ogni chiamata che un’app pubblicata fa tramite Setherion usa un credito di integrazione. Vedi Crediti.
- Test connection c’è per ogni servizio qui, tranne Firebase.
- In uno spazio di lavoro di team, il proprietario può prestare alcune connessioni alle app dei membri (vedi Spazi di lavoro). Supabase, Neon e Firebase non vengono mai prestati, e nemmeno ogni servizio i cui valori sono incorporati nell’app pubblicata: qui Cloudinary, Algolia e Google Sheets.
Database e tabelle
Supabase
A cosa serve. Il tuo progetto Supabase: il suo database, l’accesso e l’archiviazione dei file. È facoltativo, perché ogni app ha già un backend. Sceglilo quando vuoi i dati di un’app in un progetto tuo. Finché Supabase è attivo per un’app, quell’app lo usa per dati, accesso e file al posto del backend integrato.
Collega. Incolla il Project URL (come https://abcdefgh.supabase.co) e la Anon Key, entrambi da Supabase sotto Project Settings, poi API. La chiave anon inizia con eyJ o sb_publishable_; usa il pulsante di copia di Supabase, perché una chiave tagliata viene rifiutata. La Service Role Key è facoltativa e inizia con eyJ o sb_secret_.
Creare le tabelle. Premi Connect Supabase account, accedi a Supabase e approva. Poi, in un’app che ha bisogno di tabelle, Manage, poi Cloud, ha un pulsante che le crea nel tuo progetto ogni volta che lo premi. Il permesso resta sui nostri server. Senza di esso, lo stesso SQL è lì da copiare in Supabase da te. Una volta collegato il tuo account, un elenco Your projects ti permette anche di premere Use this project invece di incollare le chiavi.
Chiedi. “Salva le prenotazioni nel mio Supabase e fai accedere i clienti con l’e-mail.” “Aggiungi una tabella per i prodotti con un nome, un prezzo e una foto.”
Da sapere. Le app sul tuo Supabase non possono ancora usare i Segreti. Per spostare un’app che ha già dati, vedi Impostazioni avanzate.
Neon
A cosa serve. Il tuo Postgres su Neon come database dell’app. Setherion lo raggiunge tramite la Data API di Neon, e Postgres stesso decide chi vede quale riga, con la sicurezza a livello di riga. Va bene per un’app in cui ogni persona vede le proprie righe, un catalogo che chiunque può leggere o una vista per il team.
Collega. Incolla il Data API address da Neon: il tuo progetto, poi Data API, l’endpoint REST che termina con /rest/v1. Deve essere su neon.tech. Poi premi Test connection. Finché a Neon non è stato detto di fidarsi di Setherion, rifiuta, e il risultato ti dà l’indirizzo JWKS da incollarvi.
Il passaggio JWKS. In Neon, apri Data API, poi Authentication, scegli un provider personalizzato e incolla quell’indirizzo JWKS. Lascia vuoto l’audience. È così che Neon impara a fidarsi della persona con cui hai effettuato l’accesso, che Setherion invia con ogni chiamata. Se Test dice ancora di no dopo qualche minuto, rimuovi il provider in Neon e aggiungilo di nuovo.
Chiedi. “Tieni una lista di cose da fare per ogni persona che ha effettuato l’accesso nel mio database Neon.” “Mostra la tabella dei prodotti da Neon come pagina di un negozio, filtrata per categoria.”
Permessi. Tre interruttori sotto Permissions: leggere le righe, aggiungere, modificare ed eliminare le righe, ed eseguire funzioni del database.
Da sapere. Le tabelle esistono solo dopo che hai eseguito l’SQL che l’IA scrive per loro (un file chiamato neon/setup.sql), una volta, nello SQL Editor di Neon. Un visitatore che non ha effettuato l’accesso raggiunge solo ciò che hai concesso al ruolo anonimo di Neon.
Firebase
A cosa serve. Firestore per i dati e Firebase Authentication per l’accesso, dal tuo progetto Firebase. Nient’altro di Firebase è stato costruito.
Collega. Tre valori, dalle impostazioni dell’app web del tuo progetto nella console di Firebase: la API Key (inizia con AIza), il Project ID e l’App ID (come 1:123:web:abc). Tutti e tre sono pubblici per natura e vanno nell’app pubblicata. Per Firebase non c’è Test connection: Connect conserva i valori.
Chiedi. “Fai registrare le persone e tieni un elenco privato di note in Firestore.” “Mostra un elenco in tempo reale di messaggi dal mio progetto Firebase.”
Da sapere. Su Firebase a proteggere i tuoi dati non è la chiave: sono le regole di sicurezza. Chiunque può leggere le impostazioni da un’app pubblicata, quindi un progetto lasciato in modalità di test è aperto a tutto internet. Imposta le regole di Firestore nella console di Firebase prima che l’app memorizzi qualcosa di personale. L’IA scrive ogni documento in modo che appartenga a un ID utente di Firebase Authentication, e lo dice sullo schermo quando l’app memorizza dati personali.
Airtable
A cosa serve. Una tabella di righe come database dell’app: un CRM, un elenco di scorte, contenuti che tieni in Airtable.
Collega. Premi Connect with Airtable, accedi e spunta le base che l’app può usare, poi premi Choose base e scegline una. Oppure usa le chiavi: un Personal Access Token (inizia con pat) dal tuo account Airtable e il Base ID (inizia con app, mostrato nell’indirizzo della tua base).
Chiedi. “Mostra le mie scorte dalla tabella Products di Airtable, con la foto e il prezzo.” “Aggiungi ogni richiesta dal modulo di contatto come nuova riga nella mia tabella Enquiries.”
Limiti. Le app raggiungono l’unica base che hai scelto e nient’altro nel tuo account, anche se il token potrebbe di più. Una tabella con spazi nel nome viene gestita per te. Airtable restituisce le tabelle lunghe una pagina alla volta, e all’app viene detto di recuperare ogni pagina o di dire che l’elenco è parziale. Test connection legge le tabelle della base, quindi fallisce se quella base non era stata spuntata.
Pagine e fogli
Notion
A cosa serve. Un database di Notion come sistema di contenuti leggero o elenco di attività, e pagine di Notion mostrate o compilate da un’app.
Collega. Premi Connect with Notion, accedi e spunta le pagine che l’app può usare. L’app può allora leggere e scrivere quelle pagine e nient’altro. Oppure usa un token: crea un’integrazione interna su notion.so/my-integrations e incolla il suo Internal Integration Token (inizia con ntn_ o secret_), con un Default Database ID facoltativo. Con un token, condividi ogni pagina o database con l’integrazione in Notion, altrimenti Notion risponde 404 a tutto.
Chiedi. “Mostra la pagina del team dal mio database Notion, con la foto e il ruolo di ogni persona.” “Aggiungi ogni messaggio del modulo come nuova riga tra le mie attività su Notion.”
Limiti. Una query restituisce al massimo 100 righe, quindi per un database lungo all’app viene detto di continuare a chiedere finché Notion non dice che non ce ne sono altre.
Da sapere. L’IA che crea le tue app può anche leggere il tuo Notion tramite un server MCP, che è una cosa separata: vedi I tuoi server MCP.
Google Sheets
A cosa serve. Un foglio di calcolo che modifichi come dati dell’app: prezzi, un menu, annunci, membri del team, e iscrizioni raccolte in righe.
Collega, con il pulsante. Premi Connect with Google, accedi, poi premi Choose spreadsheet e scegli quel singolo file. Il foglio resta privato, l’app lo legge e lo scrive tramite Setherion, e il resto del tuo Drive resta fuori portata.
Collega, con una chiave. Incolla una chiave API di Google con la Google Sheets API abilitata in Google Cloud, limitata a quell’API e al tuo sito, e l’ID del foglio. Questo modo funziona solo su un foglio condiviso come “chiunque abbia il link può visualizzare”, e solo in lettura.
Chiedi. “Mostra il listino prezzi dal mio foglio e aggiornalo quando modifico il foglio.” “Aggiungi ogni richiesta di prenotazione come nuova riga in fondo al mio foglio.”
Limiti. Con il pulsante, un foglio di calcolo e le schede al suo interno. Un intervallo indica una scheda, quindi se rinomini una scheda, dillo nella chat.
Notion, Airtable e Google Sheets vengono raggiunti tramite Setherion per conto di chiunque apra la tua app pubblicata. Collega solo ciò che l’app deve mostrare o compilare.
Contenuti da un CMS
Questi quattro leggono contenuti che scrivi altrove e li mostrano nella tua app. Tutti e quattro solo leggono, e solo ciò che è pubblicato: una bozza non arriva mai a una pagina pubblica.
WordPress
A cosa serve. Gli articoli, le pagine e i media pubblicati di un sito WordPress, mostrati dentro un’app: un blog, una pagina di notizie, un portfolio.
Collega. Il Site address (deve iniziare con https://), un Username e una Application password. Creala in WordPress sotto Users, poi Profile, poi Application Passwords, poi Add New. Il piano gratuito di WordPress.com non le offre. Test connection accede al sito.
Chiedi. “Aggiungi una pagina del blog che elenca i miei 10 articoli WordPress più recenti con le loro immagini.” “Mostra ogni articolo nella sua pagina, a partire dal suo slug.”
Permessi. Un interruttore Read ciascuno per articoli, pagine, immagini e file, categorie, tag e commenti.
Da sapere. Sul sito non viene mai scritto nulla. Articoli e pagine vengono mostrati come pubblicati, e i commenti come approvati. Il testo di un articolo arriva come HTML dal tuo sito, quindi l’app lo disegna con la propria tipografia.
Contentful
A cosa serve. Voci scritte in Contentful: articoli, prodotti, pagine, membri del team, qualunque siano i tuoi tipi di contenuto.
Collega. Lo Space ID (Settings, poi General settings) e il Content Delivery API token (Settings, poi API keys). Usa il token di consegna, non quello di gestione. L’Environment è facoltativo ed è master se lasciato vuoto. Test connection legge i tuoi tipi di contenuto.
Chiedi. “Mostra i miei articoli del blog da Contentful, dal più recente, con l’immagine di copertina.” “Crea una pagina per ogni voce di prodotto, trovata dal suo slug.”
Permessi. Un interruttore Read ciascuno per voci, immagini e file, e tipi di contenuto.
Da sapere. I nomi dei campi vengono dal tuo modello di contenuto, quindi l’IA legge prima i tipi di contenuto invece di tirare a indovinare. Un campo di testo ricco arriva come un albero di documento che l’app disegna da sola.
Storyblok
A cosa serve. Storie, pagine e blocchi scritti in Storyblok: un blog, una landing page, un elenco di prodotti o di membri del team.
Collega. Un Access token: in Storyblok, Settings, poi Access tokens, un token Public. La Region è facoltativa: eu (quella predefinita) o us, come mostrato nelle impostazioni del tuo space.
Chiedi. “Elenca le storie più recenti nella cartella del blog.” “Crea la pagina Chi siamo dalla storia con lo slug about.”
Permessi. Un interruttore Read ciascuno per storie, link, voci di datasource e tag.
Da sapere. Viene letto solo contenuto pubblicato: Setherion lo impone, quindi un token di anteprima incollato per errore non può mettere bozze su una pagina pubblica. Una storia è un albero di blocchi, e l’app disegna quelli che usa il tuo space.
Webflow
A cosa serve. Le raccolte che scrivi nel CMS di Webflow: un blog, un team, un menu, progetti o sedi.
Collega. Un Site API token. In Webflow apri Site settings, poi Apps & integrations, poi API access, e genera un token con CMS e Sites impostati su sola lettura.
Chiedi. “Mostra gli articoli più recenti del blog dalla mia raccolta Webflow.” “Dai a ogni membro del team la sua pagina, a partire dallo slug della voce.”
Limiti. Vengono lette solo le voci pubblicate. Arrivano dalla cache di Webflow, quindi una modifica può impiegare qualche minuto per comparire. Le chiamate che trovano il tuo sito e le sue raccolte contano nel limite di Webflow di 60 al minuto sui piani più piccoli, quindi all’app viene detto di tenere le loro risposte per un giorno invece di chiedere a ogni visita. Questo connettore non ha interruttori per i permessi.
File, immagini e ricerca
AWS S3
A cosa serve. I file che le persone caricano nelle tue app (foto, documenti, allegati), conservati nel tuo bucket S3. Il backend integrato conserva record e nessun file, quindi è qui che vanno i caricamenti.
Collega. Quattro valori: la Bucket region (come eu-west-2, che è Londra), il Bucket name (lettere minuscole, cifre e trattini, senza punti), e un Access key ID e una Secret access key da AWS sotto IAM, poi Users, un utente creato solo per Setherion, poi Security credentials, poi Create access key. Il segreto viene mostrato una sola volta. Test connection legge il bucket, poi carica un piccolo file di prova tramite un link firmato, lo rilegge, lo elimina e controlla che il tuo bucket permetta ai browser di caricare. Se quest’ultimo controllo fallisce, guarda prima le impostazioni CORS del bucket.
Chiedi. “Permetti ai clienti di allegare una foto alla loro richiesta di riparazione.” “Mostra i documenti caricati di ogni ordine nella pagina dell’ordine.”
Limiti.
- I file arrivano fino a 25 MB ciascuno.
- Ogni app ha la propria cartella nel bucket,
apps/seguito dall’ID dell’app, e Setherion rifiuta qualsiasi chiave al di fuori di essa. Un solo bucket può servire tutte le tue app senza che una legga i file di un’altra. - I visitatori non possono elencare i file. Un file si raggiunge con la sua chiave, che l’app conserva insieme al record, e i link che mostrano un file durano un’ora.
- Elencare ed eliminare i file di un’app è solo per il team dell’app. Caricare e mostrare sono aperti a chiunque usi l’app.
Permessi. Tre interruttori: caricare file, mostrare file, ed elencare ed eliminare file.
Da sapere. Un selettore di file nell’anteprima dell’editor carica nel tuo bucket vero, proprio come l’app pubblicata.
Cloudinary
A cosa serve. Caricare immagini e file da un’app e consegnarli alla dimensione mostrata, tramite la CDN di Cloudinary.
Collega. Quattro valori: Cloud Name, un Unsigned Upload Preset, una API Key e un API Secret. Crea il preset in Cloudinary sotto Settings, poi Upload, come preset unsigned. Le chiavi sono sotto Settings, poi API keys. Senza un preset, il caricamento non può funzionare, e l’app lo dice invece di far finta.
Chiedi. “Permetti ai venditori di caricare le foto dei prodotti e mostrale alla dimensione giusta.” “Aggiungi una pagina galleria dove i visitatori possono inviare immagini.”
Limiti. Il browser carica direttamente sul tuo Cloudinary con il preset. Il cloud name e il preset vanno nell’app pubblicata, come previsto da Cloudinary. L’API secret no: Setherion usa la chiave e il segreto solo per Test connection, quindi nessun segreto si trova mai nell’app. Ogni caricamento e ogni visualizzazione sono sul tuo account Cloudinary.
Da sapere. La skill File upload è costruita su questo connettore: vedi Skills.
Algolia
A cosa serve. Ricerca istantanea, mentre si digita, su prodotti, articoli o qualsiasi elemento che indicizzi.
Collega. Tre valori dalla dashboard di Algolia sotto Account, poi API keys: l’Application ID, la Admin API Key e la Search-Only API Key.
Le due chiavi. I visitatori cercano nel loro browser con la chiave di sola ricerca, che si può pubblicare senza rischi e va nell’app. La chiave admin può eliminare un indice, quindi non lascia mai i nostri server: l’app la usa tramite Setherion solo per indicizzare i record. Senza una chiave di sola ricerca salvata, la ricerca non può funzionare, e l’app lo dice invece di ripiegare sulla chiave admin. Eliminare record o un indice, svuotarlo o spostarne uno sopra un altro è riservato al tuo team; aggiungere e aggiornare record funziona per chiunque usi l’app.
Chiedi. “Aggiungi al negozio una casella di ricerca che trova i prodotti mentre digito.” “Indicizza i miei prodotti in Algolia quando ne aggiungo uno.”
Da sapere. La skill Search è costruita su questo connettore: vedi Skills.
Questa pagina ti è stata utile?
