Come collegare Sanity a Cursor via MCP

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

Sanity + Cursor

Fai lavorare la tua AI con i contenuti di Sanity: esegui query GROQ, leggi documenti, le loro revisioni e la cronologia delle modifiche, elenca tipi di documento, dataset e progetti, e crea, modifica e pubblica bozze dopo la tua conferma. Token API con permessi Viewer o Editor.

Prerequisiti

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

SANITY_PROJECT_ID, SANITY_DATASET, SANITY_API_TOKEN

Step 1 — Ottieni le credenziali

1. Apri https://www.sanity.io/manage, scegli il progetto e copia il suo Project ID (8 caratteri, per esempio abc12xyz) in SANITY_PROJECT_ID.

2. In Datasets annota il dataset su cui lavorare, di solito production, e mettilo in SANITY_DATASET.

3. In API → Tokens fai clic su Add API token, dagli un nome e scegli il permesso:

   • Viewer legge documenti pubblicati e bozze, cronologia compresa. Basta per tutti i tool di lettura; le scritture vengono rifiutate.
   • Editor può anche scrivere. Serve per creare, modificare e pubblicare bozze.

   Evita i token Developer e Administrator: possono anche cambiare le impostazioni del progetto e i dataset.

4. Copia il token in SANITY_API_TOKEN (Sanity lo mostra una sola volta) e installa il connettore. Verifica la configurazione con sanity_list_document_types.

Query GROQ: sanity_query esegue GROQ sul tuo dataset, così l'AI risponde a domande come "quali articoli non hanno una descrizione SEO" o "quanti prodotti sono esauriti" con una sola chiamata. Chiede solo i campi che le servono, limita il numero di risultati perché le risposte oltre circa 60 KB vengono troncate, e passa i valori come parametri. Se non conosce ancora il tuo schema, elenca prima i tipi di documento e guarda qualche documento. Con la prospettiva drafts legge i contenuti come se tutte le bozze fossero pubblicate.

Prima la bozza, online solo dopo il tuo sì: sanity_create_draft e sanity_patch_draft scrivono sempre e solo la bozza, la versione che i redattori vedono in Sanity Studio. Nulla arriva sul tuo sito finché sanity_publish_draft non sostituisce il documento pubblicato. Prima di ognuno di questi passi l'AI ti mostra il documento, la modifica e se andrà online, e aspetta un sì chiaro. Una prova a vuoto (dry run) verifica un'azione senza salvarla. sanity_delete_document è installato disattivato.

Cronologia: sanity_list_document_transactions mostra chi ha modificato un documento e quando, e sanity_get_document_revision restituisce il documento com'era a una revisione o a un certo momento, per esempio per confrontare due versioni o recuperare un testo sovrascritto.

Rich text: i campi Portable Text sono array di blocchi, e ogni blocco ha bisogno di una _key univoca. Il connettore spiega all'AI come scrivere semplici paragrafi.

Errori comuni: 401 Session not found: il token è errato o è stato eliminato. 403 Insufficient permissions: un token Viewer ha provato a scrivere, oppure il token appartiene a un altro progetto. 404 Dataset not found: controlla SANITY_DATASET. 400 queryParseError: la query GROQ ha un errore di sintassi, e il messaggio indica dove.

Non incluso: caricamento di immagini e file, content release e pubblicazione programmata, ritiro della pubblicazione, gestione di dataset e progetti, webhook, CORS, membri e ascolto in tempo reale.

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Sanity.

Tool disponibili

Esempi di prompt

• "Quali articoli del blog sono stati pubblicati negli ultimi 30 giorni? Mostra titolo, autore e slug."
• "Trova tutti i prodotti con una descrizione vuota o più corta di 50 caratteri."
• "Chi ha modificato per ultimo la pagina dei prezzi, e cosa diceva prima di quella modifica?"
• "Correggi il refuso 'primavrea' nel titolo dell'articolo sul lancio di primavera. Salvalo come bozza e mostrami la modifica prima di salvare."
• "Pubblica la bozza dell'articolo 'Note di rilascio ottobre'. Dimmi prima esattamente cosa andrà online."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

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