Connetti il server MCP di Agentic SEO

Configurazione passo per passo del server MCP di Agentic SEO — aggiungilo come connettore personalizzato su claude.ai (senza terminale) oppure in Claude Code. URL, scopes, il passaggio del report gratuito e risoluzione dei problemi.

Il server MCP di Agentic SEO è un server MCP remoto che connetti a Claude in modo che l\'agente possa leggere i dati di Google Search Console, eseguire ricerche SERP e parole chiave, e gestire una tavola task condivisa per conto tuo. Lo puoi aggiungere in due modi: come connettore personalizzato su claude.ai senza terminale, oppure in Claude Code se vuoi che l\'agente modifichi il repository del tuo sito. Entrambi i percorsi ti accedono una volta e rimangono connessi.

Che cos\'è un server MCP per l\'SEO

MCP — il Model Context Protocol — è uno standard aperto di Anthropic per connettere agenti AI a strumenti e dati esterni. Una configurazione MCP ha tre parti: un host (l\'app a cui parli, come claude.ai o Claude Code), un MCP client al suo interno, e un MCP server che espone gli strumenti che l\'agente può chiamare. Un server MCP per l\'SEO è semplicemente un server MCP i cui strumenti sono dati e azioni SEO — ricerca di parole chiave, analisi SERP, query di Search Console, e così via — in modo che un agente AI possa fare lavoro SEO in linguaggio naturale anziché attraverso un dashboard. Per la panoramica del server MCP per l\'SEO e il quadro commerciale, inizia da lì; per i concetti dietro — perché il loop è più importante del protocollo — leggi l\'approfondimento. Questa pagina è il how-to.

Il nostro server si trova all\'indirizzo https://myagenticseo.com/api/mcp. Espone 18 strumenti su sei permission scopes, più il contesto di orchestrazione che la maggior parte dei server MCP per l\'SEO omette: MCP prompts (find_opportunities, write_article, improve_article) e risorse playbook:// che dicono all\'agente come eseguire il lavoro, non solo quali API esistono. Utilizza OAuth 2.1 con Dynamic Client Registration, quindi non c\'è id client o secret da incollare da nessuna parte.

Prima di iniziare

Hai bisogno di tre cose in atto:

  • Un account Agentic SEO. Accedi con Google — questo è lo stesso account in cui il connettore si accede.
  • Google Search Console connesso. Il server legge i tuoi dati GSC reali, quindi connetti prima una proprietà GSC.
  • Un modo per eseguire Claude. Per il Percorso A, un piano claude.ai a pagamento (Pro, Max, Team, o Enterprise) — i connettori personalizzati vengono eseguiti dal cloud di Anthropic e sono una funzione per i piani a pagamento. Per il Percorso B, Claude Code installato nel tuo repository.

Percorso A — Aggiungilo come connettore personalizzato su claude.ai

Questo è il percorso senza terminale ed è quello che la maggior parte delle persone dovrebbe usare. Il connettore viene eseguito dal cloud di Anthropic, quindi l\'agente su claude.ai può leggere i tuoi dati SEO direttamente in una chat.

  1. Su claude.ai, apri Settings → Connectors (sotto Customize → Connectors), quindi fai clic su + / Add custom connector.
  2. Riempi due campi:
    CampoValore
    NameAgentic SEO
    URLhttps://myagenticseo.com/api/mcp
    Salta le impostazioni avanzate — il nostro server supporta Dynamic Client Registration (RFC 7591), quindi non c\'è id client OAuth o secret da inserire.
  3. Fai clic su Add, quindi su Connect. Si apre una finestra — accedi con Google, esamina ciò che la connessione può vedere, e Allow.

Tutta la configurazione è così. Il connettore ora appare nell\'elenco degli strumenti della tua chat e rimane connesso.

Piani Team e Enterprise

Su un piano Team o Enterprise, un Owner aggiunge il connettore sotto Organization settings → Connectors → Add. I campi e il flusso di connessione sono identici.

Percorso B — Aggiungilo in Claude Code

Scegli questo percorso se vuoi che l\'agente modifichi il repository del tuo sito — trasforma i risultati in pull request nel codebase in cui è in esecuzione, non solo legger i dati. Nel tuo repo, esegui un comando:

claude mcp add --transport http agentic-seo https://myagenticseo.com/api/mcp

Quindi esegui /mcp, scegli agentic-seo, e seleziona Authenticate. Il tuo browser si apre — accedi con lo stesso account Google, scegli il tuo progetto, esamina gli scopes, e approva. La connessione rimane connessa da lì.

Non incollare un\'intestazione di autenticazione statica

Aggiungi il server con l\'URL nudo sopra e lascia che si autentichi tramite OAuth. Un\'intestazione statica rifiutata fa sì che Claude Code fallisca immediatamente senza tornare al flusso OAuth, quindi la connessione non si completa mai.

Il passaggio del report gratuito

La prima volta che ti autentichi, se il tuo account non ha ancora un report gratuito, incappi in un report-gate invece della schermata di consenso. Questo è intenzionale, non un blocco: generi il tuo report SEO professionale gratuito sui tuoi dati reali di Search Console prima che il connettore finisca. Il report è dove inizia ogni engagement — ed è lo stesso dato da cui l\'agente connesso funziona in seguito.

Quindi "aggiungere il server MCP" naturalmente produce un report gratuito. Una volta che il report esiste, la schermata di consenso appare, approvi, e la connessione si completa. Puoi anche generare il report prima e poi aggiungere il connettore — entrambi gli ordini funzionano.

Cosa può fare la connessione

Una volta connesso, chiedi in linguaggio naturale e l\'agente chiama lo strumento giusto. I 18 strumenti si raggruppano per scope:

AreaStrumentiScope
Progetto e tavolaget_project · list_tasks · get_taskproject:read · tasks:read
Aggiorna la tavolacreate_task · update_tasktasks:write
Search Consolegsc_query (live) · gsc_summary (cached)gsc:read
Il tuo sitolist_pages · get_page · get_sitemapsite:read
Ricerca di mercatokeyword_research · keyword_ideas · keyword_difficulty · serp_analysis · ranked_keywords · competitor_research · backlink_summary · backlink_referring_domainsserp:read (client only)

Oltre agli strumenti, il server fornisce prompts — flussi di lavoro guidati che puoi invocare direttamente, ognuno portando la metodologia, non solo l\'API. Si mappano a tre risultati: trovare opportunità vincibili (find_opportunities — scoperta a livello di mercato, raggruppata per sovrapposizione SERP e valutata per vincibilità), scrivere e riscrivere articoli che si posizionano (write_article e improve_article, entrambi eseguiti contro uno strappo SERP e le valutazioni dell\'articolo prima che una bozza arrivi), e — una volta che una correzione viene spedita — provare il risultato in Search Console attraverso il loop verificato. Le risorse playbook:// dietro questi prompts sono ciò che separa questo da un tubo di dati di sola lettura: la tavola task è il sistema di registrazione, e l\'agente la popola mentre lavora.

Scopes e livelli di accesso

Gli strumenti che vedi dipendono dal tuo livello di accesso, e gli scopes si risolvono live dal tuo tier corrente al momento della richiesta — nessuna re-consenso necessaria quando l\'accesso cambia:

LivelloCosa ottieniAccesso MCP
ProspectAccesso, un report gratuito, accesso leggeroSola lettura — dati del progetto, task, GSC e sito (niente serp:read, niente task writes)
ClientOnboarded dopo una chiamata, agente continuo completoTutto, inclusi gli strumenti di ricerca di mercato serp:read e task write-back

Gli strumenti serp:read sono solo per client perché attivano chiamate di dati esterni a pagamento. Diventare un client è un passaggio chiuso da umani — prenota una chiamata e il fondatore la definisce con te. Il modello di sicurezza è stretto di design: un progetto per connessione, OAuth 2.1 con PKCE, token memorizzati solo come hash SHA-256, e le tue credenziali Google non lasciano mai i nostri server — l\'agente legge GSC attraverso la piattaforma.

Risoluzione dei problemi

SintomoCausa e soluzione
Vedo solo una manciata di strumentiLa visibilità dello strumento riflette i tuoi scopes. Come prospect ottieni il set di sola lettura; gli strumenti di ricerca di mercato serp:read si illuminano al livello client. Niente è rotto.
Gli strumenti non sono cambiati dopo il cambio del mio accessoGli scopes si risolvono live, ma l'host mette in cache l'elenco degli strumenti. Disconnetti e riconnetti il connettore (o re-esegui /mcp Authenticate) per aggiornarlo.
Mi ha chiesto di creare un report invece di connettersiQuello è il report-gate. Genera il tuo report SEO gratuito, quindi torna al flusso di connessione — la schermata di consenso appare una volta che un report esiste.
Claude Code fallisce immediatamente all'aggiuntaProbabilmente hai passato un'intestazione di autenticazione statica. Rimuovila e aggiungi l'URL nudo in modo che OAuth possa funzionare.
claude.ai non mi consente di aggiungere il connettoreI connettori personalizzati richiedono un piano claude.ai a pagamento (Pro, Max, Team, o Enterprise). Su Team/Enterprise, un Owner lo aggiunge sotto Organization settings.
Il connettore è di sola lettura fino a quando non diventi un client

Qualsiasi prospect con un report gratuito può connettersi oggi ed esplorare i tuoi dati, task e contesto del sito. Il loop chiuso completo — write-back, ricerca di mercato, esecuzioni programmate, e risultati verificati da GSC — viene configurato durante l\'onboarding del client. Vedi Integrazione MCP per come quel loop funziona da capo a fondo.

Provi questi prompt

„Mostrami le mie parole chiave in striking distance da Search Console e ordinale per click a rischio“
„Trova opportunità di mercato per la mia nicchia e raggruppale per sovrapposizione SERP“
„Quali dei miei task aperti sono sbloccati e quale è la correzione suggerita per ognuno?“
„Estrai le prime 10 pagine in ranking per la mia parola chiave principale e dimmi dove posso vincere“

© 2026 Agentic SEO. Tutti i diritti riservati.