Поставување 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 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 на твојата сметка може да ги користи. Референцата на 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.

Ажурирај вештини инсталирани со 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 е исто така бесплатен, освен ако не побараш да пушти истражување. Кредити се трошат само кога агентот повлекува платени податоци, а 1.000 кредити се 1 €. Неколку вообичаени цени:

• Пребарување за истражување клучни зборови: околу 0,07 €.
• Преглед на домен или backlinks со една година историја: околу 0,10 €.
• Prompt Research за еден клучен збор: околу 0,25 €.

Читањата од Search Console и Google Analytics, контекстот на проектот, зачуваните клучни зборови, извештаите и обичните ревизии на сајт се бесплатни. Планот е 10 € месечно и вклучува 10 € за користење секој месец. Целата листа и калкулаторот на трошоци се на цени.