AI ügynök beállítása: zaDojo és skillek

Egy AI ügynöknek két dologra van szüksége a zaDojótól. Az MCP-kapcsolat lehetővé teszi, hogy élő SEO-adatokért zaDojo eszközöket hívjon a https://app.zadojo.com/mcp címen. A skillek SKILL.md fájlok, amelyek megmondják neki, hogyan vigyen végig egy feladatot, például egy auditot vagy egy kulcsszókutatást. Mindkettőt a leggyorsabban úgy kapod meg, ha beilleszted az alábbi beállító promptot az ügynöködbe, és hagyod, hogy elvégezze a telepítést.

ChatGPT-t használsz? Akkor inkább a ChatGPT útmutatót kövesd. Egy szokásos ChatGPT-chat semmit sem tud telepíteni, így a prompt csak kiíratja vele a kézi lépéseket. Az egyéni kapcsolat a ChatGPT Free és a fizetős csomagokon is működik.

Mire van szükséged

• Egy zaDojo fiókra. Regisztrálj, és bankkártya nélkül kapsz 0,10 € próbakreditet, vagy hozd létre a fiókot, amikor a beállítás megnyitja a bejelentkezési oldalt.
• Egy ügynökre, amely tud távoli MCP szerverhez csatlakozni: Claude Code, Claude Cowork, Codex (CLI vagy a ChatGPT asztali alkalmazás), Hermes, Grok Bot, Cursor és hasonló kliensek.
• Egy böngészőre, ahol jóváhagyhatod a zaDojo bejelentkezést. Böngésző nélküli (headless) ügynökhöz használj inkább API-kulcsot.

Az ügynököd beállítása

1. Másold ki az alábbi promptot. Kimásolhatod a zaDojo alkalmazás Agent setup oldaláról is, vagy irányítsd az ügynöködet az egyszerű szöveges változatra: https://zadojo.com/agent-setup.txt.
2. Illeszd be egy új chatbe vagy munkamenetbe az ügynöködben.
3. Az ügynök kitalálja, melyik kliens ő, megnézi, van-e már zaDojo kapcsolat, és ahol létezik plugin, azt telepíti. Ahol nincs plugin, külön adja hozzá az MCP szervert és a nyilvános skilleket.
4. Amikor a böngésződ megnyitja a zaDojo bejelentkezést, jelentkezz be, és hagyd jóvá a hozzáférést.
5. Ha az ügynök arra kér, hogy tölts újra, indíts újra valamit, vagy kattints valamire, amit ő nem ér el, végezd el azt a lépést. Pontosan megmondja, mit kell tenned.

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.

Az ügynök egy rövid állapotüzenettel és néhány javasolt első feladattal zárja a folyamatot. A beállítás során nem hoz létre projektet, és nem futtat fizetős kutatást.

Kézi beállítás ügynökönként

Hagyd ki ezt a részt, ha a prompt már befejezte a telepítést. Az alábbi blokkok ugyanezt végzik el kézzel.

Claude Code

Egy Claude Code munkameneten belül add hozzá a marketplace-t, és telepítsd a plugint:

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

Futtasd a /reload-plugins parancsot, ha a Claude Code a plugin aktiválását kéri. Hagyd jóvá a zaDojo bejelentkezést, majd írd be a /zadojo:seo-coach parancsot, hogy meggyőződj róla, a skillek betöltődtek. A Claude Code plugin útmutató a hatóköröket, a frissítéseket és a javításokat is tárgyalja.

Claude Cowork

A Coworkben a pluginokat menükön keresztül adod hozzá, így ezt a részt egy ügynök nem tudja elvégezni helyetted. Menj a Customize > Plugins > Add marketplace > Add from a repository menüpontra, add meg a https://github.com/zadojo/seo-geo-mcp címet, és telepítsd a zaDojót. Ehhez fizetős Claude-csomag kell. A Cowork lépések a Free csomag alternatíváját is elmagyarázzák.

Codex a ChatGPT asztali alkalmazásban

1. Nyisd meg a Codex részt, és indíts új chatet.
2. Illeszd be az erről az oldalról származó beállító promptot.
3. Hagyd jóvá a zaDojo bejelentkezést, amikor megjelenik.
4. Ha a Codex azt írja, hogy az eszközök még nincsenek betöltve, indíts még egy új chatet.

Kézi telepítéshez kövesd a Codex asztali lépéseket. Azt, hogy mely ChatGPT-csomagok tartalmazzák a Codexet, az OpenAI határozza meg, ezt az OpenAI csomagoldalán ellenőrizheted. A Codex-kapcsolat független a chatgpt.com-tól: egy szokásos ChatGPT-chat nem látja.

Codex CLI

Egy terminálból:

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

Ha a plugin nem jelenik meg, töltsd újra vagy indítsd újra a Codexet. Ezután jelentkezz be:

codex mcp login zadojo

Kérd meg a Codexet, hogy az SEO Coach segítségével ellenőrizze, minden működik-e. A Codex plugin útmutató felsorolja a lehetséges hibaüzeneteket. Ha egy asztali plugin-könyvtárból telepítettél, onnan kezeld a plugint.

Hermes

Illeszd be a beállító promptot az MCP szerver csatlakoztatásához. A skillek a Hermes skill hubjáról jönnek. Az SEO Coach hozzáadása:

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

Futtasd ugyanezt a parancsot más mappanévvel minden további zaDojo skillhez, amelyet szeretnél, például seo-audit vagy keyword-research. A Hermes nyilvántartja, honnan származik az egyes skill, így később ellenőrizni tudja a frissítéseket. Saját dokumentációja a Hermes skill management oldalon található.

Grok Bot

Illeszd be a beállító promptot a Botodba, és végezd el azokat a lépéseket, amelyeket visszaad neked. A csomagolt skillek és connectorok az oldalsáv Marketplace részében vannak. A privát skillek a Your plugins > Manage plugins and skills > Private skills alatt találhatók, és a fiókod minden Botja használhatja őket. Az xAI referenciáját a Grok Bot skills oldalon találod.

Claude web és más ügynökök

Csatlakoztasd a szervert az MCP beállítási útmutató szerint. Ezután add hozzá a skilleket azzal a skillkezelővel, amelyet az ügynököd támogat. A Claude-ban az egyéni skilleket a Customize > Skills alatt kezelheted. Fizetős Claude-csomagon a zaDojo plugin együtt adja hozzá a kapcsolatot és a skilleket.

A skills CLI-val működő ügynökök listából választhatnak zaDojo skilleket:

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

Válaszd ki az aktuális ügynöködet és a kívánt telepítési hatókört. Ne futtasd ezt a plugin mellé, mert a plugin már tartalmazza a skilleket. A további utakat a kézi skillbeállítás tárgyalja.

Ellenőrizd, hogy működik

Indíts új chatet, és küldd el:

Használd a zaDojót: ellenőrizd a kapcsolatot, és listázd a projektjeimet.

Egy működő beállítás zaDojo eszközöket hív, és visszaadja a fiókodat és a projektlistádat. Az üres lista is sikeres eredmény: azt jelenti, hogy még nem hoztál létre projektet. Ez az ellenőrzés csak adatot olvas, és nem használ kreditet.

Ezután ellenőrizd a skilleket. A Claude Code-ban írd be: /zadojo:, és keresd a tizenkét skill nevét. A Codexben írj be egy $ jelet. Más ügynököknél kérdezd meg: „Mely zaDojo skilleket látod?” Ha a kapcsolat működik, de egyetlen skill sincs, a beállítás csak félig kész.

Ha mindkét ellenőrzés sikeres, kérd meg az ügynöködet, hogy futtassa az SEO Coach skillt. Megnézi, hol tart a projekted, és javasol egy következő lépést.

A skillek frissítése

A skillek idővel fejlődnek, az ügynöködben lévő példányok pedig nem frissülnek maguktól. Az MCP-kapcsolat frissítése az eszközlistát frissíti, nem a skillfájlokat.

A ChatGPT felhasználói inkább a ChatGPT frissítési lépéseit kövessék. Egy egyéni ChatGPT-kapcsolatnak nincsenek frissíthető skillfájljai.

A legegyszerűbb, ha beilleszted ezt a promptot abba az ügynökbe, ahol a zaDojót használod. Kideríti, hogyan lettek telepítve a skillek, ugyanott frissíti őket, és megtartja a bejelentkezésedet és a skillfájlokon végzett saját módosításaidat.

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.

Az egyes telepítési módok kézi frissítési lépései következnek.

A Claude Code plugin frissítése

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

Ha nem akarod ezt kézzel csinálni, nyisd meg a /plugin parancsot, menj a Marketplaces részhez, válaszd a zadojo elemet, és kapcsold be az Enable auto-update lehetőséget. Az automatikus frissítés alapból ki van kapcsolva azoknál a marketplace-eknél, amelyeket nem az Anthropic üzemeltet. Amikor a Claude Code jelzi, hogy frissítés vár, futtasd a /reload-plugins parancsot. Az Anthropic a configure auto-updates oldalon dokumentálja a beállítást.

A Codex CLI plugin frissítése

codex plugin marketplace upgrade zadojo

Indítsd újra vagy töltsd újra a Codexet, ha az új skillverziók nem jelennek meg. A Codex pluginparancsai változtak a kiadások között, így ha ezt elutasítja, futtasd a codex plugin --help parancsot, hogy lásd, mit fogad el a verziód. Az OpenAI a plugin dokumentációjában írja le a marketplace-eket.

A Hermes hub skilljeinek frissítése

Kérdezd meg a Hermest, mely skillekhez van frissítés, majd név szerint frissítsd a zaDojo skilleket:

hermes skills check
hermes skills update seo-coach

Ismételd meg a frissítő sort minden telepített zaDojo skillhez. Ha helyben módosítottál egy skillt, a Hermes alapból nem nyúl hozzá. Előbb nézd át a módosításaidat. A --force kapcsolót csak akkor add hozzá, ha nem bánod, hogy elvesznek. A részletek a Hermes update lifecycle oldalon vannak.

A skills CLI-val telepített skillek frissítése

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

Írd be a ténylegesen telepített skillek nevét. Ugyanazt a hatókört használd, ahová telepítettél: -g a globális, -p a projektszintű skillekhez. Frissítés előtt ments egy másolatot a személyes módosításaidról. A telepítésed óta hozzáadott új skilleket az update nem veszi fel, ezért ezek kiválasztásához futtasd újra a telepítő parancsot. A teljes opciólistát a skills CLI dokumentációja tartalmazza.

A Grok Bot vagy a kézzel másolt skillek frissítése

A Grok Botnál illeszd be a frissítő promptot, vagy nyisd meg a Marketplace > Your plugins > Manage plugins and skills részt, és ott frissítsd a zaDojo bejegyzést. Az xAI nem ad ki külön frissítő parancsot a skillekhez, ezért a verziód által mutatott vezérlőket használd.

Ha kézzel másoltad a skillmappákat, hasonlítsd össze őket a jelenlegi skillmappákkal. Minden mappát egészében cserélj le, a SKILL.md melletti fájlokkal együtt, és vidd át a saját módosításaidat. A Claude Customize > Skills részében feltöltött skilleket ugyanott cseréled le.

Ha végeztél, töltsd újra a skilleket, vagy nyiss új munkamenetet, majd kérd meg az ügynököt, hogy erősítse meg, látja-e a frissített zaDojo skilleket.

Hibaelhárítás

Minden más esetben írj a hello@zadojo.com címre az ügynököd nevével és verziójával, a sikertelen lépéssel és a pontos hibaszöveggel. Soha ne küldj jelszót, API-kulcsot vagy bejelentkezési kódot.

Mi használ kreditet

A beállítás, a bejelentkezés, a kapcsolat ellenőrzése és a skillek frissítése semmibe sem kerül. Az SEO Coach is ingyenes, hacsak nem kéred, hogy kutatást futtasson. Kredit csak akkor fogy, amikor az ügynököd fizetős adatot kér le, és 1000 kredit 1 €. Néhány jellemző ár:

• Egy kulcsszókutatási keresés: kb. 0,07 €.
• Egy domain- vagy backlink-áttekintés egyéves előzménnyel: kb. 0,10 €.
• Prompt Research egy kulcsszóra: kb. 0,25 €.

A Search Console és a Google Analytics olvasása, a projektkontextus, a mentett kulcsszavak, a riportok és az egyszerű oldalauditok ingyenesek. A csomag havi 10 €, és minden hónapban 10 € felhasználást tartalmaz. A teljes listát és egy költségbecslőt az árak oldalon találod.