Google Search Console için bir MCP sunucusu, Claude, Claude Code, Codex veya Cursor gibi bir yapay zekâ ajanına Search Console API erişimi verir. Ajan tıklamalarınızı, gösterimlerinizi, tıklama oranınızı ve ortalama konumunuzu çekebilir, bir sayfanın dizine eklenip eklenmediğini kontrol edebilir ve site haritalarınızı listeleyebilir. Sorunuzu günlük dille sorarsınız, örneğin "Hangi sayfalar ilk sayfada sıralanıyor ama hiç tıklama almıyor?", ajan da sorguları çalıştırıp satırları tek tek inceler. Bu rehber kurulum için üç yolu karşılaştırıyor, API'nin neleri dışarıda bıraktığını açıklıyor ve Search Console'da kendiniz doğrulayabileceğiniz ilk denetimi adım adım gösteriyor.
Kısa cevap: 9 Kasım 2026 itibarıyla Google'ın resmî bir Search Console MCP sunucusu yok. Google, Google Analytics için bir MCP sunucusu yayımlıyor; Claude'un ve ChatGPT'nin dizinlerinde ise Google, Anthropic veya OpenAI'ın sunduğu bir Search Console bağlayıcısı bulunmuyor. Seçenekleriniz şunlar: kendiniz çalıştırdığınız ve Google Cloud projesi gerektiren ücretsiz bir topluluk sunucusu; Google hesabınızla oturum açtığınız barındırılan bir sunucu; ya da Orkas gibi yerleşik bağlayıcısı olan ve Bağlan'a tıkladığınız bir uygulama. Üçü de aynı API'yi okur ve API her sorguyu listelemez: Google anonimleştirilmiş sorguları dışarıda bırakır; Ahrefs'in 887.534 Search Console mülkünü inceleyen çalışmasında bu sorgular trafiğin %46,77'sini oluşturuyordu.
Bir Search Console MCP neler yapabilir, neler yapamaz
Topluluk ya da ticari, her Search Console MCP sunucusu aynı ücretsiz Search Console API'yi çağırır. Neler yapabileceği bu API'ye bağlıdır. Aşağıdaki liste Google'ın API referansına ve kullanım sınırlarına dayanıyor.
| Ne istiyorsunuz | API | Sınırlar |
|---|---|---|
| Sorgu, sayfa, ülke, cihaz, tarih veya arama görünümüne göre tıklama, gösterim, CTR ve konum | Search Analytics | 16 aylık geçmiş, yaklaşık 2–3 gün gecikmeli; istek başına en fazla 25.000 satır ve arama türü başına günde 50.000 satır |
| Bir URL'nin dizinde olup olmadığı, son taranma zamanı ve Google'ın seçtiği standart URL | URL Inspection | Çağrı başına bir URL; mülk başına günde 2.000 çağrı |
| Site haritalarınız ve hataları | Sitemaps | Okumak için salt okuma erişimi yeterli; göndermek veya silmek için tam erişim gerekir |
| Görebildiğiniz mülkler | Sites | Mülk eklemek veya kaldırmak için tam erişim gerekir |
Search Console'daki bazı verilerin API'si yoktur, bu yüzden hiçbir MCP sunucusu onlara ulaşamaz:
- Yapay Zeka Bakışı ve Yapay Zeka Modu verileri. Google, üretken yapay zekâ performans raporunu 31 Ağustos 2026'da tüm sitelere açtı, ancak API referansında bu rapor için bir arama türü veya arama görünümü yer almıyor.
- Yeni rapor seçenekleri. Çok modlu arama türü ve marka sorguları filtresi de API referansında yok.
- Canlı bir sayfayı test etmek. URL Denetleme, Google dizinindeki sürümü raporlar. API belgelerinde "yayındaki bir URL'nin dizine eklenebilirliğini test edemezsiniz" deniyor.
- "Request indexing" düğmesi. Yalnızca Search Console'da bulunur. Bazı sunucuların çağırdığı ayrı Google Indexing API ise resmî olarak yalnızca iş ilanı ve canlı yayın sayfaları içindir.
Search Console'u Claude, Claude Code veya Codex'e bağlamanın üç yolu
| Yol | Kurulum | Verileriniz nereye gider | Maliyet |
|---|---|---|---|
| Kendiniz çalıştırdığınız topluluk sunucusu, ör. mcp-gsc | Google Cloud projesi, API, kimlik bilgileri ve bir yapılandırma girdisi | Bilgisayarınızdan Google'a | Ücretsiz |
| Barındırılan sunucu, ör. mcpsearchconsole.com | Google ile oturum açın, sunucu URL'sini yapay zekâ uygulamanıza yapıştırın | Sağlayıcının sunucuları üzerinden | Ücretsiz katman, sonra abonelik |
| Orkas'taki yerleşik bağlayıcı | Bağlan'a tıklayın, Google ile oturum açın | Bilgisayarınızdan Google'a | Bağlayıcı ücretsiz |
- Topluluk sunucuları ücretsizdir ve en çok işi onlar yapar. En popüleri olan AminForou/mcp-gsc, 9 Kasım 2026 itibarıyla GitHub'da 2.151 yıldıza sahipti. Kaynak kodunda 21 araç var; bunlar arasında dönem karşılaştırmaları, en fazla 10 URL'nin toplu denetimi ve izin verirseniz site haritası gönderme de bulunuyor. Bedeli kurulum: kendi Google kimlik bilgilerinizi oluşturmanız gerekiyor. r/TechSEO'daki bir yorumcu Google Cloud için "tek pürüz" dedi.
- Barındırılan sunucular, web'deki claude.ai veya ChatGPT'ye en hızlı giden yoldur. Bunlar uzak sunuculardır, bu yüzden URL ile eklenirler. Claude'un yardım merkezine göre özel bağlayıcılar her planda çalışıyor, ancak "Ücretsiz plan kullanıcıları tek bir özel bağlayıcıyla sınırlıdır." mcpsearchconsole.com, üç mülk için ayda 40 veri çekme hakkı veren ücretsiz bir plan, ardından KDV hariç aylık 4,99 € fiyat listeliyor. Search Console verileriniz sağlayıcının üzerinden geçtiği için önce gizlilik koşullarını okuyun.
- Yerleşik bir bağlayıcıyla Google Cloud kurulumunu atlarsınız. Orkas'ta Google ile oturum açarsınız ve bağlayıcı bilgisayarınızda çalışır. Salt okunurdur ve dört aracı vardır; bu, topluluk sunucularından daha azdır.
Topluluk sunucusunu kendiniz çalıştırın
Bu adımlar, 0.4.2 sürümü (6 Kasım 2026) itibarıyla mcp-gsc README'sini takip ediyor. Bu rehber için bir Google Cloud projesi oluşturmadık, bu yüzden başlamadan önce README'yi kontrol edin.
- Google kimlik bilgilerini oluşturun. Google Cloud konsolunda bir proje oluşturun, Search Console API'yi etkinleştirin ve "Desktop app" türünde bir OAuth istemci kimliği oluşturun. Bunun JSON dosyasını indirin. Otomasyon için bunun yerine bir hizmet hesabı oluşturun, ardından e-posta adresini Search Console'da Ayarlar → Kullanıcılar ve izinler bölümünden "Tam" izinle ekleyin.
- uv'yi yükleyin. README'nin önerdiği yol, sunucuyu
uvxile çalıştırır; o da Python işini sizin yerinize halleder. uv olmadan Python 3.11 veya daha yeni bir sürüm gerekir. - Sunucuyu ajanınıza ekleyin. Claude Code'da:
Codex'te:claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json --transport stdio gsc -- uvx mcp-search-console
İki komutu da Claude Code 2.1.311 ve Codex CLI 0.163.0 ile denedik. Claude Desktop veya Cursor için README,codex mcp add gsc --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json -- uvx mcp-search-consoleuvxyolunun tamamını içeren bir JSON yapılandırması veriyor; çünkü Dock'tan veya Başlat menüsünden açılan uygulamalar aksi hâlde onu bulamayabilir. - Bir kez oturum açın. İlk kullanımda Google ile oturum açmanız için bir tarayıcı penceresi açılır. 0.4.2'den beri sunucu,
GSC_ALLOW_DESTRUCTIVE=trueayarlamadığınız sürece yalnızca salt okuma erişimi ister.
Topluluk rehberlerinin değinmediği bir sorun var: OAuth izin ekranınız "External" olarak ayarlanmış ve "Testing" durumunda bırakılmışsa, Google'ın OAuth belgelerine göre yenileme jetonu 7 gün sonra geçerliliğini yitirir. Her hafta yeniden oturum açmanız gerekir. Bundan kaçınmak için uygulamayı üretime yayımlayın ya da bir hizmet hesabı kullanın. Yayımlanan bir uygulama "doğrulanmamış uygulama" uyarısı gösterebilir; Google, 100'den az kullanıcısı olan kişisel kullanım uygulamalarında bu uyarının geçilmesine izin veriyor.
Search Console'u Orkas'ta bağlayın
Orkas, birden fazla yapay zekâ ajanının tek bir sohbette çalıştığı, macOS ve Windows için bir masaüstü uygulamasıdır. Google Search Console bağlayıcısı yerleşik olarak gelir, yani bir Google Cloud projesine ihtiyacınız yoktur.
- Orkas'ı yükleyin ve oturum açın. macOS veya Windows için buradan indirin. Yeni hesaplar, Orkas'ın yerleşik modelleri için 500 ücretsiz kredi alır; bu yüzden başlamak için API anahtarına ihtiyacınız yok.
- Bağlayıcılar bölümünü açın. Kenar çubuğunda Bağlayıcılar öğesine tıklayın ve Google Search Console'u bulun. Veri filtresi veya arama kutusu sizi oraya götürür.
- Bağlan'a tıklayın ve Google ile oturum açın. Bağlan düğmesine tıklayın, mülkünüzü görebilen Google hesabını kullanın ve salt okuma erişimine izin verin. Kart Bağlı bölümüne geçer.
- İhtiyacınızı yazın. Bir sohbette @ yazıp Google Search Console bağlayıcısını seçin ya da görevi doğrudan anlatın. Ajan önce mülklerinizi listeler, ardından adını verdiğiniz mülkü sorgular.
- Salt okunurdur. Orkas, Google'dan yalnızca
webmasters.readonlykapsamını ister. Dört araç mülklerinizi listeler, performans verilerini sorgular, site haritalarını listeler ve bir URL'yi denetler. Yalnızca okuma yaptıkları için Orkas bunları her çağrı için onayınızı istemeden çalıştırır. Site haritası gönderemez veya dizine ekleme isteğinde bulunamazlar ve tek bir sorgu en fazla 25.000 satır döndürür. - Sorgular doğrudan Google'a gider. Bağlayıcı bilgisayarınızda çalışır ve Search Console API'yi doğrudan çağırır. Yalnızca Google ile oturum açma ve jeton yenileme, uygulamanın Google kimlik bilgilerini tutan Orkas sunucusundan geçer.
- SeoGeoAgent ve kodlama ajanlarınız da kullanabilir. Orkas'ın yerleşik SEO ajanı SeoGeoAgent, Search Console bağlandıktan sonra denetimlerinde gerçek tıklama, gösterim ve konum verilerinizi kullanır. Claude Code, Codex, OpenCode, Hermes veya OpenClaw'u yükleyip Orkas'a bağladıysanız, o araç bağlayıcıya kendi MCP kurulumu olmadan Orkas'ın araç köprüsü üzerinden ulaşır.
- Yazma erişimi mi gerekiyor? Bir topluluk sunucusunu yerel komut olarak eklemek için Bağlayıcılar sayfasındaki MCP sunucusu ekle seçeneğini kullanın. Orkas'ta ayrıca bir Bing Webmaster Tools bağlayıcısı da var.
Doğrulayabileceğiniz ilk denetim
İyi bir ilk istek, bir dakikada Search Console ile karşılaştırabileceğiniz rakamlar ister ve ajana verinin neyi kapsamadığını söyletir. Mülkü ve iki URL'yi kendinizinkilerle değiştirin:
sc-domain:example.com için Google Search Console bağlayıcısını kullan. Verisi tamamlanmış son 28 gün için: 1) tarihe göre toplam tıklama ve gösterim sayıları ve bunların ne kadarını sorgu satırlarının kapsadığı; 2) 5 ile 15 arasındaki konumlarda sıralanan, en az 100 gösterimi olan ve tıklama oranı %2'nin altında kalan sayfalar, gösterime göre sıralanmış olarak; 3) https://example.com/new-page/ ve https://example.com/old-page/ adreslerinin dizin durumu. Her tabloya tarih aralığını yaz ve verinin göstermediği hiçbir şeyi tahmin etme.
Bu isteği 9 Kasım 2026'da Orkas içindeki Claude Code ile denedik ve bağlayıcının dört aracının hepsi çalıştı. Kendi sitemizin Search Console verilerini yayımlamıyoruz; bu yüzden aşağıdaki sonuçlar sentetik bir örnek: example.com adresindeki hayalî bir mağaza için uydurulmuş rakamlar. Bu rakamlar, özenli bir cevabın neye benzediğini ve her bölümün nasıl kontrol edileceğini gösteriyor.
- Tarihe göre toplamlar (sentetik veri): 3.480 tıklama ve 151.200 gösterim. Sitenin tamamı için güvenilecek rakamlar bunlar. Kendinizinkini kontrol etmek için Performans raporunu açın, aynı özel tarih aralığını ve arama türünü seçin ve toplamları karşılaştırın. Sonuçlar birbirine yakın çıkmalı. Büyük bir fark genellikle ajanın bunun yerine sorgu veya sayfa satırlarını topladığı anlamına gelir.
- Sorgu satırları (sentetik veri): 1.670 tıklamayı kapsayan 642 satır, yani toplamın %48'i. Geri kalanı Google'ın anonimleştirdiği sorgulardan geliyor ve bu sorgular raporda da API'de de satır olarak görünmüyor. Bu büyüklükte bir pay normaldir: Ahrefs'in bulgularına göre anonimleştirilmiş sorgular Nisan 2025'te trafiğin %46,77'sini oluşturuyordu; birçok sitede bu oran daha da yüksek. Sorgu satırlarını toplayıp bunu trafiğiniz diye sunan bir ajan yarı yarıya yanılabilir.
- Düşük CTR'li sayfalar (sentetik veri): 5 ile 15 arasındaki konumlarda, en az 100 gösterimi olan ve CTR'si %2'nin altında kalan 9 sayfa. Bunların en büyüğü olan
/blog/linen-care/, ortalama 6,8 konumda 2.140 gösterim ve 21 tıklama aldı; yani CTR'si %1,0. Başlık ve açıklamalarına ilk bakılacak sayfalar bunlar. Siteniz dil sürümlerini?lang=ile biten adreslerde sunuyorsa her sürüm ayrı bir sayfa satırı alır; bu yüzden bunları gruplanmış olarak isteyin. - URL denetimi (sentetik veri): eski sayfa dizine eklenmiş, yenisi henüz eklenmemiş. Eylül ayında yayımlanan
https://example.com/old-page/"Submitted and indexed" durumundaydı ve en son 3 Ekim'de taranmıştı. Denetimden iki gün önce yayımlananhttps://example.com/new-page/ise "Discovered - currently not indexed" durumundaydı. Kontrol etmek için aynı URL'yi Search Console'un üst kısmındaki denetim kutusuna yapıştırın.
Sık takılınan beş nokta
- Sorgu satırlarını toplam trafik sanmak. Google'ın performans verileri rehberine göre anonimleştirilmiş sorguların satırı yoktur: "Tüm satırlardaki tıklamaları toplarsanız grafikteki toplamlarla aynı tıklama sayısını bulamazsınız." Toplamlar için sorgu filtresi olmadan tarihe göre veri isteyin.
- Sayfa toplamlarını site toplamlarıyla karşılaştırmak. Sayfaya göre gruplandığında, bir sonuçta görünen her URL ayrı sayılır. Mülke göre gruplandığında ise bir sonuç tüm site için bir kez sayılır. Bu yüzden sayfa satırlarının toplamı, site toplamından daha fazla gösterim verebilir.
- Gecikmeyi unutmak. Veriler "genellikle 2-3 gün sonra kullanılabilir". API, özellikle güncel veri istenmedikçe kesinleşmiş verileri döndürür; bu yüzden "son 7 gün" bugünden birkaç gün önce biter.
- Yanlış mülk adı kullanmak. Alan mülkü
sc-domain:example.comşeklinde yazılır. URL ön eki mülkü ise sondaki eğik çizgi dahil tam adrestir, örneğinhttps://example.com/. Önce ajanın mülklerinizi listelemesine izin verin ve döndürdüğü adı kopyalayın. - Bir seferde çok fazla şey istemek. Her istek en fazla 25.000 satır döndürür ve 16 aylık bir sorgu ve sayfa dökümü bu sınırı hızla doldurur. Özet, filtre veya daha kısa bir tarih aralığı isteyin; satırların hepsini sohbete yapıştırmak yerine ajanın onları kendisinin işlemesine izin verin.
Hangi yolu seçmelisiniz?
| Durumunuz | Seçim |
|---|---|
| claude.ai veya ChatGPT'yi tarayıcıda kullanıyorsunuz | URL ile eklenen barındırılan bir sunucu |
| Site haritası gönderme dahil tüm araçları istiyorsunuz ve Google Cloud sizi yıldırmıyor | mcp-gsc gibi bir topluluk sunucusu |
| Claude Code, Codex ve bir SEO ajanının Search Console'u Google Cloud olmadan okumasını istiyorsunuz | Orkas'ın yerleşik bağlayıcısı |
| Siteniz istek başına 25.000 satıra sığmayacak kadar büyük | Search Console'un BigQuery'ye toplu veri dışa aktarımı, MCP dışında |
Sorular
Google'ın resmî bir Search Console MCP sunucusu var mı?
Hayır, 9 Kasım 2026 itibarıyla yok. Search Console ne Google'ın resmî MCP sunucuları listesinde ne de Google Cloud'un MCP listesinde yer alıyor. Google, Google Analytics için bir MCP sunucusu yayımlıyor, ancak bu sunucu Search Console verilerini içermiyor.
Search Console MCP ücretsiz mi?
Search Console API ücretsizdir; mcp-gsc gibi topluluk sunucuları ve Orkas'ın bağlayıcısı da öyle. Barındırılan sunucuların genellikle aylık sınırı olan ücretsiz bir katmanı ve ücretli bir planı vardır. Bağladığınız yapay zekâ ajanının ise kendi maliyeti vardır, örneğin bir Claude planı ya da Orkas kredileri.
Bir MCP sunucusu site haritası gönderebilir veya dizine ekleme isteğinde bulunabilir mi?
Search Console'da tam erişimi varsa site haritası gönderebilir veya silebilir; bazı topluluk sunucuları bunu sunuyor. Search Console API'de "Request indexing" işlevi yoktur, bu yüzden sıradan sayfalar için bunu hiçbir sunucu yapamaz. Orkas'ın bağlayıcısı salt okunurdur ve ikisini de yapmaz.
MCP rakamları neden Search Console ile eşleşmiyor?
Genellikle ajan, anonimleştirilmiş sorguları dışarıda bırakan sorgu satırlarını topladığı ya da sayfaya göre toplamlarla mülke göre toplamları karıştırdığı için. Sorgu filtresi olmadan, rapordakiyle aynı tarihler ve aynı arama türüyle tarihe göre toplamları isteyin. Bu durumda toplamlar birbirine yakın çıkmalıdır.
Claude Code ve Codex ile çalışır mı?
Evet. Bir topluluk sunucusunu claude mcp add veya codex mcp add ile, barındırılan bir sunucuyu ise URL ile ekleyin. Orkas'ta Claude Code ve Codex, yerleşik Search Console bağlayıcısını Orkas'ın araç köprüsü üzerinden kullanır; iki araçta da ayrıca kurulum gerekmez.
Agentic SEO nedir, nasıl kurulur? yazısı büyük resmi anlatıyor: bir ajan SEO işini canlı veriler üzerinde yürütür, yayına neyin çıkacağını ise bir insan onaylar.