Настройка ИИ-агента: zaDojo и навыки

ИИ-агенту нужны от zaDojo две вещи. MCP-подключение позволяет ему вызывать инструменты zaDojo для живых SEO-данных по адресу https://app.zadojo.com/mcp. Навыки это файлы SKILL.md, которые объясняют, как выполнить задачу вроде аудита или подбора ключевых слов от начала до конца. Быстрее всего получить и то и другое, вставив промпт для настройки ниже в агента и позволив ему выполнить установку.

Пользуетесь ChatGPT? Тогда перейдите к руководству по ChatGPT. Обычный чат ChatGPT ничего не может установить, поэтому промпт лишь заставит его вывести ручные шаги. Пользовательское подключение работает как на бесплатном, так и на платных тарифах ChatGPT.

Что нужно

• Аккаунт 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 описана альтернатива для бесплатного тарифа.

Codex в настольном приложении ChatGPT

1. Откройте Codex и начните новый чат.
2. Вставьте промпт для настройки с этой страницы.
3. Подтвердите вход в zaDojo, когда он появится.
4. Если Codex сообщает, что инструменты ещё не загружены, начните ещё один новый чат.

Чтобы установить вручную, следуйте шагам для Codex desktop. Какие тарифы 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

Вставьте промпт для настройки в своего бота и выполните шаги, которые он вернёт вам. Готовые навыки и коннекторы находятся в разделе Marketplace на боковой панели. Приватные навыки находятся в Your plugins > Manage plugins and skills > Private skills, и ими может пользоваться любой бот в вашем аккаунте. Справка 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 skills

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

Подставьте названия навыков, которые вы действительно установили. Используйте ту же область, что и при установке: -g для глобальных навыков или -p для навыков проекта. Сохраните копию личных правок перед обновлением. Навыки, добавленные после вашей установки, update не подхватывает, поэтому снова выполните команду установки, чтобы их выбрать. Полный список параметров в документации CLI skills.

Обновление 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 тоже бесплатен, если не просить его провести исследование. Кредиты тратятся, только когда агент получает платные данные, и 1000 кредитов равны 1 €. Несколько типичных цен:

• Поиск ключевых слов: около 0,07 €.
• Обзор домена или обратных ссылок с историей за год: около 0,10 €.
• Prompt Research по одному ключевому слову: около 0,25 €.

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