GUIDA ALLA CONNESSIONE MCP

Consulta e richiama i report dei siti che ti interessano, dalla tua AI.

Valuta partner per backlink, siti per guest post e concorrenti dal client AI. Consulta Ahrefs DR, backlink, traffico di ricerca e risposte IA, poi richiama i report acquistati per confrontarli. Non devi possedere i siti né acquistare un account Ahrefs.

Parti dalla decisione che devi prendere

Scegli partner per backlink

Confronta DR, domini referenti, link Dofollow e traffico prima di contattare un sito. Chiedi alla AI di evidenziare le differenze, oltre al singolo punteggio.

Valuta guest post

Considera insieme backlink, primi tre paesi del traffico organico e risposte AI per valutare la coerenza con il pubblico desiderato.

Comprendi i concorrenti

Confronta più siti e rileggi gratis le istantanee acquistate. Chiedi alla AI di indicare le date della verifica e dei dati prima di trarre conclusioni.

Collegati in tre passaggi

  1. Genera un token

    Accedi con un account verificato e apri Il mio account / Collega un client AI (MCP). Per nuove verifiche attiva “Consenti verifiche che usano crediti”, genera o sostituisci il token e aggiorna il client. Per la sola cronologia acquistata mantieni accesso in lettura.

  2. Aggiungi il server

    Scegli MCP remoto con Streamable HTTP e inserisci la URL indicata. In Authorization usa Bearer, uno spazio e il token. Nel campo Bearer Token dedicato inserisci solo il token.

  3. Leggi prima un report salvato

    Chiedi le verifiche recenti e apri un risultato acquistato: è gratuito. Prima di una nuova verifica conferma domini, inclusione AI e costo totale.

Impostazioni di connessione

URL del server
https://ahrefsdr.com/mcp
Trasporto
Streamable HTTP
Autenticazione
Authorization: Bearer <token>

Serve un client con Streamable HTTP remoto e header Authorization o Bearer Token personalizzati. I client solo OAuth o stdio locale richiedono un adattatore compatibile. Usa il token di questo account; non serve una chiave API Ahrefs.

Come si usano i crediti

AzioneCrediti
Elenco storico o apertura di risultati acquistati0
Nuova verifica: 1 sito, report base1
Nuova verifica: 1 sito, base + AI2
Nuove verifiche: 2 siti, report base2
Nuove verifiche: 2 siti, base + AI4
  • Per N siti unici: base = N; con AI = 2 × N. MCP verifica un dominio per chiamata. Rimuovi i duplicati e conferma il totale prima di più chiamate.
  • Se fallisce la base, il credito base viene restituito. Se fallisce solo AI, viene restituito il credito aggiuntivo e rimane la base. Le richieste in corso possono prenotare crediti fino al completamento o recupero.
  • Una nuova verifica o un aggiornamento usa crediti. Leggere il report acquistato è gratuito e conserva il risultato ottenuto.
  • Il limite MCP giornaliero conta crediti, non siti. Si azzera alle 00:00 UTC: predefinito 20, da 1 a 2.000 alla generazione del token. Limita solo le nuove verifiche MCP, non aggiunge saldo e non limita il sito web. Ogni ordine offre crediti validi un anno dalla data di acquisto.

Limite giornaliero, saldo e storico gratuito

Il limite conta crediti, non chiamate

Impostalo alla generazione del token in Il mio account: 20 predefiniti, da 1 a 2.000. Con saldo sufficiente, 20 permettono 20 verifiche base o 10 con AI. Lo storico non consuma il limite. Si azzera alle 00:00 UTC; per modificarlo genera un nuovo token.

Quando raggiungi il limite

Le nuove verifiche sono rifiutate prima di iniziare. Attendi il reset UTC o modifica il limite e rigenera il token. Con 1 credito residuo puoi richiedere la base, non AI che ne richiede 2. Aumentare il limite non aggiunge saldo.

Posso leggere lo storico senza saldo?

Sì. Con un token valido puoi leggere gratuitamente i risultati acquistati, anche dopo il limite giornaliero. Per nuove verifiche devi aggiungere crediti. Un token scaduto o revocato va sostituito anche per leggere lo storico.

Storico e nuova verifica sono diversi

Lo storico restituisce il report acquistato con le date originali, senza addebiti o aggiornamenti automatici. Puoi leggere lo storico e Il mio progetto gratuitamente anche dopo il limite giornaliero. Una nuova verifica usa 1 credito, o 2 con AI. Chiedi alla AI di distinguere lettura e nuova verifica a pagamento.

Esempio: Claude Code

In una configurazione MCP locale privata, sostituisci YOUR_MCP_TOKEN con il token generato nel tuo account. Non inserirlo in repository o conversazioni AI. Il formato seguente è per Claude Code; altri client possono usarne uno diverso.

