Konfigurimi i agjentit të AI me zaDojo

Një agjent i AI ka nevojë për dy pjesë nga zaDojo. Lidhja MCP i lejon të thërrasë mjetet e zaDojo për të dhëna SEO live në https://app.zadojo.com/mcp. Skills janë skedarë SKILL.md që i tregojnë si ta kryejë një punë, si një auditim ose kërkim fjalësh kyçe, nga fillimi në fund. Mënyra më e shpejtë për t'i marrë të dyja është të ngjitni promptin e konfigurimit më poshtë te agjenti juaj dhe ta lini të bëjë instalimin.

Përdorni ChatGPT? Shkoni te udhëzuesi për ChatGPT. Një bisedë e zakonshme në ChatGPT nuk mund të instalojë asgjë, kështu që prompti vetëm e bën të shfaqë hapat manualë. Lidhja e personalizuar funksionon në ChatGPT Free dhe në planet me pagesë.

Çfarë ju nevojitet

• Një llogari zaDojo. Regjistrohuni për të marrë 0,10 € kredite prove pa kartë, ose krijoni llogarinë kur konfigurimi hap faqen e hyrjes.
• Një agjent që mund të lidhet me një server MCP në distancë: Claude Code, Claude Cowork, Codex (CLI ose aplikacioni desktop i ChatGPT), Hermes, Grok Bot, Cursor dhe klientë të ngjashëm.
• Një shfletues ku mund të miratoni hyrjen në zaDojo. Për një agjent pa shfletues, përdorni një çelës API.

Konfiguroni agjentin tuaj

1. Kopjoni promptin më poshtë. Mund ta kopjoni edhe nga Agent setup brenda aplikacionit zaDojo, ose ta drejtoni agjentin te versioni tekst i thjeshtë në https://zadojo.com/agent-setup.txt.
2. Ngjiteni në një bisedë ose sesion të ri te agjenti juaj.
3. Agjenti kupton cili klient është, kontrollon nëse ka tashmë një lidhje zaDojo dhe instalon pluginin aty ku ekziston. Aty ku nuk ka plugin, shton serverin MCP dhe skills publike veçmas.
4. Kur shfletuesi hap hyrjen në zaDojo, hyni dhe miratoni qasjen.
5. Nëse agjenti ju kërkon të ringarkoni, të rinisni ose të klikoni diçka që ai nuk e arrin, bëjeni atë hap. Ai ju thotë saktësisht çfarë të bëni.

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.

Agjenti përfundon me një mesazh të shkurtër gjendjeje dhe disa detyra të para të sugjeruara. Gjatë konfigurimit nuk krijon projekte dhe nuk nis kërkime me pagesë.

Konfigurimi manual sipas agjentit

Kalojeni këtë seksion nëse prompti e përfundoi instalimin. Çdo bllok më poshtë bën të njëjtën punë me dorë.

Claude Code

Brenda një sesioni të Claude Code, shtoni marketplace-in dhe instaloni pluginin:

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

Ekzekutoni /reload-plugins nëse Claude Code ju kërkon ta aktivizoni pluginin. Miratoni hyrjen në zaDojo, pastaj shkruani /zadojo:seo-coach për të konfirmuar që skills u ngarkuan. Udhëzuesi i pluginit për Claude Code trajton fushëveprimet, përditësimet dhe zgjidhjet.

Claude Cowork

Pluginet në Cowork shtohen përmes menyve, kështu që një agjent nuk mund ta bëjë këtë pjesë për ju. Shkoni te Customize > Plugins > Add marketplace > Add from a repository, shkruani https://github.com/zadojo/seo-geo-mcp dhe instaloni zaDojo. Kjo kërkon një plan Claude me pagesë. Hapat për Cowork shpjegojnë alternativën për planin Free.

Codex në aplikacionin desktop të ChatGPT

1. Hapni Codex dhe nisni një bisedë të re.
2. Ngjitni promptin e konfigurimit nga kjo faqe.
3. Miratoni hyrjen në zaDojo kur të shfaqet.
4. Nëse Codex thotë që mjetet nuk janë ngarkuar ende, nisni edhe një bisedë të re.

Për instalim me dorë, ndiqni hapat për Codex desktop. Cilat plane të ChatGPT përfshijnë Codex e vendos OpenAI, prandaj kontrolloni faqen e planeve të OpenAI. Një lidhje në Codex është e ndarë nga chatgpt.com: një bisedë e zakonshme në ChatGPT nuk do ta shohë.

Codex CLI

Nga një terminal:

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

Nëse plugini nuk shfaqet, ringarkoni ose rinisni Codex. Pastaj hyni:

codex mcp login zadojo

Kërkojini Codex të përdorë SEO Coach për të kontrolluar që gjithçka funksionon. Udhëzuesi i pluginit për Codex liston mesazhet e gabimit që mund të shihni. Nëse e instaluat përmes një direktorie pluginesh në desktop, menaxhojeni pluginin nga ajo direktori.

Hermes

Ngjitni promptin e konfigurimit për të lidhur serverin MCP. Skills vijnë nga hub-i i skills të Hermes. Për të shtuar SEO Coach:

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

Ekzekutoni të njëjtën komandë me një emër tjetër dosjeje për çdo skill të zaDojo shtesë që doni, për shembull seo-audit ose keyword-research. Hermes regjistron nga erdhi çdo skill, që të mund të kontrollojë më vonë për përditësime. Dokumentacioni i tij është te Hermes skill management.

Grok Bot

Ngjitni promptin e konfigurimit te Bot-i juaj dhe bëni hapat që ai ju kthen. Skills dhe connector-ët e paketuar ndodhen te Marketplace në shiritin anësor. Skills private janë te Your plugins > Manage plugins and skills > Private skills, dhe çdo Bot në llogarinë tuaj mund t'i përdorë. Shihni Grok Bot skills për referencën e xAI.

Claude web dhe agjentë të tjerë

Lidhni serverin me udhëzuesin e konfigurimit të MCP. Pastaj shtoni skills me menaxherin e skills që mbështet agjenti juaj. Në Claude, skills e personalizuara menaxhohen te Customize > Skills. Në një plan Claude me pagesë, plugini zaDojo shton lidhjen dhe skills së bashku.

Agjentët që punojnë me CLI-në skills mund të zgjedhin skills të zaDojo nga një listë:

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

Zgjidhni agjentin aktual dhe fushëveprimin e instalimit që preferoni. Mos e ekzekutoni këtë mbi pluginin, sepse plugini i sjell tashmë skills. Rrugët e tjera trajtohen te konfigurimi manual i skills.

Kontrolloni që funksionoi

Nisni një bisedë të re dhe dërgoni:

Përdor zaDojo për të kontrolluar lidhjen time dhe për të listuar projektet e mia.

Një konfigurim që funksionon thërret mjetet e zaDojo dhe kthen llogarinë dhe listën e projekteve. Një listë bosh është gjithashtu sukses: do të thotë që nuk keni krijuar ende projekt. Ky kontroll vetëm lexon të dhëna dhe nuk shpenzon kredite.

Pastaj kontrolloni skills. Në Claude Code, shkruani /zadojo: dhe kërkoni dymbëdhjetë emrat e skills. Në Codex, shkruani $. Në agjentë të tjerë, pyesni "Cilat skills të zaDojo mund të shohësh?" Një lidhje që funksionon pa asnjë skill është vetëm gjysmë e konfiguruar.

Nëse kalojnë të dy kontrollet, kërkojini agjentit të ekzekutojë SEO Coach. Ai shikon ku ndodhet projekti juaj dhe rekomandon një hap të mëtejshëm.

Përditësoni skills

Skills përmirësohen me kohën, dhe kopjet brenda agjentit tuaj nuk përditësohen vetë. Rifreskimi i lidhjes MCP përditëson listën e mjeteve, jo skedarët e skills.

Përdoruesit e ChatGPT duhet të ndjekin hapat e përditësimit për ChatGPT. Një lidhje e personalizuar në ChatGPT nuk ka skedarë skills për t'u përditësuar.

Rruga më e lehtë është të ngjitni këtë prompt te agjenti ku përdorni zaDojo. Ai zbulon si u instaluan skills, i përditëson në të njëjtin vend dhe ruan hyrjen tuaj dhe çdo ndryshim që keni bërë në skedarët e skills.

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.

Më poshtë vijojnë hapat manualë të përditësimit për çdo metodë instalimi.

Përditësoni pluginin për Claude Code

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

Që të mos e bëni më këtë me dorë, hapni /plugin, shkoni te Marketplaces, zgjidhni zadojo dhe zgjidhni Enable auto-update. Përditësimi automatik është i çaktivizuar fillimisht për marketplace që nuk i menaxhon Anthropic. Kur Claude Code ju thotë që një përditësim po pret, ekzekutoni /reload-plugins. Anthropic e dokumenton cilësimin te configure auto-updates.

Përditësoni pluginin për Codex CLI

codex plugin marketplace upgrade zadojo

Rinisni ose ringarkoni Codex nëse versionet e reja të skills nuk shfaqen. Komandat e pluginëve të Codex kanë ndryshuar mes versioneve, kështu që nëse kjo refuzohet, ekzekutoni codex plugin --help për të parë çfarë pranon versioni juaj. OpenAI i përshkruan marketplace-t në dokumentacionin e pluginëve.

Përditësoni skills nga hub-i i Hermes

Pyeteni Hermes cilat skills kanë përditësime, pastaj përditësoni ato të zaDojo me emër:

hermes skills check
hermes skills update seo-coach

Përsëritni rreshtin e përditësimit për çdo skill të zaDojo që keni instaluar. Nëse e keni ndryshuar një skill lokalisht, Hermes e lë të paprekur si parazgjedhje. Lexoni fillimisht ndryshimet tuaja. Shtoni --force vetëm kur pranoni t'i humbni. Detajet janë te Hermes update lifecycle.

Përditësoni skills të instaluara me CLI-në e skills

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

Vendosni emrat e skills që keni instaluar në të vërtetë. Përdorni të njëjtin fushëveprim ku i instaluat: -g për skills globale ose -p për skills të projektit. Ruani një kopje të ndryshimeve personale para përditësimit. Skills e reja të shtuara pas instalimit tuaj nuk merren nga update, prandaj ekzekutoni sërish komandën e instalimit për t'i zgjedhur. Dokumentacioni i CLI-së së skills ka listën e plotë të opsioneve.

Përditësoni Grok Bot ose skills të kopjuara me dorë

Për Grok Bot, ngjitni promptin e përditësimit, ose hapni Marketplace > Your plugins > Manage plugins and skills dhe përditësoni hyrjen e zaDojo atje. xAI nuk publikon një komandë të veçantë përditësimi për skills, prandaj përdorni kontrollet që tregon versioni juaj.

Nëse i kopjuat dosjet e skills me dorë, krahasojini me dosjet aktuale të skills. Zëvendësoni çdo dosje të plotë, përfshirë çdo skedar pranë SKILL.md, dhe barteni ndryshimet tuaja. Skills e ngarkuara përmes Customize > Skills të Claude zëvendësohen në të njëjtin vend.

Kur të mbaroni, ringarkoni skills ose hapni një sesion të ri, pastaj kërkojini agjentit të konfirmojë që i sheh skills e përditësuara të zaDojo.

Zgjidhja e problemeve

Për çdo gjë tjetër, shkruani në hello@zadojo.com me emrin dhe versionin e agjentit, hapin që dështoi dhe tekstin e saktë të gabimit. Mos dërgoni kurrë fjalëkalime, çelësa API ose kode hyrjeje.

Çfarë shpenzon kredite

Konfigurimi, hyrja, kontrolli i lidhjes dhe përditësimet e skills nuk kushtojnë asgjë. Edhe SEO Coach është falas, përveç rasteve kur i kërkoni të bëjë kërkime. Kreditet shpenzohen vetëm kur agjenti merr të dhëna me pagesë, dhe 1.000 kredite janë 1 €. Disa çmime tipike:

• Një kërkim fjalësh kyçe: rreth 0,07 €.
• Një përmbledhje domeni ose backlinks me historik një vjeçar: rreth 0,10 €.
• Prompt Research për një fjalë kyçe: rreth 0,25 €.

Leximet nga Search Console dhe Google Analytics, konteksti i projektit, fjalët kyçe të ruajtura, raportet dhe auditimet e thjeshta të faqes janë falas. Plani kushton 10 € në muaj dhe përfshin 10 € përdorim çdo muaj. Shihni çmimet për listën e plotë dhe një kalkulator kostosh.