Strumenti IA

EmDash ha un server MCP integrato che permette agli assistenti IA di lavorare direttamente con i contenuti del tuo sito. Puoi chiedere a Claude, ChatGPT o altri strumenti di redigere post, aggiornare pagine, gestire media, cercare nei tuoi contenuti e altro — il tutto attraverso conversazione naturale.

Il server MCP

Il server MCP è abilitato per impostazione predefinita — la route a /_emdash/api/mcp è montata a meno che non lo disabiliti esplicitamente. Richiede sempre l’autenticazione, quindi nessun contenuto è esposto senza credenziali valide.

Per disabilitarlo, imposta mcp: false nella tua configurazione Astro:

emdash({
  mcp: false,
})

Configurazione

L’URL del server MCP del tuo sito è:

https://example.com/_emdash/api/mcp

Sostituisci example.com con il tuo dominio. Per lo sviluppo locale, usa http://localhost:4321/_emdash/api/mcp.

Cosa puoi fare

Una volta connesso, puoi chiedere all’assistente IA di eseguire qualsiasi di queste operazioni in linguaggio naturale. Non hai bisogno di conoscere i nomi degli strumenti — descrivi semplicemente cosa vuoi.

Contenuti

• Sfogliare i contenuti — “Mostrami gli ultimi 10 post del blog” o “Trova tutte le pagine in bozza”
• Leggere i contenuti — “Prendi il post ‘hello-world’ e riassumilo”
• Creare contenuti — “Scrivi un nuovo post sul blog sui nostri saldi estivi” o “Crea una bozza di pagina per la sezione Chi siamo”
• Modificare i contenuti — “Aggiorna la pagina dei prezzi per menzionare il nuovo piano” o “Correggi il refuso nel post FAQ”
• Pubblicare e programmare — “Pubblica il post dei saldi estivi”, “Programma l’annuncio per il 1° giugno alle 9” o “Annulla la programmazione del post di lancio”
• Confrontare versioni — “Mostrami cosa è cambiato nella homepage dall’ultima pubblicazione”
• Gestire le bozze — “Scarta le modifiche della bozza nella pagina Chi siamo” o “Duplica il template della newsletter”
• Traduzioni — “Quali traduzioni esistono per il post di benvenuto?” (quando i18n è abilitato)

Media

• Sfogliare i media — “Elenca tutte le immagini caricate” o “Mostrami i PDF nella libreria media”
• Verificare i dettagli — “Mostra i dettagli di questo elemento media”
• Registrare upload — “Registra il file che ho appena caricato in media/2026/banner.png come elemento media”
• Aggiornare i metadati — “Imposta il testo alt dell’immagine hero su ‘Tramonto in montagna’”
• Rimuovere file — “Elimina la vecchia immagine del banner”

Ricerca

• Trovare contenuti — “Cerca post che menzionano ‘accessibilità’” o “Trova tutto su TypeScript in tutte le collezioni”

Tassonomie

• Sfogliare — “Elenca tutte le categorie” o “Mostrami i tag”
• Creare termini — “Aggiungi un tag ‘tutorial’” o “Crea una sottocategoria ‘Frontend’ sotto ‘Ingegneria’”
• Rinominare termini — “Rinomina la categoria ‘frontend’ in ‘Web Frontend’”
• Spostare termini — “Sposta il tag ‘tutorial’ sotto la categoria ‘guide’” o “Stacca ‘react’ dal suo genitore”
• Eliminare termini — “Elimina il tag ‘archivio’ inutilizzato”

Menu

• Visualizzare i menu — “Mostrami il menu di navigazione principale” o “Cosa c’è nel menu del footer?”
• Creare menu — “Crea un nuovo menu ‘barra laterale’”
• Modificare menu — “Rinomina il menu ‘principale’ in ‘Navigazione primaria’”
• Impostare gli elementi — “Sostituisci gli elementi del menu principale con Home, Blog, Chi siamo e Contatti”
• Eliminare menu — “Elimina il menu ‘mobile’ inutilizzato”

Impostazioni del sito

• Ispezionare — “Qual è il titolo attuale del sito?” o “Mostrami i link social”
• Aggiornare l’identità — “Imposta il titolo del sito su ‘Acme Blog’ e il sottotitolo su ‘Storie dal team’”
• Impostare logo / favicon — “Usa questa immagine come logo del sito” (dopo averla caricata con media_upload)
• Valori SEO predefiniti — “Imposta l’immagine OG predefinita sul nuovo banner” o “Aggiorna il separatore del titolo con una barra verticale”
• Account social — “Aggiungi i nostri link Mastodon e YouTube alle impostazioni social”

Schema (solo Admin)

• Ispezionare — “Quali collezioni esistono?” o “Mostrami i campi della collezione post”
• Creare collezioni — “Crea una nuova collezione ‘testimonianze’ con campi nome e citazione”
• Modificare lo schema — “Aggiungi un campo booleano ‘in evidenza’ ai post”

Revisioni

• Visualizzare la cronologia — “Mostra la cronologia delle revisioni di questo post”
• Ripristinare — “Ripristina il post alla sua versione precedente”

Permessi

Quando un client MCP apre la pagina di consenso OAuth, ogni permesso richiesto è selezionato per impostazione predefinita. Deseleziona qualsiasi permesso di cui il client non ha bisogno prima di approvare l’accesso. Il token risultante è limitato ai permessi che mantieni selezionati e ai permessi consentiti dal tuo ruolo EmDash, quindi concedere meno permessi non aumenta mai ciò che il client può fare.

Se provi qualcosa per cui non hai accesso, l’IA te lo farà sapere.

Suggerimenti

• Sii specifico sulle collezioni. Dì “crea un post del blog” piuttosto che “crea un post” se hai più collezioni.
• Chiedi prima lo schema. Se non sei sicuro di quali campi ha una collezione, chiedi “Quali campi ha la collezione dei post?” prima di creare o modificare contenuti.
• Rivedi prima di pubblicare. Chiedi all’IA di creare contenuti come bozza, rivedili nel pannello admin, poi chiedi all’IA di pubblicarli — o pubblicali tu stesso.
• Usa il confronto per la revisione. Prima di pubblicare, chiedi “Confronta le versioni pubblicata e bozza di questo post” per vedere esattamente cosa cambierà.
• I campi di testo ricco usano Portable Text. L’IA può scrivere contenuti per campi di testo ricco, ma la formattazione complessa si fa meglio nell’editor admin.

Per gli sviluppatori

L’endpoint del server MCP, i metodi di autenticazione, la scoperta OAuth, i parametri degli strumenti e la gestione degli errori sono documentati nel Riferimento server MCP.