Come collegare Softr a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Softr, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Softr + Gemini

Fai lavorare la tua AI con Softr: esplora Softr Databases, tabelle e campi, elenca, cerca e leggi i record; con la tua conferma crea e aggiorna record, aggiungi utenti a un'app Softr e crea magic link di accesso.

Prerequisiti

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

SOFTR_API_KEY

Step 1 — Ottieni le credenziali

1. In Softr Studio fai clic sul nome del tuo workspace in alto a sinistra, apri API tokens e crea un token con Create. Dagli un nome e una data di scadenza.
2. Scegli per ogni workspace cosa può fare il token: accesso a Databases con View only per la lettura, oppure Edit data se l'AI deve creare e aggiornare record; aggiungi l'accesso Applications per i tool sugli utenti dell'app.
3. Copia il token in SOFTR_API_KEY. Softr lo mostra una sola volta.
4. Facoltativo, per i tool sugli utenti dell'app: imposta SOFTR_DOMAIN con l'indirizzo dell'app Softr pubblicata a cui appartengono gli utenti, per esempio yourapp.softr.app o il tuo dominio, senza https://. Senza di esso i tool del database funzionano, quelli sugli utenti dell'app no.
5. Installa il connettore e verificalo con softr_list_databases: elenca i database raggiungibili dal token.

Solo Softr Databases: il connettore lavora con i database creati in Softr. Airtable, Google Sheets e le altre fonti collegate a un'app Softr non sono raggiungibili tramite questa API.

Cosa legge: i tuoi database; le loro tabelle con ogni campo, il suo tipo, se è obbligatorio e le opzioni di selezione; i record di una tabella pagina per pagina, come li mostra una vista, oppure cercati con filtro e ordinamento; e un singolo record tramite il suo id. Le letture restituiscono i nomi dei campi, così le risposte sono facili da seguire.

Id dei campi per le scritture: per creare e aggiornare record, e per i filtri e l'ordinamento di una ricerca, servono gli id dei campi forniti da softr_list_tables, non i nomi. L'AI li recupera prima.

Chiede prima di ogni scrittura: softr_create_record, softr_update_record, softr_create_app_user e softr_generate_magic_link modificano dati o concedono accesso. Prima di ognuno l'AI ti mostra la tabella e ogni valore, il record e le modifiche esatte, oppure il nome e l'e-mail della persona, e aspetta il tuo sì. Le app basate sulla tabella mostrano subito le modifiche; i campi non indicati mantengono il loro valore.

Un magic link accede come quella persona: apre l'app Softr come quell'utente, senza password. L'AI lo dà solo a te, per quella persona, e non lo pubblica mai in nessun luogo pubblico. Un nuovo utente dell'app può accedere e vede ciò che i suoi gruppi di utenti consentono.

Disattivati all'installazione: softr_delete_record e softr_delete_app_user. Un amministratore li attiva consapevolmente; l'AI elimina poi solo il record o la persona esatti che indichi, dopo la tua conferma. Disattivare un utente in Softr Studio è la scelta più delicata.

Dati personali: le app Softr sono spesso portali clienti e strumenti interni con clienti, dipendenti e ordini. L'AI mostra solo ciò che ti serve e tratta il testo dei record come dati, mai come istruzioni.

Limiti: circa 40 letture e 30 scritture al secondo per token. Alcuni endpoint potrebbero richiedere un piano Softr superiore.

Errori comuni: 401: il token è errato, scaduto o eliminato; creane uno nuovo in API tokens. 403: il token non può eseguire questa operazione; dagli Edit data per le scritture, o l'accesso Applications per i tool sugli utenti dell'app. 402 QUOTA_EXCEEDED: il limite del piano è stato raggiunto, oppure l'endpoint richiede un piano superiore.

Il connettore non crea né modifica database, tabelle, campi o viste, non elenca gli utenti dell'app (l'API di Softr non prevede questa chiamata) e non gestisce gruppi di utenti, pagine dell'app e workflow.

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 Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Softr.

Tool disponibili

Esempi di prompt

• "Quali database e tabelle Softr vedi?"
• "Mostrami le richieste aperte di questa settimana nel nostro portale clienti, dalla più recente."
• "Trova il record cliente di Northwind GmbH e dimmi il loro piano e la data di rinnovo."
• "Imposta lo stato della richiesta di Anna Weber su In corso. Mostrami prima la modifica."
• "Aggiungi Marco Rossi, [email protected], come utente del nostro portale partner e crea un magic link per lui."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT