zaDojo

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/mcp

Beim 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:

  1. Öffne Customize > Connectors.
  2. Klicke auf Add oder + und wähle Add custom connector.
  3. Füge https://app.zadojo.com/mcp ein.
  4. 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

  1. Öffne Customize und geh zu den MCP-Servern, oder bearbeite ~/.cursor/mcp.json direkt.
  2. Füge den zaDojo-Eintrag hinzu:
{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}
  1. 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/mcp

Bestä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:

  1. Öffne Codex und geh zu Settings > MCP servers > Add server.
  2. Gib den Namen zadojo ein, wähle Streamable HTTP und füge https://app.zadojo.com/mcp ein.
  3. Speichere und klicke auf Restart, wenn Codex fragt.
  4. Klicke neben zaDojo auf Authenticate und bestätige die Anmeldung.
  5. Ö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.

ClientWo du es hinzufügstKonfiguration
ZedSettings > AI > MCP Servers > Add Remote Server"context_servers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }
ClineMCP Servers > Remote Servers, oder cline mcp add zadojo https://app.zadojo.com/mcp --transport http"type": "streamableHttp", "url": "https://app.zadojo.com/mcp"
opencodeopencode.json"mcp": { "zadojo": { "type": "remote", "url": "https://app.zadojo.com/mcp" } }
Goosegoose 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" } }
WarpSettings > 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_KEY

Jeder 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.

BereichWichtigste ToolsCredits
Konto und Projektewhoami, list_projects, create_project, get_project_context, update_project_contextKostenlos
Keyword-Rechercheresearch_keywords (Ideen aus 1 bis 5 Seeds), get_keyword_metrics (Volumen, Schwierigkeit, Suchintention, CPC und Trends für bis zu 700 Keywords), search_serp_locationsKostenpflichtig, außer Standortsuche
Google-Ergebnisseget_serp_results (organische Live-Ergebnisse für 1 bis 10 Keywords), find_serp_competitorsKostenpflichtig
Domain-Rechercheget_domain_overview, get_ranked_keywords, get_domain_keyword_suggestionsKostenpflichtig
Backlinksget_backlinks_overview, get_backlinks_profileKostenpflichtig
Gespeicherte Keywordslist_saved_keywords, save_keywords, remove_saved_keywordsKostenlos
Rank Trackingcreate_rank_tracker, add_rank_tracking_keywords, estimate_rank_tracker_cost, run_rank_tracker, get_rank_tracker, pin_rank_tracking_keywords, remove_rank_tracking_keywordsPrüfungen kostenpflichtig, Einrichtung und Abrufe kostenlos
Site Auditrun_site_audit, get_audit_status, get_audit_issues, get_audit_pages, list_site_audits, delete_site_auditKostenlos ohne Lighthouse oder JavaScript-Rendering
Lokales SEOsearch_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_categoriesKostenpflichtig, außer Kategoriesuche
Google Search Consoleget_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 Analyticsget_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_opportunitiesKostenlos
KI-Sichtbarkeitresearch_ai_visibility_prompts, explore_prompt, generate_ai_visibility_prompts, save_ai_visibility_tracker, estimate_ai_visibility_cost, set_ai_visibility_schedule, run_ai_visibility_checkKostenpflichtig
Ergebnisse KI-Sichtbarkeitget_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_dataKostenlos
Berichtesave_report, list_reports, get_report, delete_report, set_report_sharing, list_report_templates, save_report_template, delete_report_templateKostenlos

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_sharing mit public: true aufzurufen, und public: false widerruft ihn. get_report gibt report.shareUrl zurück, wenn ein öffentlicher Link existiert, sonst null.
  • 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:

AktionTypische Kosten
Keyword-Rechercheetwa 0,07 €
Domain- oder Backlink-Übersicht mit 12 Monaten Verlaufetwa 0,10 €
Lokale Prüfung in Maps oder Local Finderetwa 0,006 €
Eine KI-Prompt-Prüfung auf einer Engineetwa 0,002 €
Prompt Research für ein Keywordetwa 0,25 €
Wöchentliches Tracking von 100 Keywords auf einem Gerätetwa 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":

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.