KI-Agent einrichten: zaDojo und Skills

Ein KI-Agent braucht zwei Dinge von zaDojo. Die MCP-Verbindung erlaubt ihm, zaDojo-Tools für Live-SEO-Daten unter https://app.zadojo.com/mcp aufzurufen. Die Skills sind SKILL.md-Dateien, die ihm erklären, wie er eine Aufgabe wie ein Audit oder eine Keyword-Recherche von Anfang bis Ende erledigt. Am schnellsten bekommst du beides, wenn du den Setup-Prompt unten in deinen Agenten einfügst und ihn die Installation machen lässt.

Du nutzt ChatGPT? Dann lies stattdessen die ChatGPT-Anleitung. Ein normaler ChatGPT-Chat kann nichts installieren, deshalb gibt der Prompt dort nur die manuellen Schritte aus. Die eigene Verbindung funktioniert mit ChatGPT Free genauso wie mit den bezahlten Plänen.

Was du brauchst

• Ein zaDojo-Konto. Registriere dich und erhalte 0,10 € Gratis-Guthaben ohne Karte, oder leg das Konto an, wenn der Setup-Ablauf die Anmeldeseite öffnet.
• Einen Agenten, der sich mit einem Remote-MCP-Server verbinden kann: Claude Code, Claude Cowork, Codex (CLI oder die ChatGPT-Desktop-App), Hermes, Grok Bot, Cursor und ähnliche Clients.
• Einen Browser, in dem du die zaDojo-Anmeldung freigeben kannst. Für einen Agenten ohne Browser nutzt du stattdessen einen API-Schlüssel.

Richte deinen Agenten ein

1. Kopiere den Prompt unten. Du findest ihn auch unter Agent setup in der zaDojo-App, oder du verweist deinen Agenten auf die Textversion unter https://zadojo.com/agent-setup.txt.
2. Füge ihn in einen neuen Chat oder eine neue Sitzung deines Agenten ein.
3. Der Agent erkennt, welcher Client er ist, prüft, ob schon eine zaDojo-Verbindung besteht, und installiert das Plugin, wo es eines gibt. Wo es keins gibt, fügt er den MCP-Server und die öffentlichen Skills getrennt hinzu.
4. Wenn dein Browser die zaDojo-Anmeldung öffnet, melde dich an und gib den Zugriff frei.
5. Bittet dich der Agent, neu zu laden, neu zu starten oder etwas anzuklicken, das er nicht erreicht, erledige diesen Schritt. Er sagt dir genau, was zu tun ist.

Set up zaDojo in this agent. Do what you can; guide me through anything that needs my input.

## 1. Check this agent

- Identify this agent and its version. Ask only if you cannot tell.
- Check for an existing zaDojo connection. Preserve other integrations and avoid duplicates.
- Check for zaDojo skills separately. A connection without skills is incomplete.

## 2. If this is ChatGPT

If I pasted this into a regular ChatGPT conversation (web or desktop app, not Codex), you cannot install zaDojo from here. Don't run commands or edit files. Instead, give me these steps and stop:

1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**. This works on Free and paid plans; no upgrade is needed.
2. Open **Settings → Plugins → Developer mode** (or **Plugins → + → Create MCP App**). Name it zaDojo, enter the server URL `https://app.zadojo.com/mcp` in full, including `https://` (otherwise ChatGPT reports "Unsafe URL"), and keep **OAuth** selected.
3. Create it, sign in to zaDojo, and approve the connection.
4. Start a new chat, select zaDojo from the **+** menu, and send: "Use zaDojo to check my connection and list my projects."

Link the [ChatGPT setup guide](https://zadojo.com/docs/chatgpt) for screenshots and troubleshooting. If I'm in Codex, continue below.

## 3. Install the plugin first

The official plugin bundles MCP + SEO skills, with zaDojo namespacing and shared updates.

- **Codex:** follow the [plugin guide](https://zadojo.com/docs/codex-plugin).
- **Claude Code:** follow the [plugin guide](https://zadojo.com/docs/claude-code-plugin).
- **Claude Cowork or the Claude desktop app:** you cannot install plugins from this chat, so don't run commands. Tell me to open **Customize** (in Cowork, the **Cowork** tab first) → **Plugins** → **+** or **Add** → **Add marketplace** → **Add from a repository**, enter `https://github.com/zadojo/seo-geo-mcp`, and install **zaDojo**. Then I start a new task and type `/` to check that zaDojo skills appear. If I already have a custom zaDojo connector, have me remove it once the plugin signs in. Plugins need a paid Claude plan. If I'm on Claude Free, have me add `https://app.zadojo.com/mcp` under **Customize → Connectors** → **Add custom connector** and upload the [public skills](https://zadojo.com/docs/skills/setup) in **Customize → Skills**. Then continue at step 5.
- **Other agents:** verify plugin compatibility in their current documentation.
- Check the installed client's help before running commands.

## 4. Fall back to MCP + skills

If the plugin is unsupported:

- Add `https://app.zadojo.com/mcp` using the [MCP guide](https://zadojo.com/docs/mcp).
- Install the [public SEO skills](https://zadojo.com/docs/skills/setup) for this agent only.
- Do not copy internal repository skills or duplicate bundled skills.
- If skills are unsupported, use MCP alone and link to the workflow guides.

## 5. Sign in

- Prefer OAuth and let me approve login in my browser. If this client cannot use OAuth, send me to `https://app.zadojo.com/settings` → API keys. Have me enter the key in the client's secret settings or environment, never chat or a repository.
- **Manual setup needed?** Use this agent’s current documentation and give only the steps I need to do myself.

## 6. Reload and verify

- Use the current agent’s native reload flow, checking its installed version, help, or official documentation. Prefer automatic discovery or an in-place reload; restart only if required to load the new tools and skills.
- Once tools load in this session, run whoami and list_projects (free reads). Check skill discovery too. If a reload needs my action, give the instructions rather than repeatedly retrying unavailable tools.
- Track installation, sign-in, and verification separately. A connected server is not proof that this session can use its tools. Never claim verification before the free reads succeed.
- Do not create projects or run paid research during installation.

## 7. Finish with a short handoff

Keep progress updates brief. The final reply must be **140 words or fewer** and follow this template:

**Status**
[Briefly say what succeeded or what blocked setup.]

**Next**

1. `[Give the native reload command or UI action for this agent, only if needed.]` Then say “Check that zaDojo is connected.” Approve sign-in if prompted.
2. Try one of these:
   - `[SEO Audit invocation]` **(recommended)**: find your website's biggest SEO issues.
   - `[SEO Project Setup invocation]`: interview you about your website and set up its project context.
   - `[Keyword Research invocation]`: find keywords worth targeting.
   - `[Local SEO invocation]`: review your Google Business Profile and local competitors.

Want to know what was set up? Just ask.

Adapt the template to the actual result:

- If I must install the plugin by hand, as in Claude Cowork, replace step 1 with those clicks.
- If installation failed, name the blocker and replace reload with the fix. If fully verified, say it is ready and omit reload. Do not claim sign-in failed or is required merely because tools need reloading.
- Recommend this agent’s idiomatic way to invoke each installed skill: its native command, mention, picker, or natural-language request. Use the discovered skill name and plugin namespace; do not assume `/skill-name` works everywhere or create aliases to force it. Check the agent’s help or official documentation when unsure. If skills are unsupported, give equivalent plain-language requests using the connected tools. Recommend workflows; do not run them during installation.
- Keep tool names such as whoami and list_projects in your checks, not the final reply. Omit versions, paths, connection details, skill counts, other integrations, and cleanup commands unless they explain the blocker or I ask. Do not add more sections or a verification checklist.

Am Ende meldet der Agent kurz den Status und schlägt ein paar erste Aufgaben vor. Während des Setups legt er keine Projekte an und startet keine kostenpflichtige Recherche.

Manuelles Setup je Agent

Überspring diesen Abschnitt, wenn der Prompt die Installation schon abgeschlossen hat. Jeder Block unten erledigt dieselbe Aufgabe von Hand.

Claude Code

Füge in einer Claude-Code-Sitzung den Marketplace hinzu und installiere das Plugin:

/plugin marketplace add zadojo/seo-geo-mcp
/plugin install zadojo@zadojo

Führe /reload-plugins aus, wenn Claude Code dich bittet, das Plugin zu aktivieren. Gib die zaDojo-Anmeldung frei und tippe dann /zadojo:seo-coach, um zu prüfen, ob die Skills geladen sind. Die Anleitung zum Claude-Code-Plugin erklärt Scopes, Updates und Lösungen für Probleme.

Claude Cowork

In Cowork fügst du Plugins über Menüs hinzu, deshalb kann ein Agent diesen Teil nicht für dich erledigen. Geh zu Customize > Plugins > Add marketplace > Add from a repository, gib https://github.com/zadojo/seo-geo-mcp ein und installiere zaDojo. Dafür brauchst du einen bezahlten Claude-Plan. Die Schritte für Cowork erklären die Alternative für den Free-Plan.

Codex in der ChatGPT-Desktop-App

1. Öffne Codex und starte einen neuen Chat.
2. Füge den Setup-Prompt von dieser Seite ein.
3. Gib die zaDojo-Anmeldung frei, wenn sie erscheint.
4. Meldet Codex, dass die Tools noch nicht geladen sind, starte noch einen neuen Chat.

Für die Installation von Hand folgst du den Schritten für Codex Desktop. Welche ChatGPT-Pläne Codex enthalten, legt OpenAI fest, also sieh auf der Planseite von OpenAI nach. Eine Codex-Verbindung ist von chatgpt.com getrennt: Ein normaler ChatGPT-Chat sieht sie nicht.

Codex CLI

Im Terminal:

codex plugin marketplace add zadojo/seo-geo-mcp
codex plugin add zadojo@zadojo

Taucht das Plugin nicht auf, lade Codex neu oder starte es neu. Dann melde dich an:

codex mcp login zadojo

Bitte Codex, mit SEO Coach zu prüfen, ob alles funktioniert. Die Anleitung zum Codex-Plugin listet die Fehlermeldungen auf, die dir begegnen können. Hast du über ein Plugin-Verzeichnis in der Desktop-App installiert, verwaltest du das Plugin auch dort.

Hermes

Füge den Setup-Prompt ein, um den MCP-Server zu verbinden. Die Skills kommen aus dem Skills-Hub von Hermes. So fügst du SEO Coach hinzu:

hermes skills install zadojo/seo-geo-mcp/plugins/seo-geo-mcp/skills/seo-coach

Führe denselben Befehl mit einem anderen Ordnernamen für jeden weiteren zaDojo-Skill aus, den du willst, zum Beispiel seo-audit oder keyword-research. Hermes merkt sich, woher jeder Skill stammt, damit es später nach Updates suchen kann. Die eigene Dokumentation findest du unter Hermes skill management.

Grok Bot

Füge den Setup-Prompt in deinen Bot ein und erledige die Schritte, die er dir zurückgibt. Fertige Skills und Connectoren findest du unter Marketplace in der Seitenleiste. Private Skills liegen unter Your plugins > Manage plugins and skills > Private skills, und jeder Bot in deinem Konto kann sie nutzen. Die Referenz von xAI findest du unter Grok Bot skills.

Claude im Web und andere Agenten

Verbinde den Server mit der Anleitung zum MCP-Setup. Füge dann die Skills mit dem Skill-Manager hinzu, den dein Agent unterstützt. In Claude verwaltest du eigene Skills unter Customize > Skills. Mit einem bezahlten Claude-Plan fügt das zaDojo-Plugin Verbindung und Skills auf einmal hinzu.

Agenten, die mit der skills-CLI arbeiten, können zaDojo-Skills aus einer Liste auswählen:

npx skills add https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skills

Wähle deinen aktuellen Agenten und den gewünschten Installations-Scope. Führe das nicht zusätzlich zum Plugin aus, denn das Plugin bringt die Skills schon mit. Weitere Wege beschreibt das manuelle Skill-Setup.

Prüfen, ob es geklappt hat

Starte einen neuen Chat und sende:

Use zaDojo to check my connection and list my projects.

Ein funktionierendes Setup ruft zaDojo-Tools auf und liefert dein Konto und deine Projektliste. Eine leere Liste gilt auch als Erfolg: Du hast nur noch kein Projekt angelegt. Diese Prüfung liest nur Daten und verbraucht kein Guthaben.

Prüfe danach die Skills. Tippe in Claude Code /zadojo: und such nach den zwölf Skill-Namen. In Codex tippst du $. In anderen Agenten fragst du "Which zaDojo skills can you see?". Eine Verbindung, die ohne Skills funktioniert, ist nur halb eingerichtet.

Sind beide Prüfungen erfolgreich, bitte deinen Agenten, SEO Coach auszuführen. Er schaut sich an, wo dein Projekt steht, und empfiehlt einen nächsten Schritt.

Skills aktualisieren

Skills werden mit der Zeit besser, aber die Kopien in deinem Agenten aktualisieren sich nicht von selbst. Wenn du die MCP-Verbindung auffrischst, aktualisiert das die Tool-Liste, nicht die Skill-Dateien.

Für ChatGPT gelten stattdessen die Update-Schritte für ChatGPT. Eine eigene ChatGPT-Verbindung hat keine Skill-Dateien, die man aktualisieren müsste.

Am einfachsten fügst du diesen Prompt in den Agenten ein, in dem du zaDojo nutzt. Er findet heraus, wie die Skills installiert wurden, aktualisiert sie an derselben Stelle und behält deine Anmeldung sowie deine eigenen Änderungen an den Skill-Dateien.

Update my installed zaDojo skills using https://zadojo.com/docs/agent-setup#update-your-skills.

If this is ChatGPT on the web or a regular desktop chat, use https://zadojo.com/docs/chatgpt#update-zadojo. For a public directory plugin, start a new chat to load the available tools and skills; reconnect only if sign-in needs attention. For a custom MCP connection, select Refresh in its details, then start a new chat. Refreshing a custom connection updates tools, not skill files. Do not run local Codex commands to update ChatGPT web.

Identify this agent and how zaDojo was installed. Use the matching plugin or skills installer, checking the installed client's help before running commands. Update only zaDojo in its existing scope. Preserve my MCP endpoint, sign-in, and personal skill edits; ask before replacing conflicting edits. Avoid duplicate skills and do not install internal repository skills.

If the skills were copied manually, compare them with https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skills and update the installed public skill folders, including their supporting files. For Grok Bot or another agent without a verified update command, use its supported skill management flow or give me the exact manual steps available in this version.

Reload skills if supported. If I need to reload or start a new session, tell me what to do. Verify the updated skill files and that this agent can discover them; an active MCP connection alone does not prove the skills updated. Briefly tell me what changed and anything left to do. Do not run SEO research during the update.

Es folgen die manuellen Update-Schritte für jede Installationsart.

Claude-Code-Plugin aktualisieren

/plugin marketplace update zadojo
/plugin update zadojo@zadojo
/reload-plugins

Damit du das nicht mehr von Hand machen musst, öffne /plugin, geh zu Marketplaces, wähle zadojo und dann Enable auto-update. Für Marketplaces, die nicht von Anthropic betrieben werden, ist das automatische Update anfangs ausgeschaltet. Meldet Claude Code ein wartendes Update, führe /reload-plugins aus. Anthropic beschreibt die Einstellung unter configure auto-updates.

Codex-CLI-Plugin aktualisieren

codex plugin marketplace upgrade zadojo

Starte Codex neu oder lade es neu, wenn die neuen Skill-Versionen nicht erscheinen. Die Plugin-Befehle von Codex haben sich zwischen Versionen geändert. Wird dieser Befehl abgelehnt, zeigt dir codex plugin --help, was deine Version akzeptiert. OpenAI beschreibt Marketplaces in seiner Plugin-Dokumentation.

Hermes-Hub-Skills aktualisieren

Frag Hermes, für welche Skills es Updates gibt, und aktualisiere dann die zaDojo-Skills nach Namen:

hermes skills check
hermes skills update seo-coach

Wiederhole die Update-Zeile für jeden installierten zaDojo-Skill. Hast du einen Skill lokal bearbeitet, lässt Hermes ihn standardmäßig in Ruhe. Sieh dir zuerst deine Änderungen an. Füge --force nur hinzu, wenn du sie verlieren darfst. Details stehen im Hermes update lifecycle.

Mit der skills-CLI installierte Skills aktualisieren

npx skills list
npx skills update seo-coach seo-audit

Setze die Skill-Namen ein, die du tatsächlich installiert hast. Nutze denselben Scope wie bei der Installation: -g für globale Skills oder -p für Projekt-Skills. Sichere vor dem Update eine Kopie deiner eigenen Änderungen. Neue Skills, die seit deiner Installation dazugekommen sind, holt update nicht. Führe dafür den Installationsbefehl noch einmal aus und wähle sie aus. Die Doku der skills-CLI listet alle Optionen.

Grok Bot oder von Hand kopierte Skills aktualisieren

Für Grok Bot fügst du den Update-Prompt ein oder öffnest Marketplace > Your plugins > Manage plugins and skills und aktualisierst dort den zaDojo-Eintrag. xAI veröffentlicht keinen eigenen Update-Befehl für Skills, nutze also die Bedienelemente, die deine Version anzeigt.

Hast du Skill-Ordner von Hand kopiert, vergleiche sie mit den aktuellen Skill-Ordnern. Ersetze jeden Ordner komplett, einschließlich aller Dateien neben SKILL.md, und übernimm deine eigenen Änderungen. Skills, die du über Customize > Skills in Claude hochgeladen hast, ersetzt du an derselben Stelle.

Lade danach die Skills neu oder öffne eine neue Sitzung und bitte den Agenten zu bestätigen, dass er die aktualisierten zaDojo-Skills sieht.

Fehlerbehebung

Bei allem anderen schreib an hello@zadojo.com mit Name und Version deines Agenten, dem fehlgeschlagenen Schritt und dem genauen Fehlertext. Schick niemals Passwörter, API-Schlüssel oder Anmeldecodes.

Was Guthaben verbraucht

Setup, Anmeldung, die Verbindungsprüfung und Skill-Updates kosten nichts. SEO Coach ist ebenfalls kostenlos, solange du ihn nicht um Recherche bittest. Guthaben wird nur verbraucht, wenn dein Agent kostenpflichtige Daten abruft, und 1.000 Credits entsprechen 1 €. Einige typische Preise:

• Eine Suche in der Keyword-Recherche: etwa 0,07 €.
• Eine Domain- oder Backlink-Übersicht mit einem Jahr Verlauf: etwa 0,10 €.
• Prompt Research für ein Keyword: etwa 0,25 €.

Abfragen aus Search Console und Google Analytics, Projektkontext, gespeicherte Keywords, Berichte und einfache Site Audits sind kostenlos. Der Plan kostet 10 € pro Monat und enthält jeden Monat 10 € Nutzung. Unter Preise findest du die vollständige Liste und einen Kostenrechner.