MCP-server: ChatGPT, Claude en andere AI-apps
Rankfender koppelen aan Claude, ChatGPT, Claude Code of Cursor: installatie, toegangsrechten, tools, credits en limieten.
De MCP-server van Rankfender koppelt je projecten aan AI-apps zoals Claude, ChatGPT, Claude Code en Cursor. MCP (Model Context Protocol) is de open standaard die deze apps gebruiken om andere software aan te roepen. De assistent kan je project lezen en, als je dat toestaat, wijzigingen aanbrengen, altijd nadat hij het je heeft gevraagd.
Wie hem kan gebruiken
Projecten waarvan de eigenaar het abonnement Professional, Business of Agencies heeft. Teamleden gebruiken het abonnement van de eigenaar: eigenaars, beheerders en redacteuren kunnen wijzigingen toestaan, kijkers kunnen alleen lezen. Zie Abonnementen.
Een AI-app koppelen
Gebruik in elke app dezelfde URL. De app opent een aanmeldpagina van Rankfender en daarna een toestemmingspagina waar je de projecten kiest (allemaal, ook toekomstige, of alleen de projecten die je aanvinkt), of de app wijzigingen mag aanbrengen en of hij ook op je website mag publiceren.
https://app.rankfender.com/mcpClaude (claude.ai en Claude Desktop)
- Open Customize → Connectors en klik op Add custom connector. Claude Desktop heeft dezelfde pagina.
- Plak de URL hierboven en klik op Add.
- Meld je aan bij Rankfender als Claude daarom vraagt (Claude Desktop opent de pagina in je browser), kies je projecten en wat Claude mag doen, en klik op „Toestaan”.
- Zet Rankfender in een chat aan via het toolsmenu (tools menu). Bij de abonnementen Team en Enterprise voegt een eigenaar hem eerst toe in Organization settings → Connectors (Add → Custom → Web), daarna klikt elk lid op Connect. Het Free-abonnement staat één eigen connector toe.
ChatGPT
- Open op chatgpt.com Plugins, klik op + en kies Add custom MCP server.
- Noem hem Rankfender, plak de URL hierboven als Server URL en kies OAuth.
- Accepteer de waarschuwing en maak hem aan als plugin; meld je daarna aan bij Rankfender, kies je projecten en wat ChatGPT mag doen, en klik op „Toestaan”.
- Typ in een chat @ en kies Rankfender. In een werkruimte moet een beheerder eigen MCP-servers misschien eerst toestaan.
Claude Code
Voeg de server toe (voeg --scope user toe om hem in elk project te gebruiken), typ daarna /mcp in Claude Code, kies rankfender en Authenticate. Je browser opent de aanmeldpagina van Rankfender.
claude mcp add --transport http rankfender https://app.rankfender.com/mcpCursor en andere MCP-apps
Voeg Rankfender toe aan ~/.cursor/mcp.json (elk project) of .cursor/mcp.json (één project). Cursor vindt de aanmeldpagina zelf: meld je aan bij Rankfender, kies je projecten en klik op „Toestaan”. Elke andere app die externe MCP-servers (streamable HTTP) met OAuth-aanmelding ondersteunt, werkt op dezelfde manier met de URL hierboven.
{
"mcpServers": {
"rankfender": { "url": "https://app.rankfender.com/mcp" }
}
}Met een project-API-sleutel (alleen-lezen)
Voor apps die zich niet kunnen aanmelden gebruik je een project-API-sleutel uit Instellingen → Integraties (zie Je API-sleutel). Een sleutel geeft alleen-lezen toegang tot zijn ene project, ongeacht de rol van de gebruiker. Stuur hem mee als Authorization: Bearer of in de header X-Rankfender-Key.
claude mcp add --transport http rankfender https://api.rankfender.com/functions/v1/mcp \
--header "Authorization: Bearer rfk_your_key"Wat de app kan doen
- Alleen lezen, tenzij „… deze wijzigingen laten doen” op de toestemmingspagina is aangevinkt. Publiceren vereist een derde vinkje, „… op je website laten publiceren”, dat standaard uit staat. Om een van beide te wijzigen, koppel je de app opnieuw.
- Wijzigingen vereisen eigenaars-, beheerders- of redacteursrechten op het project. Kijkers en API-sleutels kunnen alleen lezen.
- Betaalde acties en acties met een waarschuwing (een zoekwoord met de verkeerde intentie, een artikel dat al op een bijna identiek zoekwoord mikt) antwoorden eerst met de kosten, het saldo van de eigenaar en de waarschuwingen en veranderen niets. De app moet opnieuw aanroepen met confirm: true nadat je akkoord bent gegaan.
- Er wordt niets verwijderd. Een zoekwoord, concurrent of gevolgde vraag weghalen verbergt die alleen en is terug te draaien; artikelen kunnen alleen van de kalender worden gehaald; bewerkte tekst bewaart de vorige versie.
- Zonder het publicatievinkje verandert je website niet: een bewerkt artikel komt er pas op als iemand in Rankfender op „Bijwerken op je site” klikt.
- Elk getal komt met zijn meetdatum en bron. In get_portfolio worden waarden ouder dan 30 dagen als verouderd gemarkeerd.
Publiceren op je website
- publish_article publiceert een artikel, of werkt een live artikel bij met de nieuwste tekst (hetzelfde als „Bijwerken op je site” in de Rankfender-app). Daarvoor zijn beide vinkjes nodig.
- Het gebruikt de site die in Rankfender is gekoppeld: WordPress (Rankfender-plugin) of Modern Web (webhook).
- De eerste aanroep zegt wat er gaat gebeuren, op welke site, en wat het kost (ongeveer 1 credit, voor de publicatiecontrole). Er wordt niets verstuurd tot de app opnieuw aanroept met confirm: true.
- Eerst draait de publicatiecontrole van Rankfender, zoals in de Rankfender-app. Houdt die het artikel tegen, dan wordt er niets gepubliceerd: de app krijgt de redenen en een link om ze in Rankfender op te lossen. „Toch publiceren” blijft in de Rankfender-app.
- Het haalt nooit iets offline. Na het publiceren geeft het antwoord de live-URL, of zegt het dat de pagina nog niet live is.
Leestools
Leestools gebruiken geen credits en meten nooit iets nieuws. Zie je meerdere projecten, dan geeft de app aan elke tool de project-id of het domein mee.
| Naam | Wat het geeft |
|---|---|
list_projects | De projecten die deze koppeling kan lezen; zoeken op naam of domein. |
get_portfolio | Eén regel per project: organische trend, trend van AI-zichtbaarheid, open waarschuwingen en de volgende stap van de Strategie, elk met datum. |
get_project_overview | Het project in één oogopslag: zoekwoorden, artikelen, concurrenten, backlinks, AI-zichtbaarheid en voorgestelde volgende stappen. |
get_organic_overview | Google-posities en geschat organisch verkeer uit de eigen zoekdata van Rankfender, zoals op Home. |
get_performance_data | Data uit Search Console en Analytics, als het project ze heeft gekoppeld. |
search_keywords | Alle gevolgde zoekwoorden, of de zoekwoorden met een bepaald woord, met volume, moeilijkheid, positie en rankende URL. |
list_articles | Elk artikel met status, datums, live-URL, kwaliteitsscore en aantal woorden. |
get_article | Eén artikel volledig: tekst, meta, zoekwoorden, opzet, FAQ's, links, kwaliteitscontrole en publicatiestatus. |
list_scheduled_articles | De contentkalender tussen twee datums. |
get_ai_visibility_summary | Zichtbaarheidsscore en trend, vermeldingsgraad per AI-engine, onderwerpen, aandeel in vermeldingen en status van de laatste controle. |
get_ai_visibility_detail | De AI-antwoorden in detail, met de bronnen die ze citeren en de concurrenten die ze noemen. |
list_tracked_prompts | De vragen die Rankfender voor het project aan AI-engines stelt. |
list_competitors | Gevolgde concurrenten met autoriteit en gedeelde zoekwoorden. |
get_competitor_intel | Gemeten concurrentiedata: landschap, zoekwoordkloof, toppagina's, backlinkkloof, siteprofiel. |
get_backlink_profile | Backlinks, verwijzende domeinen, domeinrang, spamscore en verandering sinds de vorige meting. |
get_site_audit | De laatste technische audit: score en belangrijkste problemen, met hoe je ze oplost. |
check_page | Haalt nu één pagina van de site op: status, titel, meta, koppen, schema, afbeeldingen zonder alt-tekst. |
get_opportunities | Contentkansen met prioriteit, verwachte winst en reden. |
get_weekly_insights | De samenvatting van deze week: successen, verbeterpunten en belangrijkste acties. |
get_alerts | Recente waarschuwingen, elk met een voorgestelde actie. |
get_current_strategy | De pagina Strategie: kop, kerndoel en stappen. |
list_tasks | Taken op het bord van Planning en taken die op beoordeling wachten. |
get_task | Eén taak volledig: wat, waarom, stappen, verwacht resultaat en gekoppeld artikel. |
get_credits | De credits van het account: beschikbaar, deze maand gebruikt en datum van de reset. |
get_search_console | Search Console per zoekopdracht, pagina of dag: klikken, vertoningen, CTR, positie gewogen naar vertoningen, vergeleken met de vorige periode; per pagina. |
get_search_engines | Google (Search Console) tegenover Bing (Bing Webmaster Tools): totalen, per zoekopdracht of pagina, waar een van beide beter rankt; bezoeken uit andere zoekmachines. |
get_keyword_clusters | Groepeert gevolgde zoekwoorden die varianten van dezelfde zoekopdracht zijn, met de pagina die elke groep target en concurrerende artikelen. |
get_refresh_plan | Voor één gepubliceerde pagina: zoekopdrachten en posities nu en eerder, daling, zoekopdrachten die de tekst niet beantwoordt, kwaliteitsnotities en een updateplan. |
get_internal_link_suggestions | Links om toe te voegen tussen de gepubliceerde artikelen van het project, met de ankertekst die in elk artikel staat. |
get_ai_citations | De sites en pagina's die AI-engines het vaakst citeren, en welke nog niet naar je linken (een outreachlijst). |
suggest_competitors | Merken die AI-antwoorden noemen en die het project niet volgt, hoe vaak en in welke engines. |
get_cross_signals | Kapotte pagina's die nog zoekopdrachten krijgen, problemen op de pagina's met de meeste klikken, te verbeteren artikelen, door AI geciteerde sites zonder link naar jou. |
Wijzigingstools
Wijzigingstools verschijnen alleen als „… deze wijzigingen laten doen” is aangevinkt; publish_article vereist ook „… op je website laten publiceren”. De app vraagt het je vóór elke wijziging. Credits komen van het account van de projecteigenaar. De cijfers hieronder zijn de huidige schattingen van Rankfender; elke betaalde tool geeft de exacte schatting en het saldo voordat hij iets doet.
| Naam | Wat het doet | Credits |
|---|---|---|
add_keywords | Voegt zoekwoorden toe aan het volgen (zet weggehaalde terug); de zoekwoordlimiet van het abonnement geldt. | Minder dan 1 |
remove_keywords | Stopt met het volgen van zoekwoorden; ze worden verborgen, niet verwijderd. | Geen |
schedule_article | Zet een artikelidee op de kalender (maximaal 2 per dag, één artikel per zoekwoord). | Minder dan 1 |
reschedule_article | Verplaatst een artikel naar een andere datum. | Geen |
unschedule_article | Haalt een artikel van de kalender; een geschreven artikel gaat met zijn tekst terug naar de concepten. | Geen |
update_article_details | Wijzigt titel, doelzoekwoord, meta, slug (niet meer na publicatie) of invalshoek. | Geen |
edit_article | Vervangt de tekst, helemaal of één sectie; de vorige tekst blijft bewaard en de kwaliteitscontrole draait opnieuw. | Geen |
create_article_from_opportunity | Maakt van een contentkans een artikelidee. | Minder dan 1 |
generate_article | Laat de content-engine een artikel schrijven (3–5 minuten). | Ongeveer 30 |
regenerate_article | Herschrijft een artikel, eventueel met instructies; de vorige tekst blijft bewaard. | Ongeveer 30 |
publish_article | Publiceert een artikel op je website of werkt een live artikel bij, na de publicatiecontrole (vereist het publicatievinkje). | Ongeveer 1 |
create_task | Voegt een taak toe aan het bord van Planning, gemarkeerd als afkomstig van een AI-app. | Geen |
update_task_status | Zet een taak op klaar, bezig, gepland, goedgekeurd, backlog of afgewezen. | Geen |
add_competitor | Begint een concurrent te volgen. | Geen |
remove_competitor | Stopt met het volgen van een concurrent; zijn data blijven bewaard. | Geen |
replace_competitor | Ruilt een gevolgde concurrent in voor een andere. | Geen |
measure_competitor | Meet nu een concurrentieweergave (siteprofiel 3, toppagina's 4, zoekwoordkloof 16, backlinkkloof 29, landschap 38 credits) als die ontbreekt of ouder is dan een dag. | 3–38 |
add_tracked_prompts | Voegt vragen van kopers toe aan het volgen van AI-zichtbaarheid. | Geen |
update_tracked_prompt | Herformuleert, verplaatst of pauzeert een gevolgde vraag. | Geen |
run_ai_visibility_check | Stelt de gevolgde vragen opnieuw aan de AI-engines (5–15 minuten). | Ongeveer 25 |
run_site_audit | Crawlt en controleert de site nu (50–300 pagina's, afhankelijk van het abonnement). | Geen |
generate_report | Maakt het projectrapport en geeft een deellink terug die 90 dagen geldig is. | Geen |
score_keywords | Beoordeelt gevolgde zoekwoorden van 0 tot 3 op relevantie voor je merk, met zoekintentie en een korte reden. | Minder dan 1 |
label_keywords | Voegt eigen labels toe aan zoekwoorden of haalt ze weg, om ze te groeperen en te filteren. | Geen |
merge_tasks | Voegt dubbele taken samen; de andere worden gesloten met een link ernaar, er wordt niets verwijderd. | Geen |
update_project_settings | Wijzigt taal, land, branche, type bedrijf of merkomschrijving van het project (alleen eigenaren en projectbeheerders). | Geen |
generate_technical_fix | Schrijft een kant-en-klare correctie voor één pagina (titel, meta-omschrijving, FAQ, definitie, schema); wijzigt niets. | Minder dan 1 |
run_on_projects | Voert een van zeven acties uit op maximaal 25 projecten; de eerste aanroep toont elk project en de totale kosten. | Per actie |
Kant-en-klare prompts
De server biedt vier prompts die de app door de tools leiden. Apps die MCP-prompts ondersteunen, tonen ze in hun promptmenu.
| Naam | Wat het geeft |
|---|---|
weekly_report | Wekelijks rapport over SEO en AI-zichtbaarheid met de volgende drie acties. |
quick_wins | Zoekwoorden vlak bij pagina één, zwakke AI-onderwerpen en pagina's die je kunt verbeteren, de goedkoopste eerst. |
audit_content_plan | Zoekwoorden met de verkeerde intentie, bijna-dubbels, lage kwaliteitsscores en ontbrekende onderwerpen in het contentplan. |
seo_director | Bekijkt alle projecten, kiest waar actie nodig is en stelt de eerste artikelen voor. |
Een taak uit Planning naar een AI-app sturen
Op het bord van Planning opent „Naar AI sturen” bij een taak Claude of ChatGPT met een kant-en-klare prompt, of kopieert die voor Claude Code of Cursor. De app leest de taak met get_task, doet het werk met de Rankfender-tools (en vraagt het je vóór elke wijziging) en zet de taak daarna op klaar met update_task_status. Opent het chatvak leeg, plak dan: de prompt is al gekopieerd. Zichtbaar bij projecten waarvan de eigenaar het abonnement Professional of hoger heeft.
Limieten
| Limiet | Waarde |
|---|---|
| Toolaanroepen | 60 per minuut en 2.000 per dag, per gebruiker en project |
| Wijzigingen | 10 per minuut en 100 per dag, per gebruiker en project |
| Artikelen geschreven of herschreven vanuit AI-apps | 7 per project in 24 uur |
| Artikelen per kalenderdag | 2 |
| Concurrentiemetingen | Eén per weergave per dag |
| Controles van AI-zichtbaarheid | Eén tegelijk |
Ontkoppelen, data en support
Om een app te stoppen open je Accountinstellingen → API-Sleutels → Gekoppelde AI-apps en klik je op Ontkoppelen: de app verliest meteen de toegang, en je projecten en data blijven zoals ze zijn. Rankfender stuurt projectdata alleen naar de app die je hebt gekoppeld, wanneer die een tool aanroept; het privacybeleid beschrijft wat er wordt opgeslagen. Vragen of problemen: support@rankfender.com of de supportpagina.
Problemen oplossen
| Wat je ziet | Waarom | Wat te doen |
|---|---|---|
| “available on the Professional, Business and Enterprise plans” | Het abonnement van de projecteigenaar ligt onder Professional. | Upgrade het abonnement van de eigenaar. |
| “This sign-in link has expired”, of de aanmeldpagina blijft terugkomen | De toestemmingspagina stond langer dan 10 minuten open, of de app is een nieuwe aanmelding gestart. | Sluit hem en koppel opnieuw vanuit de app. |
| “this app is not registered with Rankfender” of “the return address does not match” | De registratie van de app is gewijzigd. | Verwijder de connector in de app en voeg hem opnieuw toe. |
| Antwoorden over het verkeerde project | De koppeling kan meerdere projecten lezen. | Noem het project (domein of naam) in je vraag; list_projects toont welke ze kan lezen. |
| “This connection can only read”, of geen wijzigingstools | „Wijzigingen laten doen” is niet aangevinkt, of er wordt een project-API-sleutel gebruikt. | Koppel de app opnieuw en vink het aan op de toestemmingspagina. |
| “This connection may not publish to the website” | Het publicatievinkje staat uit. | Koppel opnieuw en vink „op je website laten publiceren” aan, of publiceer vanuit het artikel in Rankfender. |
| You are a viewer on this project | Wijzigingen vereisen redacteursrechten. | Vraag de eigenaar om redacteurstoegang. |
| Rate limit / Daily limit reached | Te veel aanroepen of wijzigingen. | Wacht even en probeer het opnieuw. |
| 7 articles were already written or rewritten | Daglimiet voor artikelen vanuit AI-apps. | Probeer het morgen of gebruik de pagina Content. |
| Not enough credits | Het saldo van de eigenaar is lager dan de kosten. | Koop credits of wacht op de maandelijkse reset. |
Let op
De AI-app schrijft de antwoorden en kan zich vergissen. Controleer belangrijke cijfers in Rankfender voordat je iets doet. Rankfender stuurt je projectdata alleen naar de app die je hebt gekoppeld, wanneer die een tool aanroept.