Come collegare Prismic a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Prismic, installalo senza chiave, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Prismic + Gemini

Il page builder headless Prismic, senza chiave per un repository pubblico: interroga documenti pubblicati e pianificati con i filtri di Prismic, leggi documenti per id, UID o tipo, leggi i modelli di custom type e slice, sfoglia e carica media, e crea o aggiorna bozze di documenti tramite la Migration API.

Prerequisiti

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

PRISMIC_REPOSITORY (facoltativo: PRISMIC_ACCESS_TOKEN, PRISMIC_WRITE_TOKEN)

Step 1 — Configura il connettore

Repository pubblico, senza chiave: la configurazione richiede circa 3 minuti. Il connettore legge un repository Prismic tramite la Content API (https://<repository>.cdn.prismic.io/api/v2). Quando questa API è pubblica, basta il nome del repository. Modelli di contenuto, media e scritture passano dalle API di scrittura di Prismic (la Types API, la Asset API e la Migration API) e richiedono un write token.

1. PRISMIC_REPOSITORY: il nome del repository, la parte prima di .prismic.io nell'URL della dashboard, per esempio your-repo-name.
2. PRISMIC_ACCESS_TOKEN (facoltativo): solo se la Content API è privata. Nel repository apri Settings > API & Security e genera un access token, oppure esegui npx prismic token create. Lascialo vuoto per un'API pubblica.
3. PRISMIC_WRITE_TOKEN (facoltativo): serve per ogni strumento con la nota "Needs the write token" e per tutte le scritture. Apri Settings > API & Security > Write APIs e genera un token, oppure esegui npx prismic token create --write. Viene inviato come Authorization: Bearer <token> insieme all'header repository. Ha diritti ampi, quindi affidalo solo a workspace fidati.
4. Installa il connettore ed esegui prismic_get_repository per verificare il nome del repository.

Il server MCP di Prismic: Prismic gestisce anche un proprio server MCP (https://mcp.prismic.io/mcp, accesso via OAuth) per modificare e pubblicare da un assistente. Questo connettore è l'alternativa basata su token.

Leggere i contenuti in due passi:

1. prismic_get_repository restituisce refs. L'AI prende il ref della voce con isMasterRef: true per i contenuti pubblicati, oppure il ref di una release per vedere in anteprima i contenuti pianificati. Ogni query sui contenuti ne ha bisogno, e cambia a ogni pubblicazione. La stessa risposta elenca custom type, tag, lingue e bookmark.
2. Poi prismic_search_documents con i filtri in q, prismic_get_document per id, prismic_get_document_by_uid per tipo e UID (per esempio tipo page e uid about-us), oppure prismic_list_documents_by_type. lang, fetch_links e graph_query danno forma alla risposta.

Filtri (q): [[at(document.type,"blog_post")]]; più filtri in fila si combinano: [[at(document.type,"blog_post")][any(document.tags,["news","events"])]]. Altri: fulltext(document,"text"), at(my.blog_post.author,"<id>"), date.after(document.first_publication_date,"2026-01-01"), not, in(document.id,[...]), number.lt(my.product.price,100). L'ordinamento usa orderings come [my.blog_post.date desc].

Modelli e media (write token): prismic_list_custom_types e prismic_get_custom_type danno la struttura dei campi di ogni tipo di pagina, con tab, slice zone, ripetibile o singolo e stato; prismic_list_shared_slices e prismic_get_shared_slice le shared slice con le loro varianti. prismic_list_assets sfoglia la libreria media per tipo o parola chiave, prismic_upload_asset carica un file da un URL pubblico e restituisce l'id dell'asset, e prismic_update_asset modifica testo alternativo, crediti e note.

Scrivere documenti (write token): prismic_create_document e prismic_update_document salvano bozze in una migration release. Non sono online finché un redattore non pubblica quella release nella dashboard (scheda Migration Releases); queste API non hanno una chiamata di pubblicazione. L'AI costruisce data dal modello del custom type: il rich text è una lista di blocchi ({"type": "paragraph", "text": "...", "spans": []}), immagini e media prendono un id di asset, i link {"link_type": "Document", "id": "..."} o {"link_type": "Web", "url": "..."}. Un aggiornamento sostituisce tutti i contenuti e i tag, quindi l'AI legge prima il documento e rimanda tutto. Tipo e lingua non si possono cambiare.

Niente è disattivato all'installazione: non ci sono strumenti di eliminazione o di pubblicazione. Modificare i modelli di contenuto ed eliminare restano compiti della dashboard o della CLI di Prismic.

Formati dei dati: le liste di contenuti riportano results, page, total_pages, total_results_size e next_page. I campi rich text arrivano come liste di blocchi; le date sono YYYY-MM-DD, i timestamp ISO 8601. Gli id dei documenti hanno la forma ZMI65RQAADkECUFM.

Paginazione: page (da 1) e page_size (20 di default, al massimo 100), oppure orderings insieme ad after e all'id dell'ultimo documento. Gli asset si paginano con cursor.

Limiti: la Content API consente 200 richieste non in cache al secondo e URL fino a 2.048 caratteri, quindi l'AI tiene corta la graph_query. La Migration API e la Asset API accettano una richiesta al secondo per repository.

Errori comuni: 404 su prismic_get_repository indica un nome di repository sbagliato. 401 o 403 indica un'API privata senza un access token valido, oppure una scrittura senza un write token valido. 400 indica un filtro malformato o un ref non valido, 422 dati che non rispettano il modello.

Il connettore non pubblica documenti, non elimina documenti o asset e non modifica custom type o slice.

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

Tool disponibili

Esempi di prompt

• "Elenca i dieci articoli del blog più recenti con titolo e data della prima pubblicazione."
• "Mostrami la pagina about-us e riassumi le sue slice."
• "Quali documenti hanno il tag news e sono stati pubblicati per la prima volta dopo il 1° gennaio 2026?"
• "Quali campi ha il custom type blog_post?"
• "Crea una bozza di articolo intitolato "La nostra roadmap 2026" con un breve paragrafo introduttivo, da far revisionare a un redattore."

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
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot