Yapay Zekâ Ajanı Kurulumu: zaDojo ve Skill'ler

Bir yapay zekâ ajanının zaDojo'dan iki parçaya ihtiyacı vardır. MCP bağlantısı, https://app.zadojo.com/mcp adresinde canlı SEO verileri için zaDojo araçlarını çağırmasını sağlar. Skill'ler ise ona denetim veya anahtar kelime araştırması gibi bir işi baştan sona nasıl yürüteceğini anlatan SKILL.md dosyalarıdır. İkisini de almanın en hızlı yolu, aşağıdaki kurulum prompt'unu ajanına yapıştırıp kurulumu ona bırakmaktır.

ChatGPT mi kullanıyorsun? Bunun yerine ChatGPT rehberine git. Normal bir ChatGPT sohbeti hiçbir şey kuramaz, bu yüzden prompt ona yalnızca manuel adımları yazdırır. Özel bağlantı ChatGPT Free'de de ücretli planlarda da çalışır.

Neye ihtiyacın var

• Bir zaDojo hesabı. Kart gerekmeden 0,10 € deneme kredisi almak için kaydol ya da kurulum akışı giriş sayfasını açtığında hesabı oluştur.
• Uzak bir MCP sunucusuna bağlanabilen bir ajan: Claude Code, Claude Cowork, Codex (CLI veya ChatGPT masaüstü uygulaması), Hermes, Grok Bot, Cursor ve benzeri istemciler.
• zaDojo girişini onaylayabileceğin bir tarayıcı. Tarayıcısı olmayan bir ajan için bunun yerine bir API anahtarı kullan.

Ajanını kur

1. Aşağıdaki prompt'u kopyala. Onu zaDojo uygulamasındaki Agent setup sayfasından da kopyalayabilir ya da ajanını https://zadojo.com/agent-setup.txt adresindeki düz metin sürümüne yönlendirebilirsin.
2. Ajanında yeni bir sohbete veya oturuma yapıştır.
3. Ajan hangi istemci olduğunu anlar, mevcut bir zaDojo bağlantısı olup olmadığını kontrol eder ve varsa eklentiyi kurar. Eklenti olmayan yerlerde MCP sunucusunu ve herkese açık skill'leri ayrı ayrı ekler.
4. Tarayıcın zaDojo girişini açtığında giriş yap ve erişimi onayla.
5. Ajan senden yeniden yüklemeni, yeniden başlatmanı ya da kendisinin ulaşamadığı bir şeye tıklamanı isterse o adımı yap. Sana tam olarak ne yapacağını söyler.

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.

Ajan kısa bir durum mesajı ve birkaç önerilen ilk görevle bitirir. Kurulum sırasında proje oluşturmaz ve ücretli araştırma çalıştırmaz.

Ajana göre manuel kurulum

Prompt kurulumu zaten bitirdiyse bu bölümü atla. Aşağıdaki her blok aynı işi elle yapar.

Claude Code

Bir Claude Code oturumunda marketplace'i ekle ve eklentiyi kur:

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

Claude Code eklentiyi etkinleştirmeni isterse /reload-plugins çalıştır. zaDojo girişini onayla, ardından skill'lerin yüklendiğini doğrulamak için /zadojo:seo-coach yaz. Claude Code eklenti rehberi kapsamları, güncellemeleri ve çözümleri anlatır.

Claude Cowork

Cowork'te eklentiler menülerden eklenir, bu yüzden bu kısmı bir ajan senin yerine yapamaz. Customize > Plugins > Add marketplace > Add from a repository'ye git, https://github.com/zadojo/seo-geo-mcp gir ve zaDojo'yu kur. Bunun için ücretli bir Claude planı gerekir. Cowork adımları Free plan alternatifini açıklar.

ChatGPT masaüstü uygulamasında Codex

1. Codex'i aç ve yeni bir sohbet başlat.
2. Bu sayfadaki kurulum prompt'unu yapıştır.
3. Göründüğünde zaDojo girişini onayla.
4. Codex araçların henüz yüklenmediğini söylerse yeni bir sohbet daha başlat.

Elle kurmak için Codex masaüstü adımlarını izle. Hangi ChatGPT planlarının Codex içerdiğini OpenAI belirler, bu yüzden OpenAI'nin plan sayfasına bak. Codex bağlantısı chatgpt.com'dan ayrıdır: normal bir ChatGPT sohbeti onu görmez.

Codex CLI

Bir terminalden:

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

Eklenti görünmezse Codex'i yeniden yükle ya da yeniden başlat. Ardından giriş yap:

codex mcp login zadojo

Her şeyin çalıştığını kontrol etmesi için Codex'ten SEO Coach'u kullanmasını iste. Codex eklenti rehberi görebileceğin hata mesajlarını listeler. Bir masaüstü eklenti dizininden kurduysan, eklentiyi o dizinden yönet.

Hermes

MCP sunucusunu bağlamak için kurulum prompt'unu yapıştır. Skill'ler Hermes skill merkezinden gelir. SEO Coach'u eklemek için:

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

İstediğin her ek zaDojo skill'i için aynı komutu başka bir klasör adıyla çalıştır, örneğin seo-audit veya keyword-research. Hermes daha sonra güncellemeleri kontrol edebilmek için her skill'in nereden geldiğini kaydeder. Kendi belgeleri Hermes skill management sayfasında.

Grok Bot

Kurulum prompt'unu Bot'una yapıştır ve sana geri verdiği adımları uygula. Paketlenmiş skill'ler ve connector'lar kenar çubuğunda Marketplace altında bulunur. Özel skill'ler Your plugins > Manage plugins and skills > Private skills altındadır ve hesabındaki her Bot onları kullanabilir. xAI'nin başvuru kaynağı için Grok Bot skills sayfasına bak.

Claude web ve diğer ajanlar

Sunucuyu MCP kurulum rehberiyle bağla. Ardından skill'leri ajanının desteklediği skill yöneticisiyle ekle. Claude'da özel skill'ler Customize > Skills altında yönetilir. Ücretli bir Claude planında zaDojo eklentisi bağlantıyı ve skill'leri birlikte ekler.

skills CLI ile çalışan ajanlar zaDojo skill'lerini bir listeden seçebilir:

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

Mevcut ajanını ve tercih ettiğin kurulum kapsamını seç. Bunu eklentinin üzerine çalıştırma, çünkü eklenti skill'leri zaten içerir. Diğer yollar manuel skill kurulumu sayfasında anlatılıyor.

İşe yaradığını kontrol et

Yeni bir sohbet başlat ve gönder:

zaDojo ile bağlantımı kontrol et ve projelerimi listele.

Çalışan bir kurulum zaDojo araçlarını çağırır ve hesabını ile proje listeni döndürür. Boş bir liste de geçer not sayılır: henüz bir proje oluşturmadığın anlamına gelir. Bu kontrol yalnızca veri okur ve kredi kullanmaz.

Ardından skill'leri kontrol et. Claude Code'da /zadojo: yaz ve on iki skill adını ara. Codex'te $ yaz. Diğer ajanlarda "Hangi zaDojo skill'lerini görebiliyorsun?" diye sor. Hiç skill olmadan çalışan bir bağlantı yalnızca yarı yarıya kurulmuştur.

İki kontrol de geçerse ajanından SEO Coach'u çalıştırmasını iste. Projenin nerede durduğuna bakar ve tek bir sonraki adım önerir.

Skill'lerini güncelle

Skill'ler zamanla gelişir ve ajanının içindeki kopyalar kendiliğinden güncellenmez. MCP bağlantısını yenilemek skill dosyalarını değil, araç listesini günceller.

ChatGPT kullanıcıları bunun yerine ChatGPT güncelleme adımlarını izlemeli. Özel bir ChatGPT bağlantısında güncellenecek skill dosyası yoktur.

En kolay yol, bu prompt'u zaDojo'yu kullandığın ajana yapıştırmaktır. Skill'lerin nasıl kurulduğunu bulur, onları aynı yerde günceller ve girişini ile skill dosyalarında yaptığın düzenlemeleri korur.

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.

Her kurulum yöntemi için manuel güncelleme adımları aşağıda.

Claude Code eklentisini güncelle

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

Bunu elle yapmayı bırakmak için /plugin'i aç, Marketplaces'e git, zadojo'yu seç ve Enable auto-update'i seç. Otomatik güncelleme, Anthropic'in işletmediği marketplace'ler için kapalı başlar. Claude Code bir güncellemenin beklediğini söylediğinde /reload-plugins çalıştır. Anthropic bu ayarı configure auto-updates sayfasında belgeliyor.

Codex CLI eklentisini güncelle

codex plugin marketplace upgrade zadojo

Yeni skill sürümleri görünmezse Codex'i yeniden başlat ya da yeniden yükle. Codex eklenti komutları sürümler arasında değişti; bu komut reddedilirse, sürümünün neyi kabul ettiğini görmek için codex plugin --help çalıştır. OpenAI marketplace'leri eklenti belgelerinde anlatıyor.

Hermes merkez skill'lerini güncelle

Hermes'e hangi skill'lerin güncellemesi olduğunu sor, ardından zaDojo skill'lerini adıyla güncelle:

hermes skills check
hermes skills update seo-coach

Kurduğun her zaDojo skill'i için güncelleme satırını tekrarla. Bir skill'i yerel olarak düzenlediysen Hermes varsayılan olarak ona dokunmaz. Önce düzenlemelerini oku. --force'u yalnızca onları kaybetmeye razıysan ekle. Ayrıntılar Hermes update lifecycle sayfasında.

Skills CLI ile kurulan skill'leri güncelle

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

Gerçekten kurduğun skill adlarını yaz. Kurduğun kapsamı kullan: global skill'ler için -g, proje skill'leri için -p. Güncellemeden önce kişisel düzenlemelerinin bir kopyasını kaydet. Kurulumundan sonra eklenen yeni skill'ler update ile alınmaz; onları seçmek için kurulum komutunu tekrar çalıştır. Skills CLI belgelerinde tüm seçeneklerin listesi var.

Grok Bot veya elle kopyalanan skill'leri güncelle

Grok Bot için güncelleme prompt'unu yapıştır ya da Marketplace > Your plugins > Manage plugins and skills'i açıp zaDojo girdisini oradan güncelle. xAI skill'ler için ayrı bir güncelleme komutu yayınlamıyor, bu yüzden sürümünün gösterdiği kontrolleri kullan.

Skill klasörlerini elle kopyaladıysan, onları güncel skill klasörleriyle karşılaştır. SKILL.md'nin yanındaki dosyalar dahil her klasörü bütün olarak değiştir ve kendi düzenlemelerini aktar. Claude'un Customize > Skills bölümünden yüklenen skill'ler aynı yerde değiştirilir.

Bitirdiğinde skill'leri yeniden yükle ya da yeni bir oturum aç, ardından ajandan güncellenmiş zaDojo skill'lerini görebildiğini doğrulamasını iste.

Sorun giderme

Diğer her şey için ajanının adı ve sürümü, başarısız olan adım ve tam hata metniyle hello@zadojo.com adresine e-posta gönder. Asla şifre, API anahtarı veya giriş kodu gönderme.

Neler kredi kullanır

Kurulum, giriş, bağlantı kontrolü ve skill güncellemeleri ücretsizdir. Araştırma yapmasını istemediğin sürece SEO Coach da ücretsizdir. Krediler yalnızca ajanın ücretli veri çektiğinde harcanır ve 1.000 kredi 1 € eder. Bazı tipik fiyatlar:

• Bir anahtar kelime araştırması araması: yaklaşık 0,07 €.
• Bir yıllık geçmişle bir alan adı veya backlink özeti: yaklaşık 0,10 €.
• Bir anahtar kelime için Prompt Research: yaklaşık 0,25 €.

Search Console ve Google Analytics okumaları, proje bağlamı, kayıtlı anahtar kelimeler, raporlar ve basit site denetimleri ücretsizdir. Plan ayda 10 €'dur ve her ay 10 € kullanım içerir. Tam liste ve maliyet hesaplayıcı için fiyatlandırmaya bak.