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/mcpClaude (claude.ai e Claude Desktop)
- Apri Customize → Connectors e fai clic su Add custom connector. Claude Desktop ha la stessa pagina.
- Incolla l'URL qui sopra e fai clic su Add.
- 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».
- 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
- Su chatgpt.com, apri Plugins, fai clic su + e scegli Add custom MCP server.
- Chiamalo Rankfender, incolla l'URL qui sopra come Server URL e scegli OAuth.
- 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».
- 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/mcpCursor 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.
| Nome | Cosa fornisce |
|---|---|
list_projects | I progetti che questa connessione può leggere; ricerca per nome o dominio. |
get_portfolio | Una riga per progetto: andamento organico, andamento della visibilità IA, avvisi aperti e la prossima azione della Strategia, ognuno con la sua data. |
get_project_overview | Il progetto in sintesi: parole chiave, articoli, concorrenti, backlink, visibilità IA e prossime azioni suggerite. |
get_organic_overview | Posizioni su Google e traffico organico stimato dai dati di ricerca propri di Rankfender, come in Home. |
get_performance_data | Dati di Search Console e Analytics, quando il progetto li ha collegati. |
search_keywords | Tutte le parole chiave monitorate, o quelle che contengono una parola, con volume, difficoltà, posizione e URL posizionato. |
list_articles | Ogni articolo con stato, date, URL online, punteggio di qualità e numero di parole. |
get_article | Un articolo completo: testo, meta, parole chiave, scaletta, FAQ, link, controllo qualità e stato di pubblicazione. |
list_scheduled_articles | Il calendario dei contenuti tra due date. |
get_ai_visibility_summary | Punteggio di visibilità e andamento, tasso di menzione per motore IA, argomenti, quota di voce e stato dell'ultimo controllo. |
get_ai_visibility_detail | Le risposte IA in dettaglio, con le fonti che citano e i concorrenti che nominano. |
list_tracked_prompts | Le domande che Rankfender pone ai motori IA per il progetto. |
list_competitors | I concorrenti monitorati con autorità e parole chiave in comune. |
get_competitor_intel | Dati misurati sui concorrenti: panorama, divario di parole chiave, pagine migliori, divario di backlink, profilo del sito. |
get_backlink_profile | Backlink, domini di riferimento, rank del dominio, punteggio di spam e variazione dall'ultima rilevazione. |
get_site_audit | L'ultimo audit tecnico: punteggio e problemi principali, con come risolverli. |
check_page | Recupera ora una pagina del sito: stato, titolo, meta, intestazioni, schema, immagini senza testo alternativo. |
get_opportunities | Opportunità di contenuto con priorità, guadagno atteso e motivo. |
get_weekly_insights | Il riepilogo della settimana: successi, aree da migliorare e azioni principali. |
get_alerts | Avvisi recenti, ognuno con un'azione suggerita. |
get_current_strategy | La pagina Strategia: titolo, obiettivo guida e azioni. |
list_tasks | Le attività della bacheca Pianificazione e quelle in attesa di revisione. |
get_task | Un'attività completa: cosa, perché, passaggi, risultato atteso e articolo collegato. |
get_credits | I crediti dell'account: disponibili, usati questo mese e data di rinnovo. |
get_search_console | Search Console per query, pagina o giorno: clic, impressioni, CTR, posizione ponderata per impressioni, rispetto al periodo precedente; a pagine. |
get_search_engines | Google (Search Console) contro Bing (Bing Webmaster Tools): totali, per query o pagina, dove uno si posiziona meglio; visite da altri motori. |
get_keyword_clusters | Raggruppa le parole chiave che sono varianti della stessa ricerca, con la pagina che punta a ogni gruppo e gli articoli in concorrenza. |
get_refresh_plan | Per 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_suggestions | Link da aggiungere tra gli articoli pubblicati del progetto, con il testo di ancoraggio trovato in ciascuno. |
get_ai_citations | I siti e le pagine che i motori IA citano di più, e quali non ti linkano ancora (una lista di outreach). |
suggest_competitors | I brand nominati nelle risposte IA che il progetto non monitora, quanto spesso e in quali motori. |
get_cross_signals | Pagine 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.
| Nome | Cosa fa | Crediti |
|---|---|---|
add_keywords | Aggiunge parole chiave al monitoraggio (ripristina quelle rimosse); vale il limite di parole chiave del piano. | Meno di 1 |
remove_keywords | Smette di monitorare parole chiave; vengono nascoste, non eliminate. | Nessuno |
schedule_article | Aggiunge un'idea di articolo al calendario (al massimo 2 al giorno, un articolo per parola chiave). | Meno di 1 |
reschedule_article | Sposta un articolo a un'altra data. | Nessuno |
unschedule_article | Toglie un articolo dal calendario; uno già scritto torna tra le bozze con il suo testo. | Nessuno |
update_article_details | Cambia titolo, parola chiave target, meta, slug (non dopo la pubblicazione) o angolazione. | Nessuno |
edit_article | Sostituisce il testo, intero o una sezione; il testo precedente viene conservato e il controllo qualità riparte. | Nessuno |
create_article_from_opportunity | Trasforma un'opportunità di contenuto in un'idea di articolo. | Meno di 1 |
generate_article | Fa scrivere un articolo al motore dei contenuti (3–5 minuti). | Circa 30 |
regenerate_article | Riscrive un articolo, eventualmente con istruzioni; il testo precedente viene conservato. | Circa 30 |
publish_article | Pubblica un articolo sul tuo sito web o aggiorna un articolo online, dopo il controllo di pubblicazione (richiede la spunta di pubblicazione). | Circa 1 |
create_task | Aggiunge un'attività alla bacheca Pianificazione, segnata come proveniente da un'app di IA. | Nessuno |
update_task_status | Segna un'attività come completata, in corso, pianificata, approvata, in backlog o scartata. | Nessuno |
add_competitor | Inizia a monitorare un concorrente. | Nessuno |
remove_competitor | Smette di monitorare un concorrente; i suoi dati vengono conservati. | Nessuno |
replace_competitor | Sostituisce un concorrente monitorato con un altro. | Nessuno |
measure_competitor | Misura 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_prompts | Aggiunge domande degli acquirenti al monitoraggio della visibilità IA. | Nessuno |
update_tracked_prompt | Riformula, sposta o mette in pausa una domanda monitorata. | Nessuno |
run_ai_visibility_check | Ripone le domande monitorate ai motori IA (5–15 minuti). | Circa 25 |
run_site_audit | Scansiona e analizza il sito ora (50–300 pagine secondo il piano). | Nessuno |
generate_report | Crea il report del progetto e restituisce un link di condivisione valido 90 giorni. | Nessuno |
score_keywords | Valuta da 0 a 3 la pertinenza delle parole chiave per il tuo brand, con l'intento e un breve motivo. | Meno di 1 |
label_keywords | Aggiunge o toglie le tue etichette sulle parole chiave, per raggrupparle e filtrarle. | Nessuno |
merge_tasks | Unisce attività duplicate in una; le altre vengono chiuse con un link ad essa, non si elimina nulla. | Nessuno |
update_project_settings | Modifica lingua, paese, settore, tipo di attività o descrizione del brand del progetto (solo proprietari e amministratori del progetto). | Nessuno |
generate_technical_fix | Scrive una correzione pronta da incollare per una pagina (titolo, meta description, FAQ, definizione, schema); non modifica nulla. | Meno di 1 |
run_on_projects | Esegue 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.
| Nome | Cosa fornisce |
|---|---|
weekly_report | Report settimanale su SEO e visibilità IA con le prossime tre azioni. |
quick_wins | Parole chiave vicine alla prima pagina, argomenti IA deboli e pagine facili da sistemare, prima le più economiche. |
audit_content_plan | Parole chiave fuori intento, quasi duplicati, punteggi di qualità bassi e argomenti mancanti nel piano dei contenuti. |
seo_director | Esamina 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
| Limite | Valore |
|---|---|
| Chiamate agli strumenti | 60 al minuto e 2.000 al giorno, per utente e progetto |
| Modifiche | 10 al minuto e 100 al giorno, per utente e progetto |
| Articoli scritti o riscritti dalle app di IA | 7 per progetto in 24 ore |
| Articoli per giorno di calendario | 2 |
| Misurazioni dei concorrenti | Una per vista al giorno |
| Controlli di visibilità IA | Uno 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 vedi | Perché | 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 ripresentarsi | La 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 sbagliato | La 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 project | Le modifiche richiedono i diritti di editore. | Chiedi al proprietario l'accesso da editore. |
| Rate limit / Daily limit reached | Troppe chiamate o modifiche. | Attendi e riprova. |
| 7 articles were already written or rewritten | Limite giornaliero di articoli dalle app di IA. | Riprova domani o usa la pagina Contenuto. |
| Not enough credits | Il 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.