Настройка на AI агент: свържи zaDojo и умения

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

Използваш ChatGPT? Отиди на ръководството за ChatGPT. Обикновен чат в ChatGPT не може да инсталира нищо, така че промптът само ще го накара да отпечата ръчните стъпки. Custom връзката работи в 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 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

Постави промпта за настройка в своя Bot и направи стъпките, които ти върне. Пакетираните умения и конектори са в Marketplace в страничната лента. Личните умения са в Your plugins > Manage plugins and skills > Private skills и всеки Bot в акаунта ти може да ги използва. Виж Grok Bot skills за справочника на xAI.

Claude в уеб и други агенти

Свържи сървъра с ръководството за настройка на MCP. После добави уменията с мениджъра на умения, който агентът ти поддържа. В Claude custom уменията се управляват от 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. Custom връзка в 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.

Обнови умения, инсталирани със skills CLI

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

Сложи имената на уменията, които реално си инсталирал. Използвай същия обхват, в който си инсталирал: -g за глобални умения или -p за умения на проекта. Запази копие на личните си редакции, преди да обновиш. Новите умения, добавени след инсталацията ти, не се взимат от update, затова пусни отново командата за инсталиране, за да ги избереш. Документацията на skills 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 също е безплатен, освен ако не го помолиш да пусне проучване. Кредити се харчат само когато агентът ти тегли платени данни, а 1000 кредита са равни на 1 €. Някои обичайни цени:

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

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