{
  "mcpServers": {
    "ahrefsdr": {
      "type": "http",
      "url": "https://ahrefsdr.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Riconnetti e verifica gli strumenti. Sola lettura: list_queries, get_query e get_my_project. Con permesso a pagamento è disponibile anche check_domain.

Claude Code · MCP

Cosa può fare la tua AI

StrumentoFunzione
list_queriesElenca fino a 50 verifiche recenti con ID e date, gratis.
get_queryLegge una propria istantanea con query_id, gratis.
get_my_projectLegge gratis Il mio progetto e il report acquistato come riferimento, senza aggiornare dati. Se manca, chiede una URL di riferimento.
check_domainVerifica un sito. Richiede permesso di pagamento, saldo e limite disponibili, request_id UUID e confirm_credits = 1 per la base oppure 2 con include_ai: true.

Esempi di domande dopo aver collegato MCP

09

Valuta un singolo sito o confronta uno o più obiettivi con Il mio progetto per decidere su partnership, concorrenza o promozione.

L’AI legge gratis Il mio progetto con get_my_project e usa il report acquistato come riferimento, senza richiedere la URL. Se manca un progetto fissato chiede la URL. Puoi scegliere un altro riferimento o valutare un sito senza possederne uno.

  1. Per tutti

    Comprendi un singolo sito

    Valuta [dominio obiettivo] con DR, UR, backlink, domini referenti, ricerca organica e risposte IA. Riassumi punti forti, rischi, motivi per approfondire e prove mancanti.

  2. Con un sito

    Valuta un partner per backlink

    Prima chiama get_my_project e usa gratis il report acquistato come riferimento; chiedi la mia URL solo se il progetto non è disponibile. [Dominio obiettivo] è adatto a collaborare con il mio sito? Conferma lo scopo, poi valuta backlink, fonti Dofollow e traffico con pro e contro fondati.

  3. Per tutti

    Valuta un candidato di affiliazione

    Valuta traffico organico, primi 3 paesi, backlink e risposte IA di [dominio obiettivo]. Separa prove del report da pubblico, commissioni e conversioni da verificare.

  4. Per tutti

    Valuta un’opportunità di guest post

    Vorrei contribuire con un guest post a [dominio obiettivo] per [paese o pubblico]. Valuta backlink, traffico organico e paesi; elenca vantaggi, rischi e requisiti editoriali e sui link da verificare prima del contatto.

  5. Con un sito

    Il mio progetto e un sito

    Prima chiama get_my_project e usa gratis il report acquistato come riferimento; chiedi la mia URL solo se il progetto non è disponibile. Confrontala con [dominio obiettivo] per [scopo], indicando vantaggi, differenze, complementarità e date.

  6. Con un sito

    Il mio progetto e più siti

    Prima chiama get_my_project e usa gratis il report acquistato come riferimento; chiedi la mia URL solo se il progetto non è disponibile. Confrontala con [lista] per backlink, affiliazioni, guest post o concorrenza. Motiva priorità, pro, contro e prove mancanti.

  7. Per tutti

    Traffico e annunci dei concorrenti

    Analizza [uno o più concorrenti]: traffico organico stimato, keyword, primi 3 paesi, keyword a pagamento e traffico e costi stimati. Non chiamarli spesa reale o profitti.

  8. Esplorando opportunità

    Studia un caso prima di creare un sito

    Non ho un sito. Analizza [obiettivo o lista] nel [settore] e valuta barriere, ipotesi di contenuti e visibilità AI e domande da verificare. Non equiparare traffico a ricavi.

  9. Per tutti

    Rileggi gratis i report acquistati

    Elenca le verifiche e apri il report salvato che scelgo. Indica date della verifica e dei dati e riassumi. Leggi solo la cronologia, senza nuove verifiche o crediti.

Per nuove valutazioni consigliamo di attivare “Consenti verifiche che usano crediti” in Il mio account, generare o sostituire il token MCP e aggiornare il client. Senza permesso puoi solo leggere gratis report storici acquistati, non avviare nuove verifiche. Servono anche saldo e limite giornaliero sufficienti.

Leggi prima i report acquistati. Prima di nuove verifiche, conferma con me domini, risposte IA e crediti totali. Indica date della verifica e dei dati e campi mancanti; non inventare conclusioni.

Tre modalità MCP nell’account: disattivato vieta nuove ricerche AI; Auto sceglie per richiesta e, se omesso, esclude AI; attivo include AI per default, salvo richiesta esplicita della base. include_ai: false costa 1 credito; include_ai: true ne costa 2 se consentito. Conferma scelta e totale. L’interruttore web è separato; progetti e storico acquistati restano gratuiti da leggere e invariati.

Storico e nuove verifiche

access.kind distingue historical_read, new_query ed existing_request. queriedAt è la data di acquisto/verifica; dataAsOf indica le date DR, base e AI; retrievedAt è la lettura. Le date sono ISO 8601 UTC. Quelle non salvate restano sconosciute. Chiedi alla AI di indicare date e addebiti, rimborsi e crediti netti di access.billing.

Tentativi e sicurezza del token

Riprova la stessa operazione con request_id e parametri identici per evitare un altro acquisto. Un ID nuovo è una nuova verifica. Il token appare una volta e scade dopo 90 giorni. Rigenerarlo invalida il precedente; revocalo nel tuo account quando non serve più.

Problemi di connessione

401 / autenticazione non riuscita

Controlla scadenza e sostituzione del token e usa Authorization: Bearer <token>.

Sola lettura o limite giornaliero

Abilita le verifiche a pagamento o modifica il limite e genera un nuovo token. Controlla anche il saldo.

/mcp mostra 405 nel browser

È un endpoint POST MCP, non una pagina. Streamable HTTP è il trasporto, non una parte della URL.

403 / client incompatibile

Alcuni client web inviano un Origin diverso o non gestiscono header personalizzati. Usa un client HTTP remoto compatibile. Non offriamo accesso OAuth.