zaDojo MCP Sunucusu: Claude, Cursor, Codex Kurulumu

zaDojo, uzak MCP destekleyen her istemcinin bağlanabildiği uzak bir MCP sunucusu çalıştırır. MCP (Model Context Protocol), yapay zekâ uygulamalarının dış araçları çağırmasının standart yoludur. Bunun üzerinden ajanın anahtar kelime araştırabilir, canlı Google sonuçlarını okuyabilir, herhangi bir alan adının sıralamalarına ve backlinklerine bakabilir, site denetimleri çalıştırabilir, sıralamaları ve yapay zekâ yanıtlarını takip edebilir, kendi Search Console ve Google Analytics verilerini okuyabilir.

Sunucu adresi:

https://app.zadojo.com/mcp

Bir istemci ilk kez bağlandığında tarayıcında bir zaDojo girişi açar ve erişimi onaylamanı ister. Bundan sonra istemci, görebildiğin projeler için araçları kullanabilir. CI işleri ve tarayıcısı olmayan sunucular için bir API anahtarı kullan.

Claude Code ve Codex kullanıcıları, bu bağlantıyı ve on iki zaDojo skill'ini tek kurulumda ekleyen eklentiden daha fazla verim alır. Yalnızca MCP bağlantısını istediğinde ya da istemcinin eklentisi olmadığında bu sayfadaki adımları kullan. Ajan kurulum rehberinde senin için doğru yolu seçen bir prompt var.

Neye ihtiyacın var

• Bir zaDojo hesabı. Kart gerekmeden 0,10 € deneme kredisi almak için kaydol.
• HTTP üzerinden uzak MCP sunucularını destekleyen bir istemci: Claude Code, Claude Desktop, Cursor, Codex CLI, ChatGPT masaüstü uygulamasındaki Codex, özel bağlantılı ChatGPT, Copilot'lu VS Code, Windsurf (Devin Desktop), Gemini CLI, Zed veya benzeri.
• Giriş için bir tarayıcı ya da tarayıcısız kullanım için bir API anahtarı.

Uygulamadaki Agent setup sayfası aynı adresi bir kopyalama düğmesiyle gösterir. Kaydolmadan önce zaDojo verilerini denemek mi istiyorsun? Ücretsiz SEO araçları hesap gerektirmez.

İstemcini bağla

Claude Code

Çoğu kişi için daha iyi seçenek Claude Code eklentisidir. Yalnızca bağlantı için terminalde şunu çalıştır:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

--scope user, zaDojo'yu makinendeki her projede kullanılabilir yapar. Mevcut depoyla sınırlamak için --scope local kullan. Ardından Claude Code senden zaDojo'ya giriş yapmanı ister. İstem görünmezse /mcp çalıştır, zaDojo'yu seç ve girişi orada tamamla.

Claude Desktop

Ücretli bir Claude planında zaDojo eklentisi bağlantıyı ve skill'leri birlikte ekler. Free planda ya da yalnızca bağlantı için özel bir connector ekle:

1. Customize > Connectors'ı aç.
2. Add veya +'ya tıkla ve Add custom connector'ı seç.
3. https://app.zadojo.com/mcp adresini yapıştır.
4. zaDojo'ya giriş yap ve erişimi onayla.

Özel connector'lar Claude Free, Pro, Max, Team ve Enterprise'da çalışır. Free plan bir özel connector'a izin verir.

Cursor

1. Customize'ı aç ve MCP sunucularına git ya da ~/.cursor/mcp.json dosyasını doğrudan düzenle.
2. zaDojo girdisini ekle:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

3. Dosyayı kaydet ve Cursor sorduğunda zaDojo girişini onayla.

Cursor rehberinde tek tıkla kurulum bağlantısı ve skill kurulumu var.

Codex CLI

Codex eklentisi bağlantıyı ve skill'leri birlikte ekler. Yalnızca bağlantı için:

codex mcp add zadojo --url https://app.zadojo.com/mcp

Açıldığında zaDojo girişini onayla. Açılmazsa codex mcp login zadojo çalıştır.

ChatGPT masaüstü uygulamasında Codex

Codex eklentisi skill'leri de içerir. Yalnızca bağlantı için:

1. Codex'i aç, ardından Settings > MCP servers > Add server'a git.
2. Ad olarak zadojo gir, Streamable HTTP'yi seç ve https://app.zadojo.com/mcp adresini yapıştır.
3. Kaydet, ardından Codex sorduğunda Restart'a tıkla.
4. zaDojo'nun yanındaki Authenticate'e tıkla ve girişi onayla.
5. Yeni bir Codex sohbeti aç ve bağlantı kontrolünü çalıştır.

Bu bağlantı yalnızca Codex'i kapsar. Web'deki ChatGPT'nin kendi bağlantısı gerekir. OpenAI'nin başvuru kaynağı Codex MCP belgeleridir.

ChatGPT

zaDojo'yu OAuth'lu özel bir MCP bağlantısı olarak ekle. ChatGPT Free ve ücretli planlarda çalışır, ancak çalışma alanı yöneticileri özel bağlantıları engelleyebilir. ChatGPT rehberi her ekranı adım adım anlatır.

VS Code, Windsurf ve Gemini CLI

Her birinin tam yapılandırma, API anahtarı kurulumu ve skill kurulumuyla kendi sayfası var:

• GitHub Copilot'lu VS Code
• Windsurf (Devin Desktop)
• Gemini CLI ve Antigravity CLI

Diğer MCP istemcileri

Streamable HTTP üzerinden uzak bir MCP sunucusuna erişebilen ve OAuth girişini destekleyen her istemci yukarıdaki adresi kullanabilir. İstemci OAuth yapamıyorsa, aşağıda anlatıldığı gibi bir başlıkta API anahtarı gönder.

Bunların hepsi ilk bağlandıklarında tarayıcında zaDojo girişini açar.

API anahtarıyla bağlan

API anahtarı tarayıcı girişinin yerini alır. CI hatları, uzak sunucular, giriş akışının çalışmadığı Hermes gibi ajanlar ya da OAuth desteği olmayan istemciler için kullan.

Anahtar kişisel olarak sana aittir. Bir ajanın onunla yaptığı her şey, çalışma alanında senin hesabınla çalışır; bu yüzden onu gizli bir değer olarak sakla ve asla bir depoya commit etme.

Oluşturmak için zaDojo uygulamasında Settings sayfasını aç, API keys'i bul ve Create API key'e tıkla. Anahtarı hemen kopyala, çünkü zaDojo onu yalnızca bir kez gösterir. Anahtarlar zadojo_ ile başlar.

Claude Code:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp --header "Authorization: Bearer zadojo_YOUR_KEY"

Cursor: mcp.json içindeki zaDojo girdisine bir headers bloğu ekle:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp",
      "headers": {
        "Authorization": "Bearer zadojo_YOUR_KEY"
      }
    }
  }
}

Codex CLI: anahtarı bir ortam değişkeninde tut ve Codex'i ona yönlendir:

export ZADOJO_API_KEY=zadojo_YOUR_KEY
codex mcp add zadojo --url https://app.zadojo.com/mcp --bearer-token-env-var ZADOJO_API_KEY

Diğer istemciler: her istekle birlikte Authorization: Bearer zadojo_YOUR_KEY ya da x-api-key: zadojo_YOUR_KEY gönder.

Bir anahtarı iptal etmek için aynı API keys bölümünü aç ve onu kaldır.

Bağlantıyı kontrol et

Yeni bir sohbet veya oturum aç ve gönder:

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

Ajan whoami ve list_projects araçlarını çağırmalı. Hesabın, kalan kredi bakiyen ve projelerin gelir; henüz projen yoksa boş bir liste görürsün. İki araç da ücretsizdir. Ajan bir araç çağırmak yerine MCP'yi anlatıyorsa, sunucu bu oturumda yüklü değildir: istemciyi yeniden yükle ya da yeni bir sohbet başlat.

Kullanılabilir araçlar

Sunucuda 80'den fazla araç var. Tablo onları işe göre gruplar. Araç adları ajanının gördüğü adlardır.

Bilmeye değer birkaç davranış:

• Proje bağlamı, bir projenin ortak hafızasıdır: işletme özeti, mevcut hedef, konumlandırma, yazım tercihleri, rakipler, önemli sayfalar ve bir araştırma günlüğü. Ajanlar başlamadan önce onu okur; uygulama ve diğer ajanlar da aynı girdileri görür.
• Bir ajanın kaydettiği raporlar, tüm ekibinin okuması, yazdırması veya dışa aktarması için projede görünür. Yeni raporlar özeldir. Herkese açık bir bağlantı yalnızca ajandan set_report_sharing aracını public: true ile çağırmasını istediğinde oluşturulur; public: false onu iptal eder. get_report, herkese açık bir bağlantı varsa report.shareUrl, yoksa null döndürür.
• Search Console ve Google Analytics araçları, projeye zaten bağlı olan mülkü okur. Erişim salt okunurdur.
• Tekrarlayan her şey için önce tahmin gelir. Sıralama takibinin ve yapay zekâ takibinin tahmin araçları vardır, böylece ajan kontrolleri planlamadan önce sana maliyeti gösterebilir.

Neler kredi kullanır

Krediler zaDojo bakiyenden gelir. 1.000 kredi 1 € eder ve ayda 10 €'luk plan 10 € kullanım içerir. Tipik fiyatlar:

Ücretsiz olanlar: hesap kontrolleri, proje bağlamı, kayıtlı anahtar kelimeler, raporlar, Search Console, Google Analytics, basit site denetimleri ve daha önce topladığın sıralama takibi, denetim ya da yapay zekâ görünürlüğü sonuçlarını okumak. zaDojo'ya bağlı ajanlara, 2.000 krediyi (yaklaşık 2 €) aşan planlı bir toplu işlemden önce sana sormaları söylenir. Bakiye sıfıra düştüğünde, bakiye yükleyene kadar ücretli araçlar durur. Hesaplayıcı için fiyatlandırmaya bak.

Bağlandıktan sonra

Bağlantı ajanına veri verir. Skill'ler ise o veriyle ne yapacağını adım adım söyler. MCP'yi eklenti olmadan kullandıysan, sırada skill'leri kurmak var.

Ajana "SEO yap" demek yerine belirli tek bir iş ver:

• SEO Project Setup: hedefini, konumlandırmanı, rakiplerini ve önemli sayfalarını kaydet; sonraki her görev bunlardan başlasın.
• SEO Coach: SEO'da yeniysen önerilen tek bir sonraki adımı al.
• SEO Audit: trafiği büyütme olasılığı en yüksek birkaç değişikliği bul.
• Keyword Research ve Keyword Clustering: hedeflemeye değer arama terimlerini bul ve sayfalara göre grupla.
• Competitive Landscape ve Competitor Analysis: bir pazarın haritasını çıkar ya da tek bir rakibi derinlemesine incele.
• Link Prospecting: bir sayfaya bağlantı verebilecek siteleri bul ve erişim taslakları yaz.
• AI Prompt Research ve AI Visibility Audit: yapay zekâ araçlarının pazarın hakkında ne söylediğini ve rakiplerin neden anıldığını gör.

Yapay zekâ görünürlüğü rehberi, yapay zekâ yanıt takibi için motorları, kapsamı ve maliyetleri anlatır.

Sorun giderme

İstemci bağlanamıyor. Adresin tam olarak https://app.zadojo.com/mcp olduğunu, https:// içerdiğini ve sonunda boşluk olmadığını kontrol et.

Codex Authorization server response missing required issuer: expected https://app.zadojo.com bildiriyor. Codex 0.143 ile 0.146 arasındaki sürümler OAuth sırasında issuer bilgisini düşürür. Codex CLI'ı ya da Codex masaüstü uygulamasını 0.147.0 veya daha yeni bir sürüme güncelle ya da bir API anahtarı kullan.

Giriş başarısız oluyor veya sürekli süresi doluyor. zaDojo sunucusunu istemcinden kaldır, tekrar ekle ve girişi yinele.

Ajan bir proje bulamıyor. Ondan önce list_projects çağırmasını ve dönen proje kimliğini sonraki çağrılarda kullanmasını iste. Hiç projen yoksa, alan adın için ücretsiz olan create_project ile bir proje oluşturmasını iste.

Ücretli bir araç kredinin bittiğini söylüyor. Ücretli planda uygulamadaki faturalandırma bölümünden ek kredi al ya da aylık kredilerinin yenilenmesini bekle. Denemedeysen ücretli araçları kullanmaya devam etmek için abone ol.

Hâlâ takıldın mı? İstemcinin adı, sürümü ve tam hata mesajıyla hello@zadojo.com adresine e-posta gönder. Asla API anahtarı ekleme.