Server MCP: ChatGPT, Claude e altre app di IA

Collegare Rankfender a Claude, ChatGPT, Claude Code o Cursor: configurazione, permessi, strumenti, crediti e limiti.

Il server MCP di Rankfender collega i tuoi progetti ad app di IA come Claude, ChatGPT, Claude Code e Cursor. MCP (Model Context Protocol) è lo standard aperto che queste app usano per chiamare altri software. L'assistente può leggere il tuo progetto e, se lo consenti, fare modifiche, sempre dopo avertelo chiesto.

Chi può usarlo

I progetti il cui proprietario ha il piano Professional, Business o Agencies. I membri del team usano il piano del proprietario: proprietari, amministratori ed editori possono consentire le modifiche, i lettori possono solo leggere. Vedi Piani.

Collegare un'app di IA

Usa lo stesso URL in ogni app. L'app apre una pagina di accesso di Rankfender, poi una pagina di consenso dove scegli i progetti (tutti, compresi quelli futuri, o solo quelli che spunti), se l'app può fare modifiche e se può anche pubblicare sul tuo sito web.

https://app.rankfender.com/mcp

Claude (claude.ai e Claude Desktop)

  1. Apri Customize → Connectors e fai clic su Add custom connector. Claude Desktop ha la stessa pagina.
  2. Incolla l'URL qui sopra e fai clic su Add.
  3. Accedi a Rankfender quando Claude lo chiede (Claude Desktop apre la pagina nel tuo browser), scegli i tuoi progetti e cosa può fare Claude, e fai clic su «Consenti».
  4. In una chat, attiva Rankfender dal menu degli strumenti (tools menu). Nei piani Team ed Enterprise, un proprietario lo aggiunge prima in Organization settings → Connectors (Add → Custom → Web), poi ogni membro fa clic su Connect. Il piano Free consente un solo connettore personalizzato.

ChatGPT

  1. Su chatgpt.com, apri Plugins, fai clic su + e scegli Add custom MCP server.
  2. Chiamalo Rankfender, incolla l'URL qui sopra come Server URL e scegli OAuth.
  3. Accetta l'avviso e crealo come plugin, poi accedi a Rankfender, scegli i tuoi progetti e cosa può fare ChatGPT, e fai clic su «Consenti».
  4. In una chat, digita @ e scegli Rankfender. In un workspace, può darsi che un amministratore debba consentire i server MCP personalizzati.

Claude Code

Aggiungi il server (aggiungi --scope user per usarlo in ogni progetto), poi digita /mcp in Claude Code, scegli rankfender e Authenticate. Il browser apre la pagina di accesso di Rankfender.

claude mcp add --transport http rankfender https://app.rankfender.com/mcp

Cursor e altre app MCP

Aggiungi Rankfender a ~/.cursor/mcp.json (tutti i progetti) o a .cursor/mcp.json (un solo progetto). Cursor trova da solo la pagina di accesso: accedi a Rankfender, scegli i tuoi progetti e fai clic su «Consenti». Qualsiasi altra app che supporta i server MCP remoti (streamable HTTP) con accesso OAuth funziona allo stesso modo con l'URL qui sopra.

{
  "mcpServers": {
    "rankfender": { "url": "https://app.rankfender.com/mcp" }
  }
}

Con una chiave API di progetto (sola lettura)

Per le app che non possono accedere, usa una chiave API di progetto da Impostazioni → Integrazioni (vedi La tua chiave API). Una chiave dà accesso in sola lettura al suo unico progetto, qualunque sia il ruolo dell'utente. Inviala come Authorization: Bearer o nell'header X-Rankfender-Key.

claude mcp add --transport http rankfender https://api.rankfender.com/functions/v1/mcp \
  --header "Authorization: Bearer rfk_your_key"

Cosa può fare l'app

  • Sola lettura, a meno che nella pagina di consenso non sia stato spuntato «Consenti a … di fare queste modifiche». La pubblicazione richiede una terza spunta, «Consenti a … di pubblicare sul tuo sito», non attiva per impostazione predefinita. Per cambiare l'una o l'altra, collega di nuovo l'app.
  • Le modifiche richiedono i diritti di proprietario, amministratore o editore sul progetto. I lettori e le chiavi API possono solo leggere.
  • Le azioni a pagamento e quelle con avvisi (una parola chiave fuori intento, un articolo che punta già a una parola chiave quasi identica) rispondono prima con il costo, il saldo del proprietario e gli avvisi, senza cambiare nulla. L'app deve richiamare con confirm: true dopo il tuo consenso.
  • Non si elimina nulla. Rimuovere una parola chiave, un concorrente o una domanda monitorata la nasconde e si può annullare; gli articoli si possono solo togliere dal calendario; il testo modificato conserva la versione precedente.
  • Senza la spunta di pubblicazione, il tuo sito web non cambia: un articolo modificato vi arriva solo quando qualcuno fa clic su «Aggiorna sul tuo sito» in Rankfender.
  • Ogni numero è accompagnato dalla data di misurazione e dalla fonte. In get_portfolio, i valori più vecchi di 30 giorni sono segnalati come non aggiornati.

Pubblicare sul tuo sito web

  • publish_article pubblica un articolo, o aggiorna un articolo online con il suo testo più recente (come «Aggiorna sul tuo sito» nell'app Rankfender). Servono entrambe le spunte.
  • Usa il sito collegato in Rankfender: WordPress (plugin Rankfender) o Modern Web (webhook).
  • La prima chiamata dice cosa succederà, su quale sito, e il costo (circa 1 credito, per il controllo di pubblicazione). Non viene inviato nulla finché l'app non richiama con confirm: true.
  • Prima viene eseguito il controllo di pubblicazione di Rankfender, come nell'app Rankfender. Se trattiene l'articolo, non viene pubblicato nulla: l'app riceve i motivi e un link per correggerli in Rankfender. «Pubblica comunque» resta nell'app Rankfender.
  • Non annulla mai una pubblicazione. Dopo la pubblicazione, la risposta fornisce l'URL online, o dice che la pagina non è ancora online.

Strumenti di lettura

Gli strumenti di lettura non usano crediti e non misurano mai nulla di nuovo. Se vedi più progetti, l'app passa l'id o il dominio del progetto a ogni strumento.

NomeCosa fornisce
list_projectsI progetti che questa connessione può leggere; ricerca per nome o dominio.
get_portfolioUna riga per progetto: andamento organico, andamento della visibilità IA, avvisi aperti e la prossima azione della Strategia, ognuno con la sua data.
get_project_overviewIl progetto in sintesi: parole chiave, articoli, concorrenti, backlink, visibilità IA e prossime azioni suggerite.
get_organic_overviewPosizioni su Google e traffico organico stimato dai dati di ricerca propri di Rankfender, come in Home.
get_performance_dataDati di Search Console e Analytics, quando il progetto li ha collegati.
search_keywordsTutte le parole chiave monitorate, o quelle che contengono una parola, con volume, difficoltà, posizione e URL posizionato.
list_articlesOgni articolo con stato, date, URL online, punteggio di qualità e numero di parole.
get_articleUn articolo completo: testo, meta, parole chiave, scaletta, FAQ, link, controllo qualità e stato di pubblicazione.
list_scheduled_articlesIl calendario dei contenuti tra due date.
get_ai_visibility_summaryPunteggio di visibilità e andamento, tasso di menzione per motore IA, argomenti, quota di voce e stato dell'ultimo controllo.
get_ai_visibility_detailLe risposte IA in dettaglio, con le fonti che citano e i concorrenti che nominano.
list_tracked_promptsLe domande che Rankfender pone ai motori IA per il progetto.
list_competitorsI concorrenti monitorati con autorità e parole chiave in comune.
get_competitor_intelDati misurati sui concorrenti: panorama, divario di parole chiave, pagine migliori, divario di backlink, profilo del sito.
get_backlink_profileBacklink, domini di riferimento, rank del dominio, punteggio di spam e variazione dall'ultima rilevazione.
get_site_auditL'ultimo audit tecnico: punteggio e problemi principali, con come risolverli.
check_pageRecupera ora una pagina del sito: stato, titolo, meta, intestazioni, schema, immagini senza testo alternativo.
get_opportunitiesOpportunità di contenuto con priorità, guadagno atteso e motivo.
get_weekly_insightsIl riepilogo della settimana: successi, aree da migliorare e azioni principali.
get_alertsAvvisi recenti, ognuno con un'azione suggerita.
get_current_strategyLa pagina Strategia: titolo, obiettivo guida e azioni.
list_tasksLe attività della bacheca Pianificazione e quelle in attesa di revisione.
get_taskUn'attività completa: cosa, perché, passaggi, risultato atteso e articolo collegato.
get_creditsI crediti dell'account: disponibili, usati questo mese e data di rinnovo.
get_search_consoleSearch Console per query, pagina o giorno: clic, impressioni, CTR, posizione ponderata per impressioni, rispetto al periodo precedente; a pagine.
get_search_enginesGoogle (Search Console) contro Bing (Bing Webmaster Tools): totali, per query o pagina, dove uno si posiziona meglio; visite da altri motori.
get_keyword_clustersRaggruppa le parole chiave che sono varianti della stessa ricerca, con la pagina che punta a ogni gruppo e gli articoli in concorrenza.
get_refresh_planPer una pagina pubblicata: query e posizioni ora e prima, calo, ricerche a cui il testo non risponde, note di qualità e un piano di aggiornamento.
get_internal_link_suggestionsLink da aggiungere tra gli articoli pubblicati del progetto, con il testo di ancoraggio trovato in ciascuno.
get_ai_citationsI siti e le pagine che i motori IA citano di più, e quali non ti linkano ancora (una lista di outreach).
suggest_competitorsI brand nominati nelle risposte IA che il progetto non monitora, quanto spesso e in quali motori.
get_cross_signalsPagine rotte che ricevono ancora ricerche, problemi sulle pagine con più clic, articoli da migliorare, siti citati dall'IA che non ti linkano.

Strumenti di modifica

Gli strumenti di modifica compaiono solo se è stato spuntato «Consenti a … di fare queste modifiche»; publish_article richiede anche «Consenti a … di pubblicare sul tuo sito». L'app ti chiede conferma prima di ognuno. I crediti vengono dall'account del proprietario del progetto. Le cifre qui sotto sono le stime attuali di Rankfender; ogni strumento a pagamento indica la stima esatta e il saldo prima di agire.

NomeCosa faCrediti
add_keywordsAggiunge parole chiave al monitoraggio (ripristina quelle rimosse); vale il limite di parole chiave del piano.Meno di 1
remove_keywordsSmette di monitorare parole chiave; vengono nascoste, non eliminate.Nessuno
schedule_articleAggiunge un'idea di articolo al calendario (al massimo 2 al giorno, un articolo per parola chiave).Meno di 1
reschedule_articleSposta un articolo a un'altra data.Nessuno
unschedule_articleToglie un articolo dal calendario; uno già scritto torna tra le bozze con il suo testo.Nessuno
update_article_detailsCambia titolo, parola chiave target, meta, slug (non dopo la pubblicazione) o angolazione.Nessuno
edit_articleSostituisce il testo, intero o una sezione; il testo precedente viene conservato e il controllo qualità riparte.Nessuno
create_article_from_opportunityTrasforma un'opportunità di contenuto in un'idea di articolo.Meno di 1
generate_articleFa scrivere un articolo al motore dei contenuti (3–5 minuti).Circa 30
regenerate_articleRiscrive un articolo, eventualmente con istruzioni; il testo precedente viene conservato.Circa 30
publish_articlePubblica un articolo sul tuo sito web o aggiorna un articolo online, dopo il controllo di pubblicazione (richiede la spunta di pubblicazione).Circa 1
create_taskAggiunge un'attività alla bacheca Pianificazione, segnata come proveniente da un'app di IA.Nessuno
update_task_statusSegna un'attività come completata, in corso, pianificata, approvata, in backlog o scartata.Nessuno
add_competitorInizia a monitorare un concorrente.Nessuno
remove_competitorSmette di monitorare un concorrente; i suoi dati vengono conservati.Nessuno
replace_competitorSostituisce un concorrente monitorato con un altro.Nessuno
measure_competitorMisura ora una vista di un concorrente (profilo del sito 3, pagine migliori 4, divario di parole chiave 16, divario di backlink 29, panorama 38 crediti) quando manca o ha più di un giorno.3–38
add_tracked_promptsAggiunge domande degli acquirenti al monitoraggio della visibilità IA.Nessuno
update_tracked_promptRiformula, sposta o mette in pausa una domanda monitorata.Nessuno
run_ai_visibility_checkRipone le domande monitorate ai motori IA (5–15 minuti).Circa 25
run_site_auditScansiona e analizza il sito ora (50–300 pagine secondo il piano).Nessuno
generate_reportCrea il report del progetto e restituisce un link di condivisione valido 90 giorni.Nessuno
score_keywordsValuta da 0 a 3 la pertinenza delle parole chiave per il tuo brand, con l'intento e un breve motivo.Meno di 1
label_keywordsAggiunge o toglie le tue etichette sulle parole chiave, per raggrupparle e filtrarle.Nessuno
merge_tasksUnisce attività duplicate in una; le altre vengono chiuse con un link ad essa, non si elimina nulla.Nessuno
update_project_settingsModifica lingua, paese, settore, tipo di attività o descrizione del brand del progetto (solo proprietari e amministratori del progetto).Nessuno
generate_technical_fixScrive una correzione pronta da incollare per una pagina (titolo, meta description, FAQ, definizione, schema); non modifica nulla.Meno di 1
run_on_projectsEsegue una di sette azioni su un massimo di 25 progetti; la prima chiamata mostra ogni progetto e il costo totale.Secondo l'azione

Prompt pronti all'uso

Il server offre quattro prompt che guidano l'app tra gli strumenti. Le app che supportano i prompt MCP li elencano nel loro menu dei prompt.

NomeCosa fornisce
weekly_reportReport settimanale su SEO e visibilità IA con le prossime tre azioni.
quick_winsParole chiave vicine alla prima pagina, argomenti IA deboli e pagine facili da sistemare, prima le più economiche.
audit_content_planParole chiave fuori intento, quasi duplicati, punteggi di qualità bassi e argomenti mancanti nel piano dei contenuti.
seo_directorEsamina tutti i progetti, sceglie dove agire e propone i primi articoli.

Inviare un'attività di Pianificazione a un'app di IA

Nella bacheca Pianificazione, «Invia all'IA» su un'attività apre Claude o ChatGPT con un prompt pronto, o lo copia per Claude Code o Cursor. L'app legge l'attività con get_task, svolge il lavoro con gli strumenti di Rankfender (chiedendoti conferma prima di ogni modifica), poi la segna come completata con update_task_status. Se la casella della chat si apre vuota, incolla: il prompt è già copiato. Visibile sui progetti il cui proprietario ha il piano Professional o superiore.

Limiti

LimiteValore
Chiamate agli strumenti60 al minuto e 2.000 al giorno, per utente e progetto
Modifiche10 al minuto e 100 al giorno, per utente e progetto
Articoli scritti o riscritti dalle app di IA7 per progetto in 24 ore
Articoli per giorno di calendario2
Misurazioni dei concorrentiUna per vista al giorno
Controlli di visibilità IAUno alla volta

Scollegamento, dati e assistenza

Per fermare un'app, apri Impostazioni account → Chiavi API → App IA collegate e fai clic su Scollega: perde subito l'accesso, e i tuoi progetti e dati restano come sono. Rankfender invia i dati del progetto solo all'app che hai collegato, quando chiama uno strumento; l'informativa sulla privacy descrive cosa viene conservato. Domande o problemi: support@rankfender.com o la pagina di assistenza.

Risoluzione dei problemi

Cosa vediPerchéCosa fare
“available on the Professional, Business and Enterprise plans”Il piano del proprietario del progetto è inferiore a Professional.Passa il piano del proprietario a uno superiore.
“This sign-in link has expired”, o la pagina di accesso continua a ripresentarsiLa pagina di consenso è rimasta aperta più di 10 minuti, o l'app ha avviato un nuovo accesso.Chiudila e collegati di nuovo dall'app.
“this app is not registered with Rankfender” o “the return address does not match”La registrazione dell'app è cambiata.Rimuovi il connettore nell'app e aggiungilo di nuovo.
Risposte sul progetto sbagliatoLa connessione può leggere più progetti.Indica il progetto (dominio o nome) nella domanda; list_projects mostra quelli che può leggere.
“This connection can only read”, o nessuno strumento di modifica«Fare queste modifiche» non è stato spuntato, oppure si usa una chiave API di progetto.Collega di nuovo l'app e spunta l'opzione nella pagina di consenso.
“This connection may not publish to the website”La spunta di pubblicazione non è attiva.Collega di nuovo e spunta «pubblicare sul tuo sito web», o pubblica dall'articolo in Rankfender.
You are a viewer on this projectLe modifiche richiedono i diritti di editore.Chiedi al proprietario l'accesso da editore.
Rate limit / Daily limit reachedTroppe chiamate o modifiche.Attendi e riprova.
7 articles were already written or rewrittenLimite giornaliero di articoli dalle app di IA.Riprova domani o usa la pagina Contenuto.
Not enough creditsIl saldo del proprietario è inferiore al costo.Acquista crediti o attendi il rinnovo mensile.

Nota

L'app di IA scrive le risposte e può sbagliare. Verifica i numeri importanti in Rankfender prima di agire. Rankfender invia i dati del tuo progetto solo all'app che hai collegato, quando chiama uno strumento.