zaDojo MCP-server: Claude, Cursor en Codex

zaDojo draait een externe MCP-server waarmee elke client die externe MCP ondersteunt verbinding kan maken. MCP (Model Context Protocol) is de standaardmanier waarop AI-apps externe tools aanroepen. Daarmee kan je agent zoekwoorden onderzoeken, live Google-resultaten lezen, de posities en backlinks van elk domein opzoeken, site-audits draaien, posities en AI-antwoorden volgen en je eigen Search Console- en Google Analytics-data lezen.

Het serveradres:

https://app.zadojo.com/mcp

De eerste keer dat een client verbinding maakt, opent die een zaDojo-login in je browser en vraagt je toegang te geven. Daarna kan de client de tools gebruiken voor de projecten die jij kunt zien. Gebruik voor CI-jobs en servers zonder browser een API-sleutel.

Gebruikers van Claude Code en Codex halen meer uit de plugin, die deze koppeling en de twaalf zaDojo-skills in één installatie toevoegt. Gebruik de stappen op deze pagina als je alleen de MCP-koppeling wilt, of als je client geen plugin heeft. De setupgids voor agents heeft een prompt die de juiste route voor je kiest.

Wat je nodig hebt

• Een zaDojo-account. Meld je aan en krijg € 0,10 proeftegoed zonder creditcard.
• Een client die externe MCP-servers via HTTP ondersteunt: Claude Code, Claude Desktop, Cursor, Codex CLI, Codex in de ChatGPT-desktopapp, ChatGPT met een eigen koppeling, VS Code met Copilot, Windsurf (Devin Desktop), Gemini CLI, Zed of iets vergelijkbaars.
• Een browser om in te loggen, of een API-sleutel voor gebruik zonder browser.

De pagina Agent setup in de app toont hetzelfde adres met een kopieerknop. Wil je zaDojo-data proberen voordat je je aanmeldt? De gratis SEO-tools werken zonder account.

Je client koppelen

Claude Code

De Claude Code-plugin is voor de meeste mensen de betere keuze. Voer voor alleen de koppeling dit uit in een terminal:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

Met --scope user is zaDojo beschikbaar in elk project op je computer. Gebruik --scope local om het tot de huidige repository te beperken. Claude Code vraagt je daarna in te loggen bij zaDojo. Verschijnt die vraag niet, voer dan /mcp uit, kies zaDojo en rond de login daar af.

Claude Desktop

Met een betaald Claude-abonnement voegt de zaDojo-plugin de koppeling en de skills samen toe. Op het gratis abonnement, of voor alleen de koppeling, voeg je een custom connector toe:

1. Open Customize > Connectors.
2. Klik op Add of + en kies Add custom connector.
3. Plak https://app.zadojo.com/mcp.
4. Log in bij zaDojo en geef toegang.

Custom connectors werken op Claude Free, Pro, Max, Team en Enterprise. Op het gratis abonnement mag je één custom connector hebben.

Cursor

1. Open Customize en ga naar MCP servers, of bewerk ~/.cursor/mcp.json direct.
2. Voeg de zaDojo-regel toe:

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

3. Sla het bestand op en keur de zaDojo-login goed wanneer Cursor erom vraagt.

De Cursor-handleiding heeft een installatielink met één klik en de installatie van de skills.

Codex CLI

De Codex-plugin voegt de koppeling en de skills samen toe. Voor alleen de koppeling:

codex mcp add zadojo --url https://app.zadojo.com/mcp

Keur de zaDojo-login goed wanneer die opent. Opent hij niet, voer dan codex mcp login zadojo uit.

Codex in de ChatGPT-desktopapp

De Codex-plugin bevat ook de skills. Voor alleen de koppeling:

1. Open Codex en ga naar Settings > MCP servers > Add server.
2. Vul de naam zadojo in, kies Streamable HTTP en plak https://app.zadojo.com/mcp.
3. Sla op en klik op Restart wanneer Codex erom vraagt.
4. Klik op Authenticate naast zaDojo en keur de login goed.
5. Open een nieuwe Codex-chat en voer de verbindingscontrole uit.

Deze koppeling geldt alleen voor Codex. ChatGPT op het web heeft een eigen koppeling nodig. De referentie van OpenAI is de MCP-documentatie van Codex.

ChatGPT

Voeg zaDojo toe als eigen MCP-koppeling met OAuth. Dat werkt op ChatGPT Free en de betaalde abonnementen, al kunnen workspace-beheerders eigen koppelingen blokkeren. De ChatGPT-handleiding loopt elk scherm met je door.

VS Code, Windsurf en Gemini CLI

Elk heeft een eigen pagina met de exacte configuratie, de setup met API-sleutel en de installatie van de skills:

• VS Code met GitHub Copilot
• Windsurf (Devin Desktop)
• Gemini CLI en Antigravity CLI

Andere MCP-clients

Elke client die een externe MCP-server via streamable HTTP kan bereiken en inloggen via OAuth ondersteunt, kan het adres hierboven gebruiken. Kan de client geen OAuth, stuur dan een API-sleutel mee in een header, zoals hieronder beschreven.

Al deze clients openen de eerste keer de zaDojo-login in je browser.

Koppelen met een API-sleutel

Een API-sleutel vervangt het inloggen via de browser. Gebruik er een voor CI-pipelines, externe servers, agents zoals Hermes waar de loginflow niet werkt, of elke client zonder OAuth-ondersteuning.

Een sleutel is persoonlijk. Alles wat een agent ermee doet, draait als jouw account in jouw workspace. Bewaar hem dus als geheim en commit hem nooit naar een repository.

Om er een te maken open je Settings in de zaDojo-app, zoek je API keys en klik je op Create API key. Kopieer de sleutel meteen, want zaDojo toont hem maar één keer. Sleutels beginnen met zadojo_.

Claude Code:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp --header "Authorization: Bearer zadojo_YOUR_KEY"

Cursor: voeg een headers-blok toe aan de zaDojo-regel in mcp.json:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp",
      "headers": {
        "Authorization": "Bearer zadojo_YOUR_KEY"
      }
    }
  }
}

Codex CLI: zet de sleutel in een omgevingsvariabele en laat Codex ernaar verwijzen:

export ZADOJO_API_KEY=zadojo_YOUR_KEY
codex mcp add zadojo --url https://app.zadojo.com/mcp --bearer-token-env-var ZADOJO_API_KEY

Elke andere client: stuur bij elk verzoek Authorization: Bearer zadojo_YOUR_KEY of x-api-key: zadojo_YOUR_KEY mee.

Wil je een sleutel intrekken, open dan dezelfde sectie API keys en verwijder hem.

De verbinding controleren

Open een nieuwe chat of sessie en stuur:

Gebruik zaDojo om mijn verbinding te controleren en mijn projecten te tonen.

De agent hoort whoami en list_projects aan te roepen. Je krijgt je account, je resterende tegoed en je projecten terug, of een lege lijst als je er nog geen hebt. Beide tools zijn gratis. Beschrijft de agent MCP in plaats van een tool aan te roepen, dan is de server in deze sessie niet geladen: herlaad de client of start een nieuwe chat.

Beschikbare tools

De server heeft meer dan 80 tools. De tabel groepeert ze per taak. De toolnamen zijn wat je agent ziet.

Een paar dingen die goed zijn om te weten:

• Projectcontext is gedeeld geheugen voor een project: bedrijfsoverzicht, huidig doel, positionering, schrijfvoorkeuren, concurrenten, belangrijke pagina's en een onderzoekslog. Agents lezen die voordat ze beginnen, en de app en andere agents zien dezelfde gegevens.
• Rapporten die een agent opslaat, verschijnen in het project zodat je hele team ze kan lezen, printen of exporteren. Nieuwe rapporten zijn privé. Een openbare link ontstaat alleen als je de agent vraagt set_report_sharing met public: true aan te roepen, en public: false trekt hem weer in. get_report geeft report.shareUrl terug als er een openbare link is, of null als die er niet is.
• Search Console en Google Analytics-tools lezen de property die al aan het project gekoppeld is. De toegang is alleen-lezen.
• Eerst een schatting voor alles wat terugkeert. Rank tracking en AI-tracking hebben allebei schattingstools, zodat de agent je de kosten kan tonen voordat hij controles inplant.

Wat tegoed kost

Tegoed komt van je zaDojo-saldo. 1.000 credits zijn € 1 waard, en het abonnement van € 10 per maand bevat € 10 aan gebruik. Gebruikelijke prijzen:

Gratis: accountcontroles, projectcontext, opgeslagen zoekwoorden, rapporten, Search Console, Google Analytics, gewone site-audits en het lezen van resultaten van rank tracking, audits of AI-zichtbaarheid die je al verzameld hebt. Agents die aan zaDojo gekoppeld zijn, is opgedragen het je te vragen voor een geplande batch boven 2.000 credits (ongeveer € 2). Staat je saldo op nul, dan stoppen betaalde tools tot je bijvult. Zie prijzen voor de rekentool.

Na het koppelen

De koppeling geeft je agent data. Skills vertellen hem stap voor stap wat hij met die data doet. Heb je MCP zonder plugin gebruikt, installeer dan nu de skills.

Geef de agent één concrete taak in plaats van hem te vragen "aan SEO te doen":

• SEO Project Setup: sla je doel, positionering, concurrenten en belangrijke pagina's op, zodat elke latere taak daarvan uitgaat.
• SEO Coach: krijg één aanbevolen volgende stap als SEO nieuw voor je is.
• SEO Audit: vind de paar wijzigingen die het meest verkeer opleveren.
• Keyword Research en Keyword Clustering: vind zoektermen die het waard zijn en groepeer ze in pagina's.
• Competitive Landscape en Competitor Analysis: breng een markt in kaart, of bestudeer één concurrent grondig.
• Link Prospecting: vind sites die naar een pagina zouden kunnen linken en schrijf conceptmails.
• AI Prompt Research en AI Visibility Audit: zie wat AI-tools over je markt zeggen en waarom concurrenten genoemd worden.

De handleiding AI-zichtbaarheid behandelt engines, dekking en kosten van het volgen van AI-antwoorden.

Problemen oplossen

De client kan geen verbinding maken. Controleer of het adres precies https://app.zadojo.com/mcp is, met https:// en zonder spaties aan het eind.

Codex meldt Authorization server response missing required issuer: expected https://app.zadojo.com. Codex-releases 0.143 tot en met 0.146 laten de issuer weg tijdens OAuth. Werk Codex CLI of de Codex-desktopapp bij naar 0.147.0 of nieuwer, of gebruik een API-sleutel.

Inloggen mislukt of verloopt steeds. Verwijder de zaDojo-server uit je client, voeg hem opnieuw toe en log opnieuw in.

De agent vindt een project niet. Vraag hem eerst list_projects aan te roepen en het teruggegeven project-ID in latere aanroepen te gebruiken. Heb je geen projecten, vraag hem dan er een voor je domein aan te maken met create_project, wat gratis is.

Een betaalde tool meldt dat je tegoed op is. Koop met het betaalde abonnement extra tegoed via billing in de app, of wacht tot je maandelijkse tegoed opnieuw ingaat. Tijdens de proefperiode neem je een abonnement om betaalde tools te blijven gebruiken.

Kom je er niet uit? Mail hello@zadojo.com met de naam en versie van je client en de exacte foutmelding. Stuur nooit API-sleutels mee.