Usa AISA da Claude (e da ChatGPT)

Dalla versione 2.0 AISA mette i suoi strumenti SEO a disposizione degli assistenti AI. Apri Claude, scrivi "fai l'audit SEO della pagina Contatti e applica i fix", e AISA lavora sul tuo sito. Resti tu in controllo: ogni azione passa dai permessi del tuo utente WordPress, e quello che viene scritto lascia sempre una revisione o un backup.

Cos'è MCP, senza tecnicismi

MCP è il modo standard con cui un assistente AI si collega a un servizio esterno. Come una presa elettrica: da una parte l'assistente, dall'altra il tuo sito. Claude, ChatGPT e gli altri sanno usare questa presa; AISA la espone.

Sotto c'è la Abilities API di WordPress, arrivata con la versione 6.9: un registro in cui ogni plugin dichiara cosa sa fare. AISA vi registra 13 abilities. Qualunque connettore MCP che legge quel registro le vede.

Cosa serve

WordPress 6.9 o successivo (l'Abilities API è nel core da lì).
AISA 2.0 attivo, con Brand Context compilato e un provider AI configurato oppure AISA Cloud.
Una Application Password di WordPress per il tuo utente.
AISA Premium, il plugin companion separato, se vuoi anche gli strumenti che scrivono. Deve essere alla stessa versione di AISA (2.0 o successiva): gli strumenti che scrivono vivono lì dentro.

Le abilities sono accese di default nella 2.0. Trovi l'interruttore e lo stato del sito in AISA → Impostazioni → API Keys, sezione Abilities API & MCP.

L'Application Password di WordPress

È una password secondaria legata al tuo utente, che crei in wp-admin → Utenti → Profilo → Application Passwords, dai un nome (per esempio "Claude") e copi subito: WordPress la mostra una volta sola. La revochi dalla stessa pagina quando vuoi. Claude la usa per presentarsi al sito come te, con i tuoi stessi permessi; la tua password di login non è mai coinvolta.

Tre modi per collegarsi

1. AISA da solo

AISA ha un punto di accesso MCP integrato: https://tuosito.it/wp-json/aisa/v1/mcp. Nessun plugin in più.

In Claude Code basta una riga:

claude mcp add --transport http aisa https://tuosito.it/wp-json/aisa/v1/mcp \ --header "Authorization: Basic BASE64"

dove BASE64 è utente:password codificato (sul Mac: printf 'utente:xxxx xxxx xxxx' | base64). Per Claude Desktop la configurazione sta in claude_desktop_config.json, con il ponte mcp-remote e la stessa intestazione.

È la scelta giusta quando vuoi lavorare sulla SEO. Espone solo AISA: per "ottimizza la pagina Contatti" Claude deve prima trovare l'id della pagina, e ci riesce con l'API standard di WordPress, non sempre alla prima.

2. Un connettore che gestisce tutto WordPress

Se vuoi che l'assistente faccia anche il resto — creare bozze, caricare immagini, sistemare i menu — ti serve un connettore generico. Due leggono le abilities e quindi mostrano anche AISA:

MCP Adapter, il plugin ufficiale di WordPress. Un solo indirizzo con le abilities del core, di AISA e degli altri plugin. Con l'Adapter installato, AISA espone anche https://tuosito.it/wp-json/aisa/mcp con i soli strumenti aisa_*.
Easy MCP AI, gratuito. Scopre le abilities, aggiunge gli strumenti WordPress e l'OAuth che serve a ChatGPT e all'app claude.ai nel browser. Le abilities di AISA vanno spuntate nella sua pagina Abilities, e il consenso va dato dopo la spunta.

Altri connettori oggi espongono solo i propri strumenti: lì AISA non compare. Non tenere due connettori con OAuth sullo stesso sito: si contendono gli stessi indirizzi e uno dei due smette di autorizzare.

3. Sito in staging o in locale

Con un Claude installato sul tuo computer non serve nulla di tutto questo: si collega al sito locale, http://tuosito.local/wp-json/aisa/v1/mcp, con la stessa Application Password. Usa http, non https. Claude Code ha inoltre il terminale e WP-CLI, quindi sul sito locale può fare anche il resto senza connettori. Solo l'app claude.ai nel browser e ChatGPT non raggiungono un sito locale: per quelli serve il sito pubblico.

I 13 strumenti

Cinque leggono e sono nel plugin gratuito; otto scrivono e richiedono AISA Premium, il plugin companion separato.

I nomi sotto sono quelli che l'assistente vede; fra parentesi c'è il nome tecnico dell'ability, che serve solo se vai a guardare l'elenco degli strumenti nel tuo client.

Strumento	Tipo	Cosa fa
Get SEO status (`aisa/get-seo-status`)	lettura	title, meta description, frase chiave e slug di un contenuto, plugin SEO attivo, lingua rilevata, quando AISA ha generato e dove ha scritto
Audit a page (`aisa/audit-page`)	lettura	i controlli on-page con l'esito di ognuno; a richiesta anche sulla pagina pubblica servita ai visitatori
Get llms.txt (`aisa/get-llms`)	lettura	il documento che descrive il sito ai motori di risposta AI, la sua URL, chi possiede il file e quanti contenuti hanno già un AI Search Context
Get the Brand Context (`aisa/get-brand`)	lettura	chi sei, per chi lavori, tono di voce, punti di forza, termini da non tradurre
Diagnostics (`aisa/diagnostics`)	lettura	com'è configurato AISA: versioni, plugin SEO e modalità, provider per nome, Cloud e crediti. Mai le chiavi
Optimize a page (`aisa/optimize-page`)	scrittura	genera frase chiave, title, meta description, AI Search Context e, su richiesta, lo slug
Auto-fix a page (`aisa/autofix-page`)	scrittura	sistema i controlli falliti dell'audit; slug, H1 e contenuto solo se li chiedi
Optimize many pages (`aisa/optimize-bulk`)	scrittura	un lotto di contenuti come job, con l'identificativo restituito subito
Get a background job (`aisa/get-job`)	lettura	avanzamento ed esito per ogni contenuto; si può fermare quello ancora in coda
Set the Brand Context (`aisa/set-brand`)	scrittura	aggiorna i campi che nomini, gli altri restano intatti
Describe images (`aisa/media-alt`)	scrittura	alt text e titolo con AI Vision: solo dove manca, solo l'alt, oppure da zero
Check and repair internal links (`aisa/links-fix`)	lettura o scrittura	report dei link interni rotti (sola lettura) e, se lo chiedi, riparazione con redirect 301
Scan AI visibility (`aisa/geo-scan`)	scrittura	se il sito viene citato dalle risposte AI e chi viene citato al suo posto: prima la stima del costo, poi lo scan

Nove frasi da provare

"Fammi la diagnostica di AISA sul sito."
"Dammi lo stato SEO della pagina 42: titolo, meta description, frase chiave e slug."
"Fai l'audit della pagina 42, applica i fix, poi rifai l'audit e dimmi cosa è cambiato."
"Ottimizza in background le venti pagine pubblicate senza meta description e avvisami quando ha finito."
"Scrivi l'alt delle immagini dell'articolo 18 che ancora non ce l'hanno."
"Controlla i link interni della pagina 42 e ripara quelli sicuri con i redirect."
"Aggiungi ai termini da non tradurre: AISA, One-Click SEO, AISA Cloud."
"Quanto costerebbe una scansione di visibilità AI su 'plugin SEO WordPress'? Solo la stima."
"La pagina 42 è arrivata davvero in pagina? Verifica sulla pagina pubblica."

Le azioni che cambiano ciò che i visitatori vedono — slug, H1, contenuto — sono spente di default: vanno chieste esplicitamente.

Cosa aspettarsi

Situazione	Risposta
Azione di scrittura senza AISA Premium	rifiuto chiaro: gli strumenti che scrivono non sono nel plugin gratuito
Pagina che il tuo utente non può modificare	rifiuto: valgono i permessi dell'utente della Application Password
Fix del contenuto senza frase chiave	ti chiede prima di impostarla o generarla
Scansione di visibilità AI	prima la stima del costo, lo scan solo con la tua conferma
"Dov'è la mia chiave OpenAI?"	mai restituita: la diagnostica dice solo se il provider è configurato
Job in background in corso	puoi chiedere l'avanzamento o fermarlo; ciò che è scritto resta
Dubbio sul risultato	chiedi la verifica sulla pagina pubblica: AISA legge la pagina servita e confronta title, description e immagine social con quelli salvati
Troppe richieste di fila	limite per utente al minuto: 60 letture, 10 scritture, 2 avvii di job, 2 scansioni di visibilità AI

Sicurezza

Ogni chiamata passa da autenticazione e capability di WordPress, come se fossi tu in wp-admin.
Le chiavi API, le licenze e i token non sono raggiungibili da nessuno strumento: la diagnostica dice solo se un provider è configurato.
Le scritture SEO passano dall'adapter del plugin SEO attivo, quindi non nascono campi doppi.
Il Brand Context si scrive solo nei campi in elenco: un assistente non può inventarsi un campo e vederselo salvato.
Le abilities si spengono con un click in Impostazioni → API Keys, oppure da wp-config.php con define( 'AISA_ABILITIES', false );.
Il plugin gratuito espone solo strumenti di lettura.

Domande frequenti

Ho aggiornato AISA alla 2.0 ma l'assistente vede solo gli strumenti che leggono. Perché? Perché AISA Premium è rimasto a una versione precedente. I due plugin si aggiornano per strade diverse: AISA arriva da WordPress.org, AISA Premium dal nostro canale. Con le versioni disallineate il sito funziona comunque — One-Click, Batch e il resto continuano a lavorare — ma gli otto strumenti che scrivono compaiono solo quando anche AISA Premium è alla 2.0. Vai in Plugin, aggiorna AISA Premium e, per non pensarci più, attiva lì accanto «Abilita aggiornamenti automatici»: da quel momento i due plugin restano allineati da soli.

Devo installare per forza un altro plugin? No. Per la SEO basta AISA. Un connettore generico serve solo se vuoi gestire anche il resto del sito dalla chat.

Funziona con ChatGPT? Sì, tramite un connettore che aggiunge l'OAuth richiesto da ChatGPT, come Easy MCP AI. Il punto di accesso integrato di AISA è pensato per Claude Code e Claude Desktop.

E con Yoast o Rank Math attivi? Sì. AISA lavora come copilota del plugin SEO attivo e scrive nei suoi campi, senza duplicare nulla. Stesso discorso con SEOPress e AIOSEO.

Quanto costa? Gli strumenti di lettura sono nel plugin gratuito. Gli strumenti che scrivono richiedono AISA Premium e consumano i tuoi provider AI o i crediti di AISA Cloud, esattamente come dall'interfaccia. La scansione di visibilità AI chiede sempre conferma prima di spendere.

Posso tornare indietro? Sì. Prima di toccare un contenuto AISA salva una revisione di WordPress e, con Elementor, un backup dei dati del builder. Un job fermato non annulla ciò che è già stato scritto: quello si ripristina dalle revisioni.

Come faccio a sapere se è collegato? Scrivi "Fammi la diagnostica di AISA sul sito": se risponde con versione, plugin SEO rilevato e provider configurati, il collegamento funziona.