Rank Tim Logo

Documentation

Integrazioni

Server MCP

Porta i dati Ranktim in Claude, Cursor, ChatGPT o qualsiasi client MCP e interroga direttamente prompt, citazioni, sentiment, prodotti e audit.

Cos'è il server MCP di Ranktim?

Il server MCP di Ranktim espone il tuo spazio di lavoro agli assistenti IA tramite il Model Context Protocol. Una volta collegato, l'assistente può consultare visibilità IA, citazioni e sentiment dei prompt monitorati, elencare i tuoi prodotti ed eseguire audit del sito — nella stessa conversazione che stai già facendo.

Disponibile con i piani Pro, Growth ed Enterprise. L'accesso segue il tuo account: un client non può mai vedere o fare più di quanto puoi fare tu in Ranktim.

Dettagli di connessione
URL del server
https://ranktim.com/api/mcp
Trasporto
Streamable HTTP
Autenticazione
OAuth 2.1 — accedi con il tuo account Ranktim. Per i client senza interfaccia sono accettate anche chiavi API (sola lettura).
1

Aggiungi Ranktim al tuo client

  1. In Claude (web o desktop), apri Settings → Connectors.
  2. Fai clic su «Add custom connector», chiamalo Ranktim e incolla https://ranktim.com/api/mcp.
  3. Fai clic su Connect, accedi a Ranktim e approva l'accesso.
  4. In una chat, attiva Ranktim dal menu degli strumenti e fai una domanda.
2

Accedi e autorizza

Il client apre una pagina di accesso Ranktim. Accedi con l'account proprietario del sito e approva l'accesso. Il client riceve solo un token per il tuo account, mai la tua password.

3

Chiedi in linguaggio naturale

  • “Elenca i miei prompt migliori per visibilità degli ultimi 30 giorni.”
  • “Quali domini sono più citati e che quota è editoriale rispetto a UGC?”
  • “Qual è il mio sentiment su ChatGPT rispetto a Perplexity questo mese?”
  • “Esegui un audit del sito e dimmi i problemi principali.”
  • “Elenca i miei prodotti senza immagini.”

Strumenti disponibili

  • list_prompts

    Prompt monitorati con punteggio di visibilità, tasso di menzione del brand e motori, in un periodo.

    Lettura
  • get_citations

    Domini e URL citati nelle risposte IA, con tasso di utilizzo e ripartizione proprio / concorrente / editoriale / UGC.

    Lettura
  • get_sentiment

    Menzioni positive, neutre e negative per motore e settimana, con esempi negativi.

    Lettura
  • list_products

    Il tuo catalogo prodotti con segnalazioni come immagini, descrizioni o prezzi mancanti.

    Lettura
  • run_site_audit

    Esegue l'audit AEO con 20 controlli sul tuo sito e salva il report. Consuma un audit della quota mensile.

    Azione
  • get_analytics_overview

    Traffico, coinvolgimento, eventi chiave e referral IA da GA4, più clic e posizione da Search Console, confrontati con il periodo precedente.

    Lettura
  • get_search_performance

    Query o pagine di Search Console con clic, impressioni, CTR e posizione media.

    Lettura
  • get_page_performance

    Le metriche GA4 e Search Console di una pagina affiancate, come fonti separate.

    Lettura
  • get_ai_referral_traffic

    Sessioni GA4 inviate da assistenti IA, per assistente, andamento giornaliero e pagina di destinazione.

    Lettura
  • find_search_opportunities

    Query in seconda pagina, con CTR basso o in calo, da Search Console.

    Lettura
Risoluzione dei problemi
  • L'autorizzazione non riesce: rimuovi il server Ranktim dal client, aggiungilo di nuovo e ripeti l'accesso.
  • Risultati vuoti: controlla quale sito indica la risposta. Se hai più siti, chiedi un dominio specifico (es. «per example.com»).
  • «plan_required»: il server MCP richiede un piano Pro, Growth o Enterprise attivo. «write_disabled»: attiva gli strumenti di azione in Impostazioni → Server MCP.
  • «rate_limited»: troppe chiamate in poco tempo. Attendi un momento; l'errore indica quando riprovare.

Domande frequenti

Documentation - Rank Tim | Rank Tim