Come collegare Contentful a Gemini via MCP

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

Contentful + Gemini

Fai lavorare la tua AI con i contenuti di Contentful: cerca entry e asset, leggi content type, locale e tag, e crea, modifica, pubblica o ritira le entry. Delivery token per leggere, management token per scrivere.

Prerequisiti

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

CONTENTFUL_SPACE_ID, CONTENTFUL_ENVIRONMENT, CONTENTFUL_DELIVERY_URL, CONTENTFUL_DELIVERY_TOKEN

Step 1 — Ottieni le credenziali

1. In Contentful (https://app.contentful.com) apri il tuo space, poi Settings → API keys → Add API key. Dai un nome alla chiave (per esempio "AnythingMCP"), spunta gli environment che può leggere (almeno master) e salva.
2. Copia lo Space ID in CONTENTFUL_SPACE_ID e il Content Delivery API access token in CONTENTFUL_DELIVERY_TOKEN.
3. Imposta CONTENTFUL_ENVIRONMENT sull'id dell'environment, di solito master. Gli altri environment sono elencati in Settings → Environments.
4. Imposta CONTENTFUL_DELIVERY_URL su https://cdn.contentful.com, oppure https://cdn.eu.contentful.com per uno space nella regione dati UE, senza slash finale. Per far leggere all'AI anche le bozze, usa https://preview.contentful.com (o https://preview.eu.contentful.com) insieme al Content Preview API access token della stessa chiave.
5. Per scrivere, crea un personal access token: menu dell'avatar → Account settings → CMA tokens → Create personal access token. Scegli una scadenza e copia subito il token, perché Contentful lo mostra una sola volta. Incollalo in CONTENTFUL_MANAGEMENT_TOKEN, senza la parola Bearer, e imposta CONTENTFUL_MANAGEMENT_URL su https://api.contentful.com (o https://api.eu.contentful.com). Il token agisce a tuo nome, in ogni space che puoi modificare.
6. Se la tua organizzazione deve approvare i personal access token, un admin dell'organizzazione apre Organization settings, trova il token nelle impostazioni di accesso dei personal access token e gli concede l'accesso. Fino ad allora gli strumenti di scrittura rispondono 401 OrganizationAccessGrantRequired; la lettura con il delivery token non ne risente.
7. Installa il connettore e parti da contentful_get_space: restituisce il nome dello space e i suoi locale, un controllo rapido che Space ID e delivery token vadano insieme.

Due token, di proposito: il delivery token legge i contenuti pubblicati e nient'altro (anche le bozze, con il preview token), quindi un connettore configurato solo con i quattro valori obbligatori può consultare tutto ma non cambia niente. Scritture, bozze non pubblicate, space ed environment passano dalla Content Management API con il personal access token. Se lasci vuoti CONTENTFUL_MANAGEMENT_URL e CONTENTFUL_MANAGEMENT_TOKEN, gli strumenti di gestione segnalano semplicemente che mancano.

Pubblicare cambia il sito live: contentful_publish_entry e contentful_unpublish_entry cambiano ciò che i visitatori vedono sul tuo sito o nella tua app, quindi l'AI indica l'entry e l'effetto e aspetta il tuo ok. contentful_delete_entry è disattivato all'installazione, perché un'entry eliminata non si può recuperare.

Come funzionano le modifiche: contentful_list_content_types fornisce gli id dei content type e dei campi, contentful_list_locales i codici dei locale. I valori dei campi sono organizzati per id del campo e poi per locale, per esempio {"title": {"en-US": "Hello"}}. Prima di ogni modifica l'AI legge l'entry con contentful_get_entry_for_editing per avere la sua sys.version attuale; se nel frattempo qualcun altro ha salvato, Contentful risponde 409 VersionMismatch e l'AI rilegge. contentful_update_entry sostituisce tutti i campi, quindi ciò che manca viene cancellato; per uno o due campi l'AI usa contentful_patch_entry. Una modifica va online solo quando la nuova versione viene pubblicata.

Ricerca: contentful_list_entries accetta un content_type, una ricerca full-text query e altri filtri come fields.slug=hello o fields.date[gte]=2026-01-01. Per filtrare o ordinare per un campo serve content_type. Entry e asset collegati tornano in includes, e gli URL degli asset iniziano con //, quindi l'AI aggiunge https:.

Paginazione: le liste restituiscono total, skip e limit (fino a 1.000); la pagina successiva parte da skip + limit.

Errori comuni: 401 AccessTokenInvalid indica un token sbagliato o scaduto, oppure un delivery token usato sull'host di preview (o viceversa). 404 NotFound è un id sbagliato, o uno space o environment non coperto dal token: qui Contentful risponde 404, non 403. 400 "A Content Type ID is required" indica un filtro su un campo senza content_type. 422 ValidationFailed indica il campo vuoto o che viola una validazione. 429 RateLimitExceeded: la management API consente circa 7 richieste al secondo, quindi attendi e riprova.

Il connettore non carica asset, non crea né modifica content type, non gestisce environment, webhook, ruoli e app e non usa l'API GraphQL.

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

Tool disponibili

Esempi di prompt

• "Trova gli articoli del blog pubblicati negli ultimi 30 giorni ed elenca per ognuno titolo, slug e autore."
• "Quali entry hanno modifiche salvate ma non ancora pubblicate?"
• "Elenca le immagini caricate questo mese, con dimensione del file e risoluzione."
• "Cambia il titolo della landing page dei saldi di primavera in 'Saldi di primavera: 20% su tutto' e pubblicala dopo la mia conferma."

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