Konfiguracja agenta AI: zaDojo i skille

Agent AI potrzebuje od zaDojo dwóch rzeczy. Połączenie MCP pozwala mu wywoływać narzędzia zaDojo z danymi SEO na żywo pod adresem https://app.zadojo.com/mcp. Skille to pliki SKILL.md, które mówią mu, jak przeprowadzić zadanie, takie jak audyt czy badanie słów kluczowych, od początku do końca. Najszybciej zdobędziesz oba elementy, wklejając poniższy prompt konfiguracyjny do agenta i pozwalając mu przeprowadzić instalację.

Korzystasz z ChatGPT? Przejdź do przewodnika po ChatGPT. Zwykły czat ChatGPT nie może niczego zainstalować, więc prompt jedynie wypisze kroki do wykonania ręcznie. Własne połączenie działa zarówno w ChatGPT Free, jak i w płatnych planach.

Czego potrzebujesz

• Konta zaDojo. Zarejestruj się, aby dostać 0,10 € kredytów próbnych bez podawania karty, albo załóż konto, gdy proces konfiguracji otworzy stronę logowania.
• Agenta, który potrafi połączyć się ze zdalnym serwerem MCP: Claude Code, Claude Cowork, Codex (CLI lub aplikacja desktopowa ChatGPT), Hermes, Grok Bot, Cursor i podobne klienty.
• Przeglądarki, w której zatwierdzisz logowanie do zaDojo. Dla agenta bez przeglądarki (headless) użyj zamiast tego klucza API.

Skonfiguruj swojego agenta

1. Skopiuj poniższy prompt. Możesz go też skopiować z Agent setup w aplikacji zaDojo albo wskazać agentowi wersję tekstową pod adresem https://zadojo.com/agent-setup.txt.
2. Wklej go do nowego czatu lub sesji w swoim agencie.
3. Agent ustala, jakim jest klientem, sprawdza, czy połączenie z zaDojo już istnieje, i instaluje wtyczkę tam, gdzie jest dostępna. Tam, gdzie wtyczki nie ma, dodaje osobno serwer MCP i publiczne skille.
4. Gdy przeglądarka otworzy logowanie do zaDojo, zaloguj się i zatwierdź dostęp.
5. Jeśli agent poprosi o przeładowanie, restart lub kliknięcie czegoś, do czego sam nie ma dostępu, wykonaj ten krok. Agent dokładnie powie, co zrobić.

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.

Na koniec agent wyświetla krótki komunikat o stanie i kilka propozycji pierwszych zadań. Podczas konfiguracji nie tworzy projektów i nie uruchamia płatnych analiz.

Ręczna konfiguracja według agenta

Pomiń tę sekcję, jeśli prompt już zakończył instalację. Każdy blok poniżej robi to samo ręcznie.

Claude Code

W sesji Claude Code dodaj marketplace i zainstaluj wtyczkę:

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

Uruchom /reload-plugins, jeśli Claude Code poprosi o aktywację wtyczki. Zatwierdź logowanie do zaDojo, a potem wpisz /zadojo:seo-coach, aby sprawdzić, czy skille się wczytały. Przewodnik po wtyczce Claude Code opisuje zakresy instalacji, aktualizacje i rozwiązywanie problemów.

Claude Cowork

Wtyczki w Cowork dodaje się przez menu, więc tej części agent nie zrobi za Ciebie. Przejdź do Customize > Plugins > Add marketplace > Add from a repository, wpisz https://github.com/zadojo/seo-geo-mcp i zainstaluj zaDojo. Wymaga to płatnego planu Claude. Kroki dla Cowork opisują alternatywę dla planu Free.

Codex w aplikacji desktopowej ChatGPT

1. Otwórz Codex i rozpocznij nowy czat.
2. Wklej prompt konfiguracyjny z tej strony.
3. Zatwierdź logowanie do zaDojo, gdy się pojawi.
4. Jeśli Codex napisze, że narzędzia nie są jeszcze wczytane, rozpocznij kolejny nowy czat.

Aby zainstalować ręcznie, wykonaj kroki dla Codex desktop. O tym, które plany ChatGPT obejmują Codex, decyduje OpenAI, więc sprawdź stronę planów OpenAI. Połączenie w Codex jest oddzielne od chatgpt.com: zwykły czat ChatGPT go nie zobaczy.

Codex CLI

W terminalu:

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

Jeśli wtyczka się nie pojawi, przeładuj lub uruchom ponownie Codex. Następnie zaloguj się:

codex mcp login zadojo

Poproś Codex, aby użył SEO Coach do sprawdzenia, czy wszystko działa. Przewodnik po wtyczce Codex wymienia komunikaty błędów, które możesz zobaczyć. Jeśli instalowałeś przez katalog wtyczek w aplikacji desktopowej, zarządzaj wtyczką z tego katalogu.

Hermes

Wklej prompt konfiguracyjny, aby podłączyć serwer MCP. Skille pochodzą z huba skilli Hermes. Aby dodać SEO Coach:

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

Uruchom to samo polecenie z inną nazwą folderu dla każdego dodatkowego skilla zaDojo, którego chcesz, na przykład seo-audit lub keyword-research. Hermes zapisuje, skąd pochodzi każdy skill, więc może później sprawdzać aktualizacje. Jego własna dokumentacja znajduje się w zarządzaniu skillami Hermes.

Grok Bot

Wklej prompt konfiguracyjny do swojego Bota i wykonaj kroki, które Ci zwróci. Spakowane skille i konektory znajdziesz w Marketplace na pasku bocznym. Prywatne skille są w Your plugins > Manage plugins and skills > Private skills i może z nich korzystać każdy Bot na Twoim koncie. Dokumentację xAI znajdziesz w Grok Bot skills.

Claude w przeglądarce i inni agenci

Podłącz serwer według przewodnika konfiguracji MCP. Potem dodaj skille za pomocą menedżera skilli, który obsługuje Twój agent. W Claude własnymi skillami zarządza się w Customize > Skills. W płatnym planie Claude wtyczka zaDojo dodaje połączenie i skille za jednym razem.

Agenci, którzy współpracują z CLI skills, mogą wybrać skille zaDojo z listy:

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

Wybierz bieżącego agenta i preferowany zakres instalacji. Nie uruchamiaj tego obok wtyczki, bo wtyczka już zawiera skille. Inne sposoby opisuje ręczna konfiguracja skilli.

Sprawdź, czy działa

Rozpocznij nowy czat i wyślij:

Użyj zaDojo, aby sprawdzić moje połączenie i wypisać moje projekty.

Działająca konfiguracja wywołuje narzędzia zaDojo i zwraca Twoje konto oraz listę projektów. Pusta lista to też sukces: oznacza, że nie utworzyłeś jeszcze projektu. Ten test tylko odczytuje dane i nie zużywa kredytów.

Następnie sprawdź skille. W Claude Code wpisz /zadojo: i poszukaj dwunastu nazw skilli. W Codex wpisz $. W innych agentach zapytaj: „Które skille zaDojo widzisz?”. Połączenie, które działa bez skilli, to konfiguracja tylko w połowie.

Jeśli oba testy przejdą, poproś agenta o uruchomienie SEO Coach. Sprawdzi, na jakim etapie jest Twój projekt, i zaproponuje jeden kolejny krok.

Aktualizuj skille

Skille z czasem się poprawiają, a kopie w Twoim agencie nie aktualizują się same. Odświeżenie połączenia MCP aktualizuje listę narzędzi, ale nie pliki skilli.

Użytkownicy ChatGPT powinni zamiast tego wykonać kroki aktualizacji w ChatGPT. Własne połączenie w ChatGPT nie ma plików skilli do aktualizacji.

Najprościej wkleić ten prompt do agenta, w którym korzystasz z zaDojo. Agent sprawdzi, jak zainstalowano skille, zaktualizuje je w tym samym miejscu i zachowa Twoje logowanie oraz zmiany, które wprowadziłeś w plikach skilli.

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.

Poniżej znajdziesz ręczne kroki aktualizacji dla każdej metody instalacji.

Aktualizacja wtyczki Claude Code

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

Aby nie robić tego ręcznie, otwórz /plugin, przejdź do Marketplaces, wybierz zadojo i kliknij Enable auto-update. Automatyczna aktualizacja jest domyślnie wyłączona dla marketplace'ów, których nie prowadzi Anthropic. Gdy Claude Code poinformuje, że czeka aktualizacja, uruchom /reload-plugins. Anthropic opisuje to ustawienie w configure auto-updates.

Aktualizacja wtyczki Codex CLI

codex plugin marketplace upgrade zadojo

Uruchom ponownie lub przeładuj Codex, jeśli nowe wersje skilli się nie pojawią. Polecenia wtyczek Codex zmieniały się między wydaniami, więc jeśli to zostanie odrzucone, uruchom codex plugin --help, aby zobaczyć, co akceptuje Twoja wersja. OpenAI opisuje marketplace'y w swojej dokumentacji wtyczek.

Aktualizacja skilli z huba Hermes

Zapytaj Hermes, które skille mają aktualizacje, a potem zaktualizuj skille zaDojo po nazwie:

hermes skills check
hermes skills update seo-coach

Powtórz linię aktualizacji dla każdego zainstalowanego skilla zaDojo. Jeśli edytowałeś skill lokalnie, Hermes domyślnie go nie rusza. Najpierw przejrzyj swoje zmiany. Dodaj --force tylko wtedy, gdy możesz je stracić. Szczegóły znajdziesz w cyklu aktualizacji Hermes.

Aktualizacja skilli zainstalowanych przez CLI skills

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

Wstaw nazwy skilli, które faktycznie zainstalowałeś. Użyj tego samego zakresu, co przy instalacji: -g dla skilli globalnych lub -p dla skilli projektu. Przed aktualizacją zapisz kopię swoich zmian. Polecenie update nie pobiera skilli dodanych po Twojej instalacji, więc uruchom ponownie polecenie instalacji, aby je wybrać. Pełną listę opcji znajdziesz w dokumentacji CLI skills.

Aktualizacja Grok Bot lub skilli skopiowanych ręcznie

W Grok Bot wklej prompt aktualizacji albo otwórz Marketplace > Your plugins > Manage plugins and skills i zaktualizuj tam wpis zaDojo. xAI nie publikuje osobnego polecenia aktualizacji skilli, więc korzystaj z opcji, które pokazuje Twoja wersja.

Jeśli kopiowałeś foldery skilli ręcznie, porównaj je z aktualnymi folderami skilli. Zastąp każdy folder w całości, łącznie z plikami obok SKILL.md, i przenieś swoje zmiany. Skille wgrane przez Customize > Skills w Claude zastępuje się w tym samym miejscu.

Na koniec przeładuj skille lub otwórz nową sesję, a potem poproś agenta o potwierdzenie, że widzi zaktualizowane skille zaDojo.

Rozwiązywanie problemów

W innych sprawach napisz na hello@zadojo.com, podając nazwę i wersję agenta, krok, który się nie udał, oraz dokładną treść błędu. Nigdy nie wysyłaj haseł, kluczy API ani kodów logowania.

Co zużywa kredyty

Konfiguracja, logowanie, test połączenia i aktualizacje skilli są bezpłatne. SEO Coach też nic nie kosztuje, chyba że poprosisz go o przeprowadzenie analizy. Kredyty schodzą tylko wtedy, gdy agent pobiera płatne dane, a 1000 kredytów to 1 €. Kilka typowych cen:

• Jedno wyszukiwanie w badaniu słów kluczowych: około 0,07 €.
• Przegląd domeny lub backlinków z rocznym okresem historii: około 0,10 €.
• Prompt Research dla jednego słowa kluczowego: około 0,25 €.

Odczyty z Search Console i Google Analytics, kontekst projektu, zapisane słowa kluczowe, raporty i zwykłe audyty strony są bezpłatne. Plan kosztuje 10 € miesięcznie i co miesiąc obejmuje 10 € na korzystanie. Pełną listę i kalkulator kosztów znajdziesz w cenniku.