Connettore AI (MCP): collegare Claude e ChatGPT

Collega Claude, ChatGPT, Gemini, Claude Code o Cursor ai tuoi dati SEO di Miraqo — autorizzazione con un clic tramite l'indirizzo del connettore per claude.ai/ChatGPT/Gemini, oppure token personale per Claude Code e Cursor, con gestione delle app collegate e dei token dalle Impostazioni Account.

Il Connettore AI collega il tuo assistente AI ai dati SEO di Miraqo — keyword e posizioni, audit tecnico, backlink, Presenza AI, competitor, architettura topica — così puoi interrogarli in linguaggio naturale, direttamente dalla chat dell’AI che usi ogni giorno.

Tutto si gestisce da Impostazioni Account → Connettore AI (MCP) (la stessa card si apre anche dalla voce Connettore AI in cima alla sidebar). L’indirizzo del connettore, uguale per tutti, è:

https://app.miraqo.io/mcp

La card Connettore AI (MCP) nelle Impostazioni Account, evidenziata: la spiegazione con l’indirizzo del connettore, il link alla REST API documentata, lo stato Nessun token attivo, il campo per il nome del token e il pulsante Genera token

Collegare claude.ai, ChatGPT o Gemini (un clic)

Su queste app basta aggiungere un connettore personalizzato e incollare l’indirizzo https://app.miraqo.io/mcp. Parte in automatico l’autorizzazione sicura: accedi con il tuo account Miraqo, confermi, e il collegamento è attivo.

Non devi generare né incollare alcun token. Il permesso resta legato all’app e puoi revocarlo in qualsiasi momento dalla sezione App collegate nella stessa card.

La sezione App collegate della card Connettore AI, evidenziata: la riga dell’app Claude con la data del collegamento e il pulsante Revoca; sotto, l’elenco dei token personali

Il punto esatto in cui aggiungere un connettore cambia leggermente da un’app all’altra (e può dipendere dal tipo di piano dell’app AI), ma l’indirizzo da inserire è sempre lo stesso.

Collegare Claude Code o Cursor (con token)

Questi strumenti da sviluppatore usano un token personale. Nella card Connettore AI:

  1. Dai un nome al token (es. claude-code) e premi Genera token.
  2. Il token è mostrato una sola volta: copialo subito.
  3. La stessa schermata mostra il comando/snippet pronto da incollare:

Claude Code

claude mcp add --transport http miraqo https://app.miraqo.io/mcp --header "Authorization: Bearer IL_TUO_TOKEN"

Cursor — incolla lo snippet mcp.json mostrato (indirizzo + token nell’header).

Nello stesso riquadro trovi anche un indirizzo con il token già incluso, da usare su claude.ai come connettore personalizzato se preferisci il token all’autorizzazione con un clic.

Il riquadro mostrato subito dopo Genera token, evidenziato: l’avviso “Copia il token ora”, il token, il comando pronto per Claude Code, l’indirizzo con token per claude.ai e lo snippet mcp.json per Cursor

Puoi tenere fino a 5 token attivi e revocarli singolarmente. Revocando un token, i client collegati con quel token smettono di funzionare.

L’elenco dei token attivi sotto il riquadro: la riga del token claude-code con data di creazione, ultimo utilizzo e il pulsante Revoca, evidenziata

Cosa puoi fare

Una volta collegato, chiedi all’AI di leggere i tuoi dati o di avviare operazioni. Per esempi pratici di richieste vedi la guida Chatta con i tuoi dati SEO.

  • Letture (posizioni, audit, backlink, Presenza AI, competitor…): non consumano la quota del piano.
  • Azioni a pagamento (avviare un audit, una ricerca keyword, un’analisi dominio…): consumano la quota mensile del piano e hanno un tetto mensile dedicato di azioni via connettore.

REST API

Gli stessi strumenti sono disponibili anche come REST API documentata (trovi il link «REST API documentata» nella card Connettore AI), comoda per integrazioni personalizzate.

Problemi comuni

  • L’autorizzazione non parte: controlla di aver incollato l’indirizzo esatto https://app.miraqo.io/mcp e di aver effettuato l’accesso a Miraqo nel browser.
  • Token non più valido: se lo hai revocato o ne hai generato uno nuovo, aggiorna la configurazione del client con il token aggiornato.
  • Hai perso il token: per sicurezza non è recuperabile. Genera un nuovo token, aggiorna il client e revoca quello vecchio.

Ultimo aggiornamento: 5 settembre 2026