Search Console MCP nedir? Kurulum, izinler ve neyi yapıp yapmadığı
Asistanına "hangi sorgular düştü" ya da "bu sayfa dizinde mi" gibi sorular sorarsın; Search Console MCP (mcp-gsc) Google Search Console'daki sorgu ve sayfa performansını, URL dizinleme durumunu ve site haritalarını getirir. Amin Foroutan adlı bir bireyin MIT lisanslı açık kaynak projesi, Google'ın resmî ürünü değil. Sunucu Google'dan tam yetkili "webmasters" kapsamını ister; varsayılanda site haritası gönderme açıktır, mülk ekleme/silme ve site haritası silme kapalıdır. Dizinleme isteği (Request Indexing) gönderen bir araç yoktur. Yerel çalıştığı için claude.ai web sitesinde değil, Claude Desktop uygulamasında kullanılır.
- Ne yapar
- Asistana Search Console verini sordurur
- Tür
- MCP sunucusu (yerel, açık kaynak)
- Yapımcı
- Amin Foroutan (topluluk, Google değil)
- Silme
- Varsayılanda kapalı
- Kapsam
- Tam yetkili webmasters; salt okuma jetonu çalışmıyor
- Nerede
- Claude Desktop, Cursor, Codex CLI
- Ücret
- Ücretsiz, MIT
Search Console MCP ne işe yarar?
MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır. Bu sunucuyla asistan Google Search Console hesabındaki mülklerini listeler; sorgu, sayfa, ülke ve cihaz kırılımında tıklama, gösterim, CTR ve konum verisini çeker; iki tarih aralığını karşılaştırır; URL'lerin Google dizinindeki durumuna bakar; site haritalarını listeler ve gönderir.
Tam yetkili webmasters kapsamı ister; silme araçları varsayılanda kapalı.
Araç sayısı kaynaklarda farklı: kodda 21 araç tanımlı, README "20" diyor. Bu yüzden tek sayı verilmiyor.
!Dizinleme isteği (Request Indexing) gönderen bir araç yok. URL denetimi yalnız Google dizinindeki sürümü gösterir; canlı URL testi yapılamıyor.
Kime yarar: Search Console raporlarını elle gezmek yerine asistana sormak isteyen SEO çalışanlarına ve site sahiplerine.
Search Console MCP nasıl kurulur?
Gerekenler: bir Google Cloud projesi (Search Console API etkin), OAuth istemci dosyası (masaüstü uygulaması türünde) ya da servis hesabı anahtarı, bir Search Console mülkü ve uv/uvx. Python 3.11 veya üstü gerekir; uvx bunu kendisi yönetir. Adımlar README'den alındı.
- Google Cloud Console'da proje oluştur ya da seç, Search Console API'yi etkinleştir.
- Credentials › OAuth client ID oluştur (uygulama türü Desktop app) ve JSON dosyasını kalıcı bir yere indir.
- uv'yi kur (README macOS ve Linux komutunu veriyor:
curl -LsSf https://astral.sh/uv/install.sh | sh). - İstemcinin yapılandırma dosyasına sunucuyu ekle (aşağıdaki örnek), uygulamayı tamamen kapatıp aç.
- İlk kullanımda tarayıcı açılır; Google hesabınla giriş yap, jeton kaydedilir.
› {"mcpServers":{"gscServer":{"command":"/FULL/PATH/TO/uvx","args":["mcp-search-console"],"env":{"GSC_OAUTH_CLIENT_SECRETS_FILE":"/full/path/to/client_secrets.json"}}}}Servis hesabı yolunda anahtarı indirip hesabın e-postasını Search Console › Ayarlar sonra Kullanıcılar ve izinler'den mülke "Full access" ile eklersin, ortam değişkenleri GSC_CREDENTIALS_PATH ve GSC_SKIP_OAUTH=true olur. Cursor için aynı girdi ~/.cursor/mcp.json dosyasına, Codex CLI için ~/.codex/config.toml içinde [mcp_servers.gscServer] altına yazılır.
Dosya yolları mutlak olmalı; uvx göreli yolla çalışmaz. README yalnız macOS yapılandırma yolunu veriyor; Windows yolu ve uv kurulum komutu README'de yok. Atlas kartındaki Claude Code kurulum satırı README'de yok; Gemini CLI ve Antigravity yalnız giriş cümlesinde anılıyor.
Search Console MCP nasıl kullanılır?
Bağlandıktan sonra isteği normal yazarsın. Sorun olursa asistana "get_capabilities çağır" de; araçları ve kimlik doğrulama durumunu listeler.
Google kotaları: Search Analytics için mülk başına dakikada 1.200 sorgu; URL denetimi için mülk başına günde 2.000 ve dakikada 600 sorgu (Google belgesi). Domain mülkleri sc-domain:ornek.com biçiminde yazılır.
Search Console MCP nerede çalışır?
| Claude DesktopVar | README'de örnek var; yapılandırma sonrası uygulamayı tamamen kapatıp aç. |
|---|---|
| Cursor, Codex CLIVar | README'de örnek var. |
| Gemini CLI, AntigravityNet değil | Yalnız giriş cümlesinde anılıyor, örnek yok. |
| Claude CodeNet değil | README'de kurulum örneği yok. |
| claude.ai web sitesiYok | README: sunucu yerel çalışır, tarayıcıdaki claude.ai'da kullanılamaz. |
Search Console MCP neye erişir, siteye yazar mı?
Hesaba açık Search Console mülkleri, arama analitiği, URL denetimi sonuçları, site haritası listesi ve hataları.
Site haritası gönderme varsayılanda AÇIK. Mülk ekleme yalnız GSC_ALLOW_DESTRUCTIVE=true ile. OAuth jetonu bilgisayarındaki yapılandırma klasörüne yazılır.
Mülk silme ve site haritası silme yalnız GSC_ALLOW_DESTRUCTIVE=true ile; varsayılan kapalı. URL kaldırma ya da dizinleme isteği aracı yok.
Sunucu bilgisayarında çalışır ve Google API'leriyle konuşur; kodda başka dış sunucuya veri gönderen çağrı yok. Ama sorduğun her sonucun metni kullandığın yapay zekâ hizmetine gider.
!Sunucu Google'dan salt okuma değil, tam yetkili "webmasters" kapsamını ister ve kodda sabit yazılı; salt okuma jetonuyla çalışmıyor ve hata sonrası jeton dosyası siliniyor (issue #56). Servis hesabı yolunda hesabı mülke "Full access" ile eklersin; anahtar dosyasını bulan herkes bu yetkiyle işlem yapabilir, dosyayı koru. Mülke kullanıcı eklemek için mülk sahibi olman gerekir.
MCP_TRANSPORT=sse ile ağ üzerinden sunulabilir; kodda kimlik doğrulama yok, bu kipi açık ağda çalıştırma. Güvenlik danışmanlığı taraması yapılmadı; kayıtlı uyarı olup olmadığı bilinmiyor. Bu "güvenli" demek değildir.
Search Console MCP ücretsiz mi?
Proje ücretsiz ve MIT lisanslı. Google'ın Search Console API kota sayfası ücret söylemiyor. README'nin başında aynı yazarın barındırılan ücretli sürümüne reklam bağlantısı var; fiyatı için o sürümün kendi sayfasına bak. TL fiyatı yok.
Sık sorunlar ve çözümleri
| Ne oluyor | Ne yapmalı |
|---|---|
| spawn uvx ENOENT ya da command not found: uvx | GUI uygulamalar kabuk ayarını okumaz; yapılandırmada command yerine uvx'in tam yolunu yaz. |
| Kimlik doğrulama başarısız ya da dosya bulunamadı | Dosya yolu mutlak olmalı. Asistana get_capabilities çağırt; hesap değiştirmek için reauthenticate aracı var. |
| Araçlar hiç görünmüyor | Python 3.11+ gerekir; GUI istemcide eski sürümle sessizce başlamaz. |
| Kullanıcıların bildirdiği Hata mesajları başarılı sonuç gibi dönüyor | Açık kayıt (#53); sonuç metni Error ile başlıyorsa hatadır. |
Search Console MCP nasıl kaldırılır?
- İstemcide: Yapılandırma dosyasından gscServer girdisini sil ve uygulamayı tamamen kapatıp aç.
- Jeton: reauthenticate aracı yerel jeton dosyasını siler; elle de silebilirsin.
- Google erişimi: Google Hesabı › Güvenlik'teki üçüncü taraf erişim listesinden kaldır (Google'ın olağan hesap ekranı; projenin belgesi yazmıyor). Servis hesabı için Search Console › Kullanıcılar ve izinler'den hesabı çıkar.
- Dosyalar: İndirdiğin client_secrets.json ve service_account.json dosyalarını sil; Cloud Console'da istemciyi ya da anahtarı iptal et.
Sık sorulan sorular
Search Console MCP Google'ın resmî aracı mı?
Hayır. mcp-gsc, Amin Foroutan'ın açık kaynak topluluk projesidir. Google'ın resmî kaynaklarında MCP sunucusu olarak sunulan bir ürün görünmüyor.
Search Console verime yazıyor mu, bir şeyi silebilir mi?
Varsayılanda yalnız okur, bir istisnayla: site haritası gönderme açıktır. Mülk ekleme ve silme ile site haritası silme GSC_ALLOW_DESTRUCTIVE=true olmadan çalışmaz. Sunucu yine de Google'dan tam yetkili kapsam ister.
Dizinleme isteği gönderebilir mi?
Hayır; Request Indexing yapan bir araç yok. URL denetimi yalnız Google dizinindeki durumu gösterir.
claude.ai web sitesinde çalışır mı?
Hayır. README sunucunun yerel çalıştığını ve Claude Desktop uygulamasında kullanılabildiğini, tarayıcıdaki claude.ai'da kullanılamadığını yazıyor.
Servis hesabına Full access vermek ne demek?
Hesap mülkte tam kullanıcı gibi davranır. Anahtar dosyasını bulan herkes bu yetkiyle işlem yapabilir; dosyayı koru. Mülke kullanıcı eklemek için mülk sahibi olmak gerekir.
Google API kotası ne kadar?
Google belgesine göre Search Analytics için mülk başına dakikada 1.200 sorgu; URL denetimi için mülk başına günde 2.000 ve dakikada 600 sorgu. Kotayı aşarsan quota exceeded alırsın.
İlgili rehberler
Kaynaklar
Resmî kaynaklarda net olmayanlar: Search Console API ücreti · OAuth onay ekranı "Testing" durumunun sonuçları · hangi mülk rolünün hangi çağrıya izin verdiği · Windows yapılandırma yolu ve jeton konumu · barındırılan ücretli sürümün fiyatı ve gizliliği · güvenlik danışmanlığı taraması (yapılmadı) · Türkçe bilgi. Her biri ilgili bölümde yazılı.