Nastavitev AI agenta: zaDojo in veščine

AI agent od zaDojo potrebuje dva dela. Povezava MCP mu omogoča klicanje orodij zaDojo za podatke SEO v živo na https://app.zadojo.com/mcp. Veščine so datoteke SKILL.md, ki mu povedo, kako nalogo, kot je revizija ali raziskava ključnih besed, izpeljati od začetka do konca. Najhitreje dobiš oboje tako, da spodnji poziv za nastavitev prilepiš agentu in mu prepustiš namestitev.

Uporabljaš ChatGPT? Pojdi raje na vodnik za ChatGPT. Navaden klepet v ChatGPT ne more ničesar namestiti, zato bi poziv samo izpisal ročne korake. Povezava po meri deluje na ChatGPT Free in na plačljivih paketih.

Kaj potrebuješ

• Račun zaDojo. Registriraj se in dobiš 0,10 € poskusnih kreditov brez kartice ali pa račun ustvari, ko postopek nastavitve odpre stran za prijavo.
• Agenta, ki se lahko poveže z oddaljenim strežnikom MCP: Claude Code, Claude Cowork, Codex (CLI ali namizna aplikacija ChatGPT), Hermes, Grok Bot, Cursor in podobni odjemalci.
• Brskalnik, kjer lahko odobriš prijavo v zaDojo. Za agenta brez brskalnika uporabi ključ API.

Nastavi svojega agenta

1. Kopiraj spodnji poziv. Kopiraš ga lahko tudi iz Agent setup v aplikaciji zaDojo ali agenta usmeriš na različico v navadnem besedilu na https://zadojo.com/agent-setup.txt.
2. Prilepi ga v nov klepet ali sejo svojega agenta.
3. Agent ugotovi, kateri odjemalec je, preveri, ali povezava z zaDojo že obstaja, in namesti vtičnik, kjer ta obstaja. Kjer vtičnika ni, ločeno doda strežnik MCP in javne veščine.
4. Ko brskalnik odpre prijavo v zaDojo, se prijavi in odobri dostop.
5. Če te agent prosi, da znova naložiš, znova zaženeš ali klikneš nekaj, česar sam ne doseže, opravi ta korak. Natančno ti pove, kaj narediti.

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.

Agent konča s kratkim sporočilom o stanju in nekaj predlogi prvih nalog. Med nastavitvijo ne ustvarja projektov in ne izvaja plačljivih raziskav.

Ročna nastavitev po agentih

Ta razdelek preskoči, če je poziv namestitev že dokončal. Vsak spodnji blok isto nalogo opravi ročno.

Claude Code

V seji Claude Code dodaj tržnico in namesti vtičnik:

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

Zaženi /reload-plugins, če te Claude Code prosi za aktivacijo vtičnika. Odobri prijavo v zaDojo, nato vpiši /zadojo:seo-coach in preveri, ali so se veščine naložile. Vodnik za vtičnik Claude Code pokriva obsege, posodobitve in popravke.

Claude Cowork

Vtičniki v Cowork se dodajajo prek menijev, zato tega dela agent ne more opraviti namesto tebe. Pojdi na Customize > Plugins > Add marketplace > Add from a repository, vnesi https://github.com/zadojo/seo-geo-mcp in namesti zaDojo. Za to potrebuješ plačljiv paket Claude. Koraki za Cowork razložijo alternativo za paket Free.

Codex v namizni aplikaciji ChatGPT

1. Odpri Codex in začni nov klepet.
2. Prilepi poziv za nastavitev s te strani.
3. Ko se prikaže prijava v zaDojo, jo odobri.
4. Če Codex javi, da orodja še niso naložena, začni še en nov klepet.

Za ročno namestitev sledi korakom za namizni Codex. Katere pakete ChatGPT vključujejo Codex, določa OpenAI, zato preveri stran s paketi OpenAI. Povezava v Codexu je ločena od chatgpt.com: navaden klepet v ChatGPT je ne vidi.

Codex CLI

V terminalu:

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

Če se vtičnik ne prikaže, znova naloži ali zaženi Codex. Nato se prijavi:

codex mcp login zadojo

Prosi Codex, naj s SEO Coach preveri, ali vse deluje. Vodnik za vtičnik Codex navaja sporočila o napakah, ki jih lahko vidiš. Če si namestil prek imenika vtičnikov v namizni aplikaciji, vtičnik upravljaj iz tega imenika.

Hermes

Prilepi poziv za nastavitev, da povežeš strežnik MCP. Veščine prihajajo iz središča veščin Hermes. Za dodajanje SEO Coach:

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

Isti ukaz z drugim imenom mape zaženi za vsako dodatno veščino zaDojo, ki jo želiš, na primer seo-audit ali keyword-research. Hermes beleži, od kod je prišla vsaka veščina, da lahko pozneje preveri posodobitve. Njegova dokumentacija je v Hermes skill management.

Grok Bot

Poziv za nastavitev prilepi v svojega Bota in opravi korake, ki ti jih vrne. Zapakirane veščine in konektorji so pod Marketplace v stranski vrstici. Zasebne veščine so pod Your plugins > Manage plugins and skills > Private skills in jih lahko uporablja vsak Bot v tvojem računu. Referenco xAI najdeš v Grok Bot skills.

Claude na spletu in drugi agenti

Strežnik poveži po vodniku za nastavitev MCP. Nato veščine dodaj s katerim koli upraviteljem veščin, ki ga agent podpira. V Claudu se veščine po meri upravljajo pod Customize > Skills. Na plačljivem paketu Claude vtičnik zaDojo doda povezavo in veščine skupaj.

Agenti, ki delujejo s CLI skills, lahko veščine zaDojo izberejo s seznama:

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

Izberi trenutnega agenta in želeni obseg namestitve. Tega ne zaganjaj poleg vtičnika, ker vtičnik veščine že prinaša. Druge poti so opisane v ročni nastavitvi veščin.

Preveri, ali deluje

Začni nov klepet in pošlji:

Uporabi zaDojo, da preveriš mojo povezavo in izpišeš moje projekte.

Delujoča nastavitev pokliče orodja zaDojo in vrne tvoj račun in seznam projektov. Tudi prazen seznam je uspeh: pomeni, da projekta še nisi ustvaril. To preverjanje samo bere podatke in ne porabi kreditov.

Nato preveri veščine. V Claude Code vpiši /zadojo: in poišči dvanajst imen veščin. V Codexu vpiši $. V drugih agentih vprašaj "Katere veščine zaDojo vidiš?" Povezava, ki deluje brez veščin, je nastavljena le na pol.

Če obe preverjanji uspeta, prosi agenta, naj zažene SEO Coach. Pogleda, kje je tvoj projekt, in priporoči en naslednji korak.

Posodobi svoje veščine

Veščine se sčasoma izboljšujejo, kopije v tvojem agentu pa se ne posodobijo same. Osvežitev povezave MCP posodobi seznam orodij, ne datotek veščin.

Uporabniki ChatGPT naj sledijo korakom za posodobitev v ChatGPT. Povezava po meri v ChatGPT nima datotek veščin, ki bi jih bilo treba posodobiti.

Najlažje je, da ta poziv prilepiš agentu, v katerem uporabljaš zaDojo. Ugotovi, kako so bile veščine nameščene, jih posodobi na istem mestu in ohrani tvojo prijavo ter vse spremembe, ki si jih naredil v datotekah veščin.

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.

Sledijo ročni koraki posodobitve za vsak način namestitve.

Posodobi vtičnik za Claude Code

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

Če tega ne želiš več delati ročno, odpri /plugin, pojdi na Marketplaces, izberi zadojo in izberi Enable auto-update. Samodejno posodabljanje je za tržnice, ki jih ne upravlja Anthropic, privzeto izklopljeno. Ko ti Claude Code sporoči, da čaka posodobitev, zaženi /reload-plugins. Anthropic nastavitev opisuje v configure auto-updates.

Posodobi vtičnik za Codex CLI

codex plugin marketplace upgrade zadojo

Če se nove različice veščin ne prikažejo, znova zaženi ali naloži Codex. Ukazi vtičnikov Codex so se med izdajami spreminjali, zato če je ta zavrnjen, zaženi codex plugin --help, da vidiš, kaj sprejme tvoja različica. OpenAI tržnice opisuje v svoji dokumentaciji za vtičnike.

Posodobi veščine iz središča Hermes

Vprašaj Hermes, katere veščine imajo posodobitve, nato veščine zaDojo posodobi po imenu:

hermes skills check
hermes skills update seo-coach

Vrstico za posodobitev ponovi za vsako nameščeno veščino zaDojo. Če si veščino lokalno uredil, je Hermes privzeto ne spremeni. Najprej preberi svoje spremembe. --force dodaj samo, če jih lahko izgubiš. Podrobnosti so v Hermes update lifecycle.

Posodobi veščine, nameščene s skills CLI

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

Vstavi imena veščin, ki si jih dejansko namestil. Uporabi isti obseg kot pri namestitvi: -g za globalne veščine ali -p za projektne. Pred posodobitvijo shrani kopijo osebnih sprememb. Novih veščin, dodanih po tvoji namestitvi, update ne zajame, zato za njihovo izbiro znova zaženi ukaz za namestitev. Dokumentacija skills CLI ima celoten seznam možnosti.

Posodobi Grok Bot ali ročno kopirane veščine

Za Grok Bot prilepi poziv za posodobitev ali odpri Marketplace > Your plugins > Manage plugins and skills in tam posodobi vnos zaDojo. xAI ne objavlja ločenega ukaza za posodobitev veščin, zato uporabi kontrolnike, ki jih prikaže tvoja različica.

Če si mape veščin kopiral ročno, jih primerjaj s trenutnimi mapami veščin. Vsako mapo zamenjaj v celoti, vključno z datotekami poleg SKILL.md, in prenesi svoje spremembe. Veščine, naložene prek Claudovega Customize > Skills, zamenjaš na istem mestu.

Ko končaš, znova naloži veščine ali odpri novo sejo, nato prosi agenta, naj potrdi, da vidi posodobljene veščine zaDojo.

Odpravljanje težav

Za vse drugo piši na hello@zadojo.com z imenom in različico agenta, korakom, ki ni uspel, in natančnim besedilom napake. Nikoli ne pošiljaj gesel, ključev API ali kod za prijavo.

Kaj porabi kredite

Nastavitev, prijava, preverjanje povezave in posodobitve veščin ne stanejo nič. Tudi SEO Coach je brezplačen, razen če ga prosiš za raziskavo. Krediti se porabijo samo, ko agent pridobiva plačljive podatke, 1.000 kreditov pa je 1 €. Nekaj običajnih cen:

• Iskanje pri raziskavi ključnih besed: približno 0,07 €.
• Pregled domene ali povratnih povezav z enoletno zgodovino: približno 0,10 €.
• Prompt Research za eno ključno besedo: približno 0,25 €.

Branje Search Console in Google Analytics, kontekst projekta, shranjene ključne besede, poročila in navadne revizije spletnega mesta so brezplačni. Paket stane 10 € na mesec in vsak mesec vključuje 10 € porabe. Celoten seznam in kalkulator stroškov najdeš v cenah.