zaDojo MCP-Server: Claude, Cursor, Codex
Verbinde den zaDojo MCP-Server für SEO und KI-Sichtbarkeit mit Claude, ChatGPT, Cursor, Codex, VS Code, Windsurf oder Gemini CLI per OAuth oder API-Key.
zaDojo betreibt einen Remote-MCP-Server, mit dem sich jeder Client verbinden kann, der Remote-MCP unterstützt. MCP (Model Context Protocol) ist der Standardweg, über den KI-Apps externe Tools aufrufen. Darüber kann dein Agent Keywords recherchieren, Live-Ergebnisse bei Google lesen, Rankings und Backlinks jeder Domain nachschlagen, Site Audits ausführen, Rankings und KI-Antworten tracken und deine eigenen Daten aus Search Console und Google Analytics lesen.
Die Serveradresse:
https://app.zadojo.com/mcpBeim ersten Verbinden öffnet ein Client die zaDojo-Anmeldung in deinem Browser und bittet dich, den Zugriff zu erlauben. Danach kann der Client die Tools für die Projekte nutzen, die du sehen kannst. Für CI-Jobs und Server ohne Browser nutzt du einen API-Key.
Wer Claude Code oder Codex nutzt, holt mit dem Plugin mehr heraus. Es fügt diese Verbindung und die zwölf zaDojo-Skills in einer Installation hinzu. Folge den Schritten auf dieser Seite, wenn du nur die MCP-Verbindung willst oder dein Client kein Plugin hat. Die Agent-Setup-Anleitung enthält einen Prompt, der den passenden Weg für dich wählt.
Was du brauchst
- Ein zaDojo-Konto. Registriere dich und erhalte 0,10 € Testguthaben ohne Karte.
- Einen Client, der Remote-MCP-Server über HTTP unterstützt: Claude Code, Claude Desktop, Cursor, Codex CLI, Codex in der ChatGPT Desktop-App, ChatGPT mit einer eigenen Verbindung, VS Code mit Copilot, Windsurf (Devin Desktop), Gemini CLI, Zed oder Ähnliches.
- Einen Browser für die Anmeldung oder einen API-Key für die Nutzung ohne Browser.
Die Seite Agent setup in der App zeigt dieselbe Adresse mit einem Kopierknopf. Du willst zaDojo-Daten ausprobieren, bevor du dich registrierst? Die kostenlosen SEO-Tools brauchen kein Konto.
Deinen Client verbinden
Claude Code
Für die meisten ist das Claude Code-Plugin die bessere Wahl. Nur für die Verbindung führst du das in einem Terminal aus:
claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp--scope user macht zaDojo in jedem Projekt auf deinem Rechner verfügbar. Mit --scope local beschränkst du es auf das aktuelle Repository. Claude Code fordert dich dann zur Anmeldung bei zaDojo auf. Erscheint die Abfrage nicht, führe /mcp aus, wähle zaDojo und schließe die Anmeldung dort ab.
Claude Desktop
Mit einem bezahlten Claude-Plan fügt das zaDojo-Plugin Verbindung und Skills zusammen hinzu. Mit dem Free-Plan oder nur für die Verbindung fügst du einen Custom Connector hinzu:
- Öffne Customize > Connectors.
- Klicke auf Add oder + und wähle Add custom connector.
- Füge
https://app.zadojo.com/mcpein. - Melde dich bei zaDojo an und erlaube den Zugriff.
Custom Connectors funktionieren mit Claude Free, Pro, Max, Team und Enterprise. Der Free-Plan erlaubt einen Custom Connector.
Cursor
- Öffne Customize und geh zu den MCP-Servern, oder bearbeite
~/.cursor/mcp.jsondirekt. - Füge den zaDojo-Eintrag hinzu:
{
"mcpServers": {
"zadojo": {
"url": "https://app.zadojo.com/mcp"
}
}
}- Speichere die Datei und bestätige die zaDojo-Anmeldung, wenn Cursor fragt.
Die Cursor-Anleitung enthält einen Ein-Klick-Installationslink und die Installation der Skills.
Codex CLI
Das Codex-Plugin fügt Verbindung und Skills zusammen hinzu. Nur für die Verbindung:
codex mcp add zadojo --url https://app.zadojo.com/mcpBestätige die zaDojo-Anmeldung, wenn sie sich öffnet. Öffnet sie sich nicht, führe codex mcp login zadojo aus.
Codex in der ChatGPT Desktop-App
Das Codex-Plugin enthält auch die Skills. Nur für die Verbindung:
- Öffne Codex und geh zu Settings > MCP servers > Add server.
- Gib den Namen
zadojoein, wähle Streamable HTTP und fügehttps://app.zadojo.com/mcpein. - Speichere und klicke auf Restart, wenn Codex fragt.
- Klicke neben zaDojo auf Authenticate und bestätige die Anmeldung.
- Öffne einen neuen Codex-Chat und führe die Verbindungsprüfung aus.
Diese Verbindung gilt nur für Codex. ChatGPT im Web braucht eine eigene. Die Referenz von OpenAI ist die Codex-MCP-Dokumentation.
ChatGPT
Füge zaDojo als eigene MCP-Verbindung mit OAuth hinzu. Das funktioniert mit ChatGPT Free und den bezahlten Plänen, allerdings können Workspace-Admins eigene Verbindungen sperren. Die ChatGPT-Anleitung geht jeden Bildschirm durch.
VS Code, Windsurf und Gemini CLI
Jeder Client hat eine eigene Seite mit der genauen Konfiguration, der Einrichtung per API-Key und der Installation der Skills:
Andere MCP-Clients
Jeder Client, der einen Remote-MCP-Server über Streamable HTTP erreicht und die OAuth-Anmeldung unterstützt, kann die Adresse oben nutzen. Kann der Client kein OAuth, sende einen API-Key in einem Header, wie unten beschrieben.
| Client | Wo du es hinzufügst | Konfiguration |
|---|---|---|
| Zed | Settings > AI > MCP Servers > Add Remote Server | "context_servers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } } |
| Cline | MCP Servers > Remote Servers, oder cline mcp add zadojo https://app.zadojo.com/mcp --transport http | "type": "streamableHttp", "url": "https://app.zadojo.com/mcp" |
| opencode | opencode.json | "mcp": { "zadojo": { "type": "remote", "url": "https://app.zadojo.com/mcp" } } |
| Goose | goose configure > Add Extension > Remote Extension (Streamable HTTP) | type: streamable_http, uri: https://app.zadojo.com/mcp |
| Kiro | ~/.kiro/settings/mcp.json | "mcpServers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } } |
| Warp | Settings > Agents > MCP servers > Add > Streamable HTTP or SSE Server (URL) | { "zadojo": { "url": "https://app.zadojo.com/mcp" } } |
| JetBrains Junie | ~/.junie/mcp/mcp.json, dann /mcp > Authorize | "zadojo": { "url": "https://app.zadojo.com/mcp" } |
Alle diese Clients öffnen beim ersten Verbinden die zaDojo-Anmeldung in deinem Browser.
Mit einem API-Key verbinden
Ein API-Key ersetzt die Anmeldung im Browser. Nutze einen für CI-Pipelines, entfernte Server, Agenten wie Hermes, bei denen die Anmeldung nicht funktioniert, oder jeden Client ohne OAuth-Unterstützung.
Ein Key gehört dir persönlich. Alles, was ein Agent damit tut, läuft als dein Konto in deinem Workspace. Speichere ihn also als Secret und committe ihn niemals in ein Repository.
Um einen zu erstellen, öffne die Settings in der zaDojo-App, such API keys und klicke auf Create API key. Kopiere den Key sofort, denn zaDojo zeigt ihn nur einmal. Keys beginnen mit zadojo_.
Claude Code:
claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp --header "Authorization: Bearer zadojo_YOUR_KEY"Cursor: Füge dem zaDojo-Eintrag in mcp.json einen headers-Block hinzu:
{
"mcpServers": {
"zadojo": {
"url": "https://app.zadojo.com/mcp",
"headers": {
"Authorization": "Bearer zadojo_YOUR_KEY"
}
}
}
}Codex CLI: Bewahre den Key in einer Umgebungsvariable auf und verweise Codex darauf:
export ZADOJO_API_KEY=zadojo_YOUR_KEY
codex mcp add zadojo --url https://app.zadojo.com/mcp --bearer-token-env-var ZADOJO_API_KEYJeder andere Client: Sende mit jeder Anfrage entweder Authorization: Bearer zadojo_YOUR_KEY oder x-api-key: zadojo_YOUR_KEY.
Um einen Key zu widerrufen, öffne denselben Bereich API keys und entferne ihn.
Die Verbindung prüfen
Öffne einen neuen Chat oder eine neue Sitzung und sende:
Use zaDojo to check my connection and list my projects.Der Agent sollte whoami und list_projects aufrufen. Du bekommst dein Konto, dein restliches Guthaben und deine Projekte zurück, oder eine leere Liste, wenn du noch keine hast. Beide Tools sind kostenlos. Beschreibt der Agent MCP, statt ein Tool aufzurufen, ist der Server in dieser Sitzung nicht geladen: Lade den Client neu oder starte einen neuen Chat.
Verfügbare Tools
Der Server hat mehr als 80 Tools. Die Tabelle gruppiert sie nach Aufgabe. Die Tool-Namen sind das, was dein Agent sieht.
| Bereich | Wichtigste Tools | Credits |
|---|---|---|
| Konto und Projekte | whoami, list_projects, create_project, get_project_context, update_project_context | Kostenlos |
| Keyword-Recherche | research_keywords (Ideen aus 1 bis 5 Seeds), get_keyword_metrics (Volumen, Schwierigkeit, Suchintention, CPC und Trends für bis zu 700 Keywords), search_serp_locations | Kostenpflichtig, außer Standortsuche |
| Google-Ergebnisse | get_serp_results (organische Live-Ergebnisse für 1 bis 10 Keywords), find_serp_competitors | Kostenpflichtig |
| Domain-Recherche | get_domain_overview, get_ranked_keywords, get_domain_keyword_suggestions | Kostenpflichtig |
| Backlinks | get_backlinks_overview, get_backlinks_profile | Kostenpflichtig |
| Gespeicherte Keywords | list_saved_keywords, save_keywords, remove_saved_keywords | Kostenlos |
| Rank Tracking | create_rank_tracker, add_rank_tracking_keywords, estimate_rank_tracker_cost, run_rank_tracker, get_rank_tracker, pin_rank_tracking_keywords, remove_rank_tracking_keywords | Prüfungen kostenpflichtig, Einrichtung und Abrufe kostenlos |
| Site Audit | run_site_audit, get_audit_status, get_audit_issues, get_audit_pages, list_site_audits, delete_site_audit | Kostenlos ohne Lighthouse oder JavaScript-Rendering |
| Lokales SEO | search_local_businesses, get_local_serp_results (Maps oder Local Finder), get_local_rank_grid, get_business_profile, get_business_reviews, get_business_updates, get_google_business_questions, list_business_categories | Kostenpflichtig, außer Kategoriesuche |
| Google Search Console | get_search_console_performance, get_search_console_insights (Seiten mit niedriger CTR, kannibalisierte Suchanfragen, Klickgewinne und -verluste), get_search_console_hourly (die letzten 48 Stunden), get_search_console_sitemaps, inspect_urls (bis zu 10 URLs pro Aufruf) | Kostenlos |
| Google Analytics | get_google_analytics_organic_overview, get_google_analytics_organic_landing_pages, get_google_analytics_page_performance, get_google_analytics_traffic_acquisition, get_google_analytics_key_events, get_google_analytics_ecommerce_performance, get_google_analytics_site_search, get_google_analytics_audience_breakdown, get_google_analytics_measurement_health, get_google_analytics_traffic_overview, get_google_analytics_breakdown, get_google_analytics_realtime_users, get_search_opportunities | Kostenlos |
| KI-Sichtbarkeit | research_ai_visibility_prompts, explore_prompt, generate_ai_visibility_prompts, save_ai_visibility_tracker, estimate_ai_visibility_cost, set_ai_visibility_schedule, run_ai_visibility_check | Kostenpflichtig |
| Ergebnisse KI-Sichtbarkeit | get_ai_visibility_tracker, get_ai_visibility_run, get_ai_visibility_results, get_ai_visibility_answer, get_ai_visibility_sources, get_ai_visibility_trend, export_ai_visibility_data | Kostenlos |
| Berichte | save_report, list_reports, get_report, delete_report, set_report_sharing, list_report_templates, save_report_template, delete_report_template | Kostenlos |
Ein paar Verhaltensweisen, die du kennen solltest:
- Projektkontext ist das gemeinsame Gedächtnis eines Projekts: Unternehmensüberblick, aktuelles Ziel, Positionierung, Schreibvorlieben, Wettbewerber, wichtige Seiten und ein Recherche-Log. Agenten lesen ihn, bevor sie anfangen, und die App und andere Agenten sehen dieselben Einträge.
- Berichte, die ein Agent speichert, erscheinen im Projekt, wo dein ganzes Team sie lesen, drucken oder exportieren kann. Neue Berichte sind privat. Ein öffentlicher Link entsteht nur, wenn du den Agenten bittest,
set_report_sharingmitpublic: trueaufzurufen, undpublic: falsewiderruft ihn.get_reportgibtreport.shareUrlzurück, wenn ein öffentlicher Link existiert, sonstnull. - Search Console und Google Analytics-Tools lesen die Property, die bereits mit dem Projekt verbunden ist. Der Zugriff ist nur lesend.
- Schätzungen kommen zuerst bei allem, was sich wiederholt. Rank Tracking und KI-Tracking haben beide Schätzungs-Tools, damit dir der Agent die Kosten zeigen kann, bevor er Prüfungen plant.
Was Credits verbraucht
Credits kommen aus deinem zaDojo-Guthaben. 1.000 Credits entsprechen 1 €, und der Plan für 10 € im Monat enthält 10 € Nutzung. Typische Preise:
| Aktion | Typische Kosten |
|---|---|
| Keyword-Recherche | etwa 0,07 € |
| Domain- oder Backlink-Übersicht mit 12 Monaten Verlauf | etwa 0,10 € |
| Lokale Prüfung in Maps oder Local Finder | etwa 0,006 € |
| Eine KI-Prompt-Prüfung auf einer Engine | etwa 0,002 € |
| Prompt Research für ein Keyword | etwa 0,25 € |
| Wöchentliches Tracking von 100 Keywords auf einem Gerät | etwa 1 bis 2 € im Monat |
Kostenlos: Kontoprüfungen, Projektkontext, gespeicherte Keywords, Berichte, Search Console, Google Analytics, einfache Site Audits und das Lesen bereits gesammelter Ergebnisse aus Rank Tracking, Audits oder KI-Sichtbarkeit. Mit zaDojo verbundene Agenten sind angewiesen, dich vor einem geplanten Batch über 2.000 Credits (etwa 2 €) zu fragen. Sinkt das Guthaben auf null, stoppen die kostenpflichtigen Tools, bis du aufstockst. Den Kostenrechner findest du unter Preise.
Nach dem Verbinden
Die Verbindung gibt deinem Agenten Daten. Skills sagen ihm Schritt für Schritt, was er damit tun soll. Hast du MCP ohne Plugin eingerichtet, installiere als Nächstes die Skills.
Gib dem Agenten eine konkrete Aufgabe, statt ihn zu bitten, "SEO zu machen":
- SEO Project Setup: Ziel, Positionierung, Wettbewerber und wichtige Seiten speichern, damit jede spätere Aufgabe darauf aufbaut.
- SEO Coach: einen empfohlenen nächsten Schritt bekommen, wenn du neu im SEO bist.
- SEO Audit: die wenigen Änderungen finden, die am ehesten Traffic bringen.
- Keyword Research und Keyword Clustering: lohnende Suchbegriffe finden und sie zu Seiten gruppieren.
- Competitive Landscape und Competitor Analysis: einen Markt abbilden oder einen Konkurrenten genau untersuchen.
- Link Prospecting: Websites finden, die auf eine Seite verlinken könnten, und Outreach entwerfen.
- AI Prompt Research und AI Visibility Audit: sehen, was KI-Tools über deinen Markt sagen und warum Wettbewerber genannt werden.
Der Leitfaden zur KI-Sichtbarkeit erklärt Engines, Abdeckung und Kosten für das Tracking von KI-Antworten.
Fehlerbehebung
Der Client kann sich nicht verbinden. Prüfe, dass die Adresse genau https://app.zadojo.com/mcp lautet, mit https:// und ohne Leerzeichen am Ende.
Codex meldet Authorization server response missing required issuer: expected https://app.zadojo.com. Die Codex-Versionen 0.143 bis 0.146 verlieren den Issuer während OAuth. Aktualisiere Codex CLI oder die Codex Desktop-App auf 0.147.0 oder neuer, oder nutze einen API-Key.
Die Anmeldung schlägt fehl oder läuft ständig ab. Entferne den zaDojo-Server aus deinem Client, füge ihn neu hinzu und melde dich erneut an.
Der Agent findet kein Projekt. Bitte ihn, zuerst list_projects aufzurufen und die zurückgegebene Projekt-ID in späteren Aufrufen wiederzuverwenden. Hast du keine Projekte, bitte ihn, mit create_project eines für deine Domain anzulegen. Das ist kostenlos.
Ein kostenpflichtiges Tool meldet, dass deine Credits aufgebraucht sind. Im bezahlten Plan kaufst du in der App unter Abrechnung eine Aufstockung oder wartest, bis deine monatlichen Credits zurückgesetzt werden. In der Testphase abonnierst du, um kostenpflichtige Tools weiter zu nutzen.
Kommst du nicht weiter? Schreib an hello@zadojo.com mit dem Namen und der Version deines Clients und der genauen Fehlermeldung. Schick niemals API-Keys mit.