Configurarea agentului AI pentru zaDojo

Un agent AI are nevoie de două piese de la zaDojo. Conexiunea MCP îi permite să apeleze uneltele zaDojo pentru date SEO în timp real, la https://app.zadojo.com/mcp. Skill-urile sunt fișiere SKILL.md care îi spun cum să ducă la capăt o sarcină, precum un audit sau o cercetare de cuvinte cheie. Cel mai rapid le obții pe amândouă dacă lipești promptul de configurare de mai jos în agent și îl lași pe el să facă instalarea.

Folosești ChatGPT? Mergi în schimb la ghidul ChatGPT. Un chat ChatGPT obișnuit nu poate instala nimic, așa că promptul doar îl face să afișeze pașii manuali. Conexiunea personalizată funcționează atât pe ChatGPT Free, cât și pe planurile plătite.

De ce ai nevoie

• Un cont zaDojo. Înregistrează-te și primești 0,10 € credite de probă, fără card, sau creează contul când configurarea deschide pagina de autentificare.
• Un agent care se poate conecta la un server MCP la distanță: Claude Code, Claude Cowork, Codex (CLI sau aplicația desktop ChatGPT), Hermes, Grok Bot, Cursor și clienți similari.
• Un browser în care să aprobi autentificarea zaDojo. Pentru un agent fără browser, folosește în schimb o cheie API.

Configurează-ți agentul

1. Copiază promptul de mai jos. Îl poți copia și din Agent setup în aplicația zaDojo sau îi poți indica agentului versiunea text de la https://zadojo.com/agent-setup.txt.
2. Lipește-l într-un chat sau o sesiune nouă în agentul tău.
3. Agentul își dă seama ce client este, verifică dacă există deja o conexiune zaDojo și instalează pluginul acolo unde există unul. Unde nu există plugin, adaugă separat serverul MCP și skill-urile publice.
4. Când browserul deschide autentificarea zaDojo, conectează-te și aprobă accesul.
5. Dacă agentul îți cere să reîncarci, să repornești sau să apeși ceva la care el nu ajunge, fă acel pas. Îți spune exact ce ai de făcut.

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.

Agentul încheie cu un scurt mesaj de stare și câteva prime sarcini propuse. Nu creează proiecte și nu rulează cercetări plătite în timpul configurării.

Configurare manuală pe agent

Sari peste această secțiune dacă promptul a terminat deja instalarea. Fiecare bloc de mai jos face același lucru manual.

Claude Code

Într-o sesiune Claude Code, adaugă marketplace-ul și instalează pluginul:

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

Rulează /reload-plugins dacă Claude Code îți cere să activezi pluginul. Aprobă autentificarea zaDojo, apoi tastează /zadojo:seo-coach ca să confirmi că s-au încărcat skill-urile. Ghidul pluginului Claude Code acoperă scopurile, actualizările și remedierile.

Claude Cowork

În Cowork, pluginurile se adaugă din meniuri, așa că un agent nu poate face această parte în locul tău. Mergi la Customize > Plugins > Add marketplace > Add from a repository, introdu https://github.com/zadojo/seo-geo-mcp și instalează zaDojo. Ai nevoie de un plan Claude plătit. Pașii pentru Cowork explică alternativa pentru planul Free.

Codex în aplicația desktop ChatGPT

1. Deschide Codex și pornește un chat nou.
2. Lipește promptul de configurare de pe această pagină.
3. Aprobă autentificarea zaDojo când apare.
4. Dacă Codex spune că uneltele nu sunt încă încărcate, pornește încă un chat nou.

Ca să instalezi manual, urmează pașii pentru Codex desktop. Ce planuri ChatGPT includ Codex stabilește OpenAI, așa că verifică pagina de planuri OpenAI. O conexiune Codex e separată de chatgpt.com: un chat ChatGPT obișnuit nu o va vedea.

Codex CLI

Dintr-un terminal:

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

Dacă pluginul nu apare, reîncarcă sau repornește Codex. Apoi autentifică-te:

codex mcp login zadojo

Cere-i lui Codex să folosească SEO Coach ca să verifice că totul merge. Ghidul pluginului Codex listează mesajele de eroare pe care le-ai putea vedea. Dacă ai instalat dintr-un director de pluginuri desktop, gestionează pluginul din acel director.

Hermes

Lipește promptul de configurare ca să conectezi serverul MCP. Skill-urile vin din hub-ul de skill-uri Hermes. Ca să adaugi SEO Coach:

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

Rulează aceeași comandă cu alt nume de folder pentru fiecare skill zaDojo în plus pe care îl vrei, de exemplu seo-audit sau keyword-research. Hermes reține de unde vine fiecare skill, ca să poată verifica ulterior actualizările. Documentația lui e în Hermes skill management.

Grok Bot

Lipește promptul de configurare în Bot și fă pașii pe care ți-i trimite înapoi. Skill-urile și conectorii împachetați sunt în Marketplace, în bara laterală. Skill-urile private sunt în Your plugins > Manage plugins and skills > Private skills, iar orice Bot din contul tău le poate folosi. Vezi Grok Bot skills pentru referința xAI.

Claude web și alți agenți

Conectează serverul cu ghidul de configurare MCP. Apoi adaugă skill-urile cu managerul de skill-uri pe care îl suportă agentul tău. În Claude, skill-urile personalizate se gestionează în Customize > Skills. Pe un plan Claude plătit, pluginul zaDojo adaugă împreună conexiunea și skill-urile.

Agenții compatibili cu CLI-ul skills pot alege skill-urile zaDojo dintr-o listă:

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

