Налаштування AI-агента: zaDojo і скіли

AI-агентові потрібні дві частини від zaDojo. MCP-підключення дає йому викликати інструменти zaDojo для живих SEO-даних за адресою https://app.zadojo.com/mcp. Скіли це файли SKILL.md, які пояснюють, як виконати задачу, наприклад аудит чи дослідження ключових слів, від початку до кінця. Найшвидше отримати обидві частини так: встав промпт для налаштування нижче у свого агента й дозволь йому все встановити.

Користуєшся ChatGPT? Тоді переходь до інструкції для ChatGPT. Звичайний чат ChatGPT нічого не може встановити, тож промпт змусить його лише вивести ручні кроки. Власне підключення працює і на ChatGPT Free, і на платних тарифах.

Що потрібно

• Акаунт zaDojo. Зареєструйся й отримай 0,10 € пробних кредитів без картки або створи акаунт, коли налаштування відкриє сторінку входу.
• Агент, що вміє підключатися до віддаленого MCP-сервера: Claude Code, Claude Cowork, Codex (CLI або десктопний застосунок ChatGPT), Hermes, Grok Bot, Cursor і подібні клієнти.
• Браузер, де можна підтвердити вхід у zaDojo. Для агента без браузера використовуй API-ключ.

Налаштуй свого агента

1. Скопіюй промпт нижче. Його також можна скопіювати на сторінці Agent setup у застосунку zaDojo або вказати агентові на текстову версію за адресою https://zadojo.com/agent-setup.txt.
2. Встав його в новий чат чи сесію свого агента.
3. Агент визначить, який він клієнт, перевірить наявне підключення zaDojo й встановить плагін, якщо він є. Якщо плагіна немає, агент окремо додасть MCP-сервер і публічні скіли.
4. Коли браузер відкриє вхід у zaDojo, увійди й підтвердь доступ.
5. Якщо агент попросить перезавантажити, перезапустити чи натиснути щось, до чого він не має доступу, зроби це. Він точно скаже, що робити.

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.

Агент закінчить коротким повідомленням про стан і кількома пропозиціями перших задач. Під час налаштування він не створює проєктів і не запускає платних досліджень.

Ручне налаштування для кожного агента

Пропусти цей розділ, якщо промпт уже завершив встановлення. Кожен блок нижче робить те саме вручну.

Claude Code

У сесії Claude Code додай маркетплейс і встанови плагін:

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

Виконай /reload-plugins, якщо Claude Code просить активувати плагін. Підтвердь вхід у zaDojo, потім введи /zadojo:seo-coach, щоб переконатися, що скіли завантажилися. Посібник із плагіна для Claude Code описує області встановлення, оновлення й виправлення.

Claude Cowork

Плагіни в Cowork додаються через меню, тож цю частину агент за тебе не зробить. Перейди в Customize > Plugins > Add marketplace > Add from a repository, введи https://github.com/zadojo/seo-geo-mcp і встанови zaDojo. Для цього потрібен платний тариф Claude. У кроках для Cowork описано варіант для тарифу Free.

Codex у десктопному застосунку ChatGPT

1. Відкрий Codex і почни новий чат.
2. Встав промпт для налаштування з цієї сторінки.
3. Підтвердь вхід у zaDojo, коли він з'явиться.
4. Якщо Codex каже, що інструменти ще не завантажені, почни ще один новий чат.

Щоб встановити вручну, скористайся кроками для десктопного Codex. Які тарифи ChatGPT містять Codex, визначає OpenAI, тож перевір сторінку тарифів OpenAI. Підключення в Codex окреме від chatgpt.com: звичайний чат ChatGPT його не побачить.

Codex CLI

У терміналі:

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

Якщо плагін не з'явився, перезавантаж або перезапусти Codex. Потім увійди:

codex mcp login zadojo

Попроси Codex перевірити через SEO Coach, що все працює. У посібнику з плагіна для Codex є повідомлення про помилки, які можуть трапитися. Якщо ти встановлював через каталог плагінів десктопного застосунку, керуй плагіном звідти.

Hermes

Встав промпт для налаштування, щоб підключити MCP-сервер. Скіли беруться з хабу скілів Hermes. Щоб додати SEO Coach:

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

Виконай ту саму команду з іншою назвою теки для кожного додаткового скіла zaDojo, наприклад seo-audit чи keyword-research. Hermes запам'ятовує, звідки взявся кожен скіл, щоб пізніше перевіряти оновлення. Його власна документація: Hermes skill management.

Grok Bot

Встав промпт для налаштування у свого Bot і виконай кроки, які він тобі поверне. Упаковані скіли й конектори лежать у розділі Marketplace на бічній панелі. Приватні скіли розташовані в Your plugins > Manage plugins and skills > Private skills, і ними може користуватися кожен Bot у твоєму акаунті. Довідка від xAI: Grok Bot skills.

Claude у вебі та інші агенти

Підключи сервер за посібником із налаштування MCP. Потім додай скіли через менеджер скілів, який підтримує твій агент. У Claude власні скіли керуються в Customize > Skills. На платному тарифі Claude плагін zaDojo додає підключення й скіли разом.

Агенти, що працюють із CLI skills, можуть вибрати скіли zaDojo зі списку:

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

Обери свого поточного агента й бажану область встановлення. Не запускай це поверх плагіна, бо плагін уже містить скіли. Інші способи описані в ручному налаштуванні скілів.

Перевір, що все спрацювало

Почни новий чат і надішли:

Через zaDojo перевір моє підключення й покажи список моїх проєктів.

Робоче налаштування викликає інструменти zaDojo й повертає твій акаунт і список проєктів. Порожній список теж означає успіх: ти просто ще не створив проєкт. Ця перевірка лише читає дані й не витрачає кредитів.

Потім перевір скіли. У Claude Code введи /zadojo: і пошукай дванадцять назв скілів. У Codex введи $. В інших агентах запитай «Які скіли zaDojo ти бачиш?». Підключення, що працює без скілів, налаштоване лише наполовину.

Якщо обидві перевірки пройшли, попроси агента запустити SEO Coach. Він подивиться, де зараз твій проєкт, і порадить один наступний крок.

Оновлення скілів

Скіли з часом покращуються, а копії в твоєму агенті самі не оновлюються. Оновлення MCP-підключення оновлює список інструментів, а не файли скілів.

Користувачам ChatGPT варто скористатися кроками оновлення для ChatGPT. Власне підключення ChatGPT не має файлів скілів, які треба оновлювати.

Найпростіше вставити цей промпт в агента, де ти користуєшся zaDojo. Він з'ясує, як встановлено скіли, оновить їх там само й збереже твій вхід і будь-які правки, які ти вносив у файли скілів.

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.

Нижче ручні кроки оновлення для кожного способу встановлення.

Оновлення плагіна Claude Code

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

Щоб не робити це вручну, відкрий /plugin, перейди в Marketplaces, обери zadojo і вибери Enable auto-update. Для маркетплейсів, якими керує не Anthropic, автооновлення спочатку вимкнене. Коли Claude Code повідомить, що оновлення чекає, виконай /reload-plugins. Anthropic описує це налаштування в розділі configure auto-updates.

Оновлення плагіна Codex CLI

codex plugin marketplace upgrade zadojo

Перезапусти чи перезавантаж Codex, якщо нові версії скілів не з'явилися. Команди плагінів Codex змінювалися між релізами, тож якщо цю команду відхилено, виконай codex plugin --help, щоб побачити, що приймає твоя версія. OpenAI описує маркетплейси в документації з плагінів.

Оновлення скілів із хабу Hermes

Запитай Hermes, для яких скілів є оновлення, а потім онови скіли zaDojo на ім'я:

hermes skills check
hermes skills update seo-coach

Повтори рядок оновлення для кожного встановленого скіла zaDojo. Якщо ти редагував скіл локально, Hermes за замовчуванням його не чіпає. Спершу переглянь свої правки. Додавай --force, лише якщо готовий їх втратити. Подробиці в розділі Hermes update lifecycle.

Оновлення скілів, встановлених через CLI скілів

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

Підстав назви скілів, які ти справді встановив. Використовуй ту саму область, що й під час встановлення: -g для глобальних скілів або -p для скілів проєкту. Перед оновленням збережи копію своїх правок. Нові скіли, додані після твого встановлення, update не підхопить, тож виконай команду встановлення ще раз, щоб їх вибрати. Повний перелік опцій є в документації CLI скілів.

Оновлення Grok Bot або скопійованих вручну скілів

Для Grok Bot встав промпт для оновлення або відкрий Marketplace > Your plugins > Manage plugins and skills і онови там запис zaDojo. xAI не публікує окремої команди оновлення скілів, тож користуйся елементами керування, які показує твоя версія.

Якщо ти копіював теки скілів вручну, порівняй їх із поточними теками скілів. Заміни кожну теку повністю, разом із файлами поруч із SKILL.md, і перенеси свої правки. Скіли, завантажені через Customize > Skills у Claude, замінюються там само.

Наприкінці перезавантаж скіли або відкрий нову сесію й попроси агента підтвердити, що він бачить оновлені скіли zaDojo.

Усунення проблем

З будь-якою іншою проблемою пиши на hello@zadojo.com, вкажи назву й версію агента, крок, який не вдався, і точний текст помилки. Ніколи не надсилай паролі, API-ключі чи коди входу.

Що витрачає кредити

Налаштування, вхід, перевірка підключення й оновлення скілів нічого не коштують. SEO Coach теж безкоштовний, якщо ти не просиш його запустити дослідження. Кредити витрачаються, лише коли агент тягне платні дані, і 1 000 кредитів дорівнюють 1 €. Кілька типових цін:

• Пошук у дослідженні ключових слів: близько 0,07 €.
• Огляд домену чи беклінків з історією за рік: близько 0,10 €.
• Prompt Research для одного ключового слова: близько 0,25 €.

Читання Search Console і Google Analytics, контекст проєкту, збережені ключові слова, звіти й звичайні аудити сайту безкоштовні. Тариф коштує 10 € на місяць і щомісяця містить 10 € використання. Повний перелік і калькулятор вартості є на сторінці цін.