Come collegare Webflow a Gemini via MCP

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

Webflow + Gemini

Fai lavorare la tua AI su un sito Webflow: leggi il sito, le sue pagine e impostazioni SEO, collection e item del CMS, moduli e invii, asset, prodotti e ordini e-commerce; crea bozze e aggiorna item del CMS e pubblica item o l'intero sito dopo il tuo via libera. Con un API token del sito.

Prerequisiti

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

WEBFLOW_API_TOKEN

Step 1 — Ottieni le credenziali

1. Accedi su https://webflow.com/dashboard, passa con il mouse sul sito e clicca sulla sua icona a forma di ingranaggio per aprire le Site settings. Devi essere amministratore del sito.
2. Nella barra laterale sinistra scegli Apps & integrations, scorri fino a API access in fondo alla pagina e clicca su Generate API token.
3. Dai un nome al token (per esempio "AnythingMCP") e scegli questi scope:
   • sites:read, sites:write (per pubblicare il sito)
   • pages:read, pages:write (per le impostazioni delle pagine)
   • cms:read, cms:write (per creare, modificare, pubblicare, ritirare o eliminare item)
   • forms:read, assets:read
   • ecommerce:read (solo su un sito e-commerce)
4. Clicca su Generate token, copia subito il token e inseriscilo in WEBFLOW_API_TOKEN senza la parola Bearer, poi installa il connettore.
5. Comincia con webflow_get_token_info: mostra gli scope e l'id del sito a cui il token dà accesso. Poi webflow_list_sites restituisce i dettagli del sito; il suo id è il site_id che usano gli altri strumenti.

Scope: a un token esistente non si possono aggiungere scope. Se uno strumento risponde 403 missing_scopes, genera un nuovo token con lo scope mancante e inseriscilo in WEBFLOW_API_TOKEN.

Solo lettura: seleziona solo gli scope :read e disattiva webflow_publish_site, webflow_update_page_settings, webflow_create_item, webflow_update_item, webflow_publish_items, webflow_create_live_item e webflow_update_live_item.

Disattivati all'installazione: webflow_delete_item, che elimina definitivamente un item del CMS, e webflow_unpublish_live_item, che toglie dal sito un item pubblicato (resta nel CMS come bozza). Attivali solo se l'AI deve eliminare o ritirare item.

Un sito per token: un token del sito raggiunge solo il sito su cui è stato generato. Un sito può avere fino a 5 token, e un token scade dopo 365 giorni di inutilizzo. Per più siti, installa il connettore una volta per sito.

Piani: l'API funziona con ogni piano del sito, compreso il piano gratuito Starter. Gli strumenti del CMS richiedono un piano che lo includa: Starter ne ha uno piccolo (20 collection, 50 item), Basic nessuno. Su Starter Webflow può rifiutare la pubblicazione di singoli item (webflow_publish_items, webflow_create_live_item, webflow_update_live_item, webflow_unpublish_live_item), perché la indica come funzione dei piani CMS a pagamento: pubblica invece l'intero sito. Prodotti e ordini richiedono un piano e-commerce; gli altri siti rispondono 409.

Contenuti staged e live: ogni item del CMS ha una versione staged (quella che vedono i redattori) e, una volta pubblicato, una versione live sul sito. webflow_create_item e webflow_update_item cambiano solo i contenuti staged, quindi sul sito pubblico non cambia nulla; i nuovi item sono bozze. webflow_publish_items mette online gli item scelti e webflow_publish_site pubblica tutte le modifiche staged del sito, pagine e item. webflow_create_live_item e webflow_update_live_item scrivono direttamente sul sito pubblico. Segnare come bozza un item pubblicato non lo toglie dal sito; archiviarlo sì, alla pubblicazione successiva del sito. webflow_list_items mostra gli item staged, webflow_list_live_items ciò che vedono i visitatori.

Pubblicare è pubblico: prima conferma. Prima di pubblicare il sito o degli item, scrivere item live o modificare le impostazioni di una pagina (titoli, slug, testi SEO e Open Graph con webflow_update_page_settings), l'AI ti dice esattamente cosa cambierà sul sito e aspetta il tuo sì. Webflow accetta una pubblicazione del sito riuscita al minuto.

Dati dei campi: il contenuto di un item usa come chiave lo slug di ciascun campo indicato da webflow_get_collection, non il nome visualizzato; name e slug sono obbligatori per un nuovo item. Il rich text è HTML, un riferimento vuole l'id di un item e una nuova immagine è un URL pubblico (al massimo 4 MB) nella forma {"url": "https://..."}. Cambiare lo slug di un item rompe i link al vecchio URL.

Lingue: su un sito localizzato webflow_get_site elenca le lingue (locale). Se non ne indichi una, gli strumenti usano quella principale.

Limiti di frequenza: per token, 60 richieste al minuto con i piani del sito Starter e Basic, 120 con i piani CMS, e-commerce e Business. Oltre il limite Webflow risponde 429 con un header Retry-After, di solito 60 secondi: attendi e riprova. Gli strumenti di elenco restituiscono al massimo 100 voci per pagina.

Errori comuni: 400 indica il campo che non va: uno slug di campo sconosciuto, un valore nel formato sbagliato oppure name o slug mancanti. 401 significa che il token è sbagliato, revocato o scaduto: generane uno nuovo in Site settings → Apps & integrations → API access. 403 (missing_scopes o forbidden) significa che al token manca uno scope (genera un nuovo token che lo includa) o che il piano del sito non comprende la funzione. 404 è un id sbagliato o un id di un altro sito. 409 significa che la richiesta è in conflitto con lo stato del sito, per esempio chiamate e-commerce su un sito senza e-commerce. 429 è il limite di frequenza: attendi il tempo indicato da Retry-After.

Il connettore non crea né modifica collection e campi, non modifica contenuti delle pagine, componenti o custom code, non carica né elimina asset, non modifica gli invii dei moduli né prodotti e ordini, e non gestisce webhook, commenti o analytics.

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

Tool disponibili

Esempi di prompt

• "Elenca le pagine del nostro sito Webflow a cui manca il titolo SEO o la meta description."
• "Quali articoli del blog nel CMS sono ancora in bozza, e quando sono stati aggiornati l'ultima volta?"
• "Mostrami gli invii del modulo di contatto di questa settimana con nome, azienda e messaggio."
• "Crea nella collection Blog un nuovo articolo intitolato "Novità di prodotto di primavera" con un breve riassunto, solo come bozza. Non pubblicarlo."

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