Come collegare Sanity a Meta Muse 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 + Meta Muse

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 Muse

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.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richiede i tool di Sanity.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.

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

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

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