Alege agentul curent și scopul de instalare pe care îl preferi. Nu rula asta peste plugin, pentru că pluginul conține deja skill-urile. Celelalte căi sunt descrise în configurarea manuală a skill-urilor.

Verifică dacă a funcționat

Pornește un chat nou și trimite:

Folosește zaDojo ca să-mi verifici conexiunea și să-mi listezi proiectele.

O configurare funcțională apelează uneltele zaDojo și îți returnează contul și lista de proiecte. O listă goală e tot un succes: înseamnă că nu ai creat încă un proiect. Această verificare doar citește date și nu consumă credite.

Apoi verifică skill-urile. În Claude Code, tastează /zadojo: și caută cele douăsprezece nume de skill-uri. În Codex, tastează $. În alți agenți, întreabă „Ce skill-uri zaDojo vezi?" O conexiune care merge fără skill-uri e configurată doar pe jumătate.

Dacă ambele verificări trec, cere-i agentului să ruleze SEO Coach. Se uită la stadiul proiectului tău și recomandă un singur pas următor.

Actualizează skill-urile

Skill-urile se îmbunătățesc în timp, iar copiile din agentul tău nu se actualizează singure. Reîmprospătarea conexiunii MCP actualizează lista de unelte, nu fișierele skill-urilor.

Utilizatorii ChatGPT ar trebui să urmeze în schimb pașii de actualizare pentru ChatGPT. O conexiune ChatGPT personalizată nu are fișiere de skill de actualizat.

Cel mai simplu e să lipești acest prompt în agentul în care folosești zaDojo. Află cum au fost instalate skill-urile, le actualizează în același loc și îți păstrează autentificarea și orice modificări ai făcut în fișierele skill-urilor.

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.

Urmează pașii de actualizare manuală pentru fiecare metodă de instalare.

Actualizează pluginul Claude Code

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

Ca să nu mai faci asta manual, deschide /plugin, mergi la Marketplaces, selectează zadojo și alege Enable auto-update. Actualizarea automată e oprită implicit pentru marketplace-urile care nu sunt administrate de Anthropic. Când Claude Code îți spune că te așteaptă o actualizare, rulează /reload-plugins. Anthropic descrie setarea în configure auto-updates.

Actualizează pluginul Codex CLI

codex plugin marketplace upgrade zadojo

Repornește sau reîncarcă Codex dacă noile versiuni ale skill-urilor nu apar. Comenzile de plugin Codex s-au schimbat între versiuni, așa că, dacă aceasta e respinsă, rulează codex plugin --help ca să vezi ce acceptă versiunea ta. OpenAI descrie marketplace-urile în documentația pentru pluginuri.

Actualizează skill-urile din hub-ul Hermes

Întreabă Hermes ce skill-uri au actualizări, apoi actualizează-le după nume pe cele zaDojo:

hermes skills check
hermes skills update seo-coach

Repetă linia de actualizare pentru fiecare skill zaDojo instalat. Dacă ai modificat local un skill, Hermes îl lasă implicit neatins. Citește-ți întâi modificările. Adaugă --force doar dacă accepți să le pierzi. Detaliile sunt în Hermes update lifecycle.

Actualizează skill-urile instalate cu CLI-ul skills

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

Pune numele skill-urilor pe care le-ai instalat de fapt. Folosește același scop în care ai instalat: -g pentru skill-uri globale sau -p pentru skill-uri de proiect. Salvează o copie a modificărilor personale înainte de actualizare. Skill-urile noi apărute după instalare nu sunt preluate de update, așa că rulează din nou comanda de instalare ca să le selectezi. Documentația CLI-ului skills are lista completă de opțiuni.

Actualizează Grok Bot sau skill-urile copiate manual

Pentru Grok Bot, lipește promptul de actualizare sau deschide Marketplace > Your plugins > Manage plugins and skills și actualizează de acolo intrarea zaDojo. xAI nu publică o comandă separată de actualizare pentru skill-uri, așa că folosește controalele afișate de versiunea ta.

Dacă ai copiat manual folderele skill-urilor, compară-le cu folderele actuale. Înlocuiește fiecare folder în întregime, inclusiv fișierele de lângă SKILL.md, și păstrează-ți modificările proprii. Skill-urile încărcate prin Customize > Skills din Claude se înlocuiesc în același loc.

La final, reîncarcă skill-urile sau deschide o sesiune nouă, apoi cere-i agentului să confirme că vede skill-urile zaDojo actualizate.

Depanare

Pentru orice altceva, scrie la hello@zadojo.com cu numele și versiunea agentului, pasul care a eșuat și textul exact al erorii. Nu trimite niciodată parole, chei API sau coduri de autentificare.

Ce consumă credite

Configurarea, autentificarea, verificarea conexiunii și actualizările de skill-uri nu costă nimic. Și SEO Coach e gratuit, dacă nu îi ceri să facă cercetare. Creditele se consumă doar când agentul aduce date plătite, iar 1.000 de credite înseamnă 1 €. Câteva prețuri obișnuite:

• O căutare de cuvinte cheie: cam 0,07 €.
• O privire de ansamblu asupra unui domeniu sau a backlinkurilor, cu un an de istoric: cam 0,10 €.
• Prompt Research pentru un cuvânt cheie: cam 0,25 €.

Citirile din Search Console și Google Analytics, contextul proiectului, cuvintele cheie salvate, rapoartele și auditurile simple de site sunt gratuite. Planul costă 10 € pe lună și include 10 € de utilizare în fiecare lună. Vezi prețurile pentru lista completă și un calculator de costuri.