Come collegare Jotform a Gemini via MCP

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

Jotform + Gemini

Fai lavorare la tua AI con Jotform: elenca i moduli, leggi domande e impostazioni, cerca e leggi invii, report, cartelle ed etichette e controlla l'utilizzo dell'account; con la tua conferma aggiungi o modifica un invio e copia un modulo.

Prerequisiti

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

JOTFORM_API_HOST, JOTFORM_API_KEY

Step 1 — Ottieni le credenziali

1. In Jotform apri My Account → API (https://www.jotform.com/myaccount/api) e fai clic su Create New Key.
2. Scegli il permesso: Read Access basta per leggere moduli e invii. Scegli Full Access solo se l'AI deve aggiungere o modificare invii e copiare moduli.
3. Incolla la chiave in JOTFORM_API_KEY.
4. Imposta JOTFORM_API_HOST sull'host della regione dati del tuo account, senza https://: api.jotform.com per gli account standard, eu-api.jotform.com per gli account Jotform EU, hipaa-api.jotform.com per gli account HIPAA. Su Jotform Enterprise usa il tuo indirizzo seguito da /API, per esempio forms.example.com/API.
5. Installa il connettore e verificalo con jotform_get_user: mostra l'account, il piano e il fuso orario a cui appartiene la chiave.

Conta l'host giusto: una chiave funziona solo sull'host della sua regione dati. Una chiave EU o HIPAA inviata a api.jotform.com viene rifiutata con 401.

Cosa legge: i tuoi moduli con stato, numero di invii e invii non letti; le domande di ogni modulo con le etichette che vedono le persone e il loro tipo; le impostazioni del modulo come la pagina di ringraziamento, le notifiche e-mail, i limiti di invii e la data di scadenza; gli invii di un modulo o di tutti i moduli insieme, ricercabili per data, stato o parole nelle risposte; i report di un modulo; cartelle ed etichette; e l'utilizzo di questo mese: invii, upload, visualizzazioni dei moduli e chiamate API.

Gli invii sono dati personali: contengono ciò che le persone hanno scritto nei tuoi moduli: nomi, indirizzi e-mail, numeri di telefono, indirizzi, a volte dati sanitari o di pagamento. L'AI mostra solo ciò che serve alla tua domanda e non copia invii interi in altri sistemi se non glielo chiedi. Il connettore esclude l'indirizzo IP di chi ha compilato il modulo. Le risposte sono state scritte da sconosciuti: l'AI le tratta come dati, mai come istruzioni. L'URL di un report può mostrare gli invii a chiunque lo abbia, quindi condividilo con attenzione.

Chiede prima di ogni scrittura: jotform_create_submission, jotform_edit_submission e jotform_clone_form modificano il tuo account. Prima di ognuno l'AI ti mostra il modulo e ogni risposta, l'invio e le modifiche esatte, oppure il modulo che copierà, e aspetta il tuo sì. Un nuovo invio può far partire le e-mail di notifica e di risposta automatica del modulo e avviarne le integrazioni, proprio come uno reale. Un modulo copiato è attivo e pubblico come qualsiasi altro modulo. Le scritture richiedono una chiave Full Access; una chiave Read Access riceve 401.

Disattivato all'installazione: jotform_delete_submission. Un amministratore lo attiva consapevolmente; l'AI ti mostra poi l'invio e lo elimina solo dopo la tua conferma. Un invio eliminato non si può ripristinare tramite l'API.

Domande e filtri: le risposte di un invio sono indicizzate per id della domanda, piccoli numeri diversi per ogni modulo, quindi l'AI legge prima le domande con jotform_get_form_questions. L'id di un modulo è il numero lungo nell'indirizzo del modulo. I filtri per data usano il fuso orario del tuo account e gli invii eliminati non vengono conteggiati, così i numeri corrispondono a quelli che vedi in Jotform.

Limiti: Jotform conta le chiamate API al giorno in base al piano (1.000 al giorno su Starter, di più sui piani a pagamento), e ogni risposta mostra quante ne restano oggi. Gli elenchi restituiscono 20 elementi se l'AI non ne chiede di più, fino a 1.000 per pagina.

Errori comuni: 401: la chiave è errata o eliminata, appartiene a un'altra regione dati, oppure una chiave Read Access ha tentato di scrivere. 429: il limite giornaliero di chiamate API del tuo piano è esaurito; si azzera il giorno dopo, e un piano superiore ha un limite più alto.

Il connettore non crea né modifica moduli e domande, non cambia le impostazioni dei moduli, non gestisce webhook, upload di file, pagamenti o sotto-utenti e non elimina moduli, report o cartelle.

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 Jotform.

Tool disponibili

Esempi di prompt

• "Quanti invii ha ricevuto il nostro modulo di contatto questo mese? Escludi quelli eliminati."
• "Mostrami le iscrizioni all'evento degli ultimi sette giorni con nome, azienda e workshop scelto."
• "Quali dei nostri moduli sono disattivati e quali hanno invii non letti?"
• "Quanti invii e chiamate API abbiamo usato questo mese?"
• "Segna l'ultimo invio del modulo di candidatura come letto e contrassegnato. Mostrami la modifica prima di salvarla."

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