GSC Wizard MCP sunucusu, Google Search Console, Bing Webmaster, GA4 ve Merchant Center verilerini Claude'a sunan, uzaktan erişilen, OAuth korumalı bir Model Context Protocol kaynağıdır. Bu sayfa teknik referanstır: taşıma katmanı, kimlik doğrulama zinciri, araç yüzeyi, yanıt sözleşmesi, okumaların nasıl yönlendirildiği ve sınırlar.
Adım adım kurulumu tercih ediyorsanız Claude bağlantı rehberini kullanın. Tüm istemcileri kapsayan ürün genel bakışı için Google Search Console MCP sayfasına bakın.
https://mcp.gscwizard.com/mcp
Streamable HTTP
OAuth 2.1 (DCR + PKCE) or Bearer key
128 · 96 read / 32 write
Sunucu, Streamable HTTP üzerinden MCP konuşur. Yalnızca SSE kullanan bir yedek uç nokta yoktur; kullanımdan kaldırılmış HTTP+SSE çiftini hâlâ varsayan istemciler, akışı istek başına müzakere eden tek /mcp yoluna yönlendirilmelidir.
| Yol | Kimlik doğrulama | Amaç |
|---|---|---|
POST /mcp | Gerekli | Streamable HTTP üzerinden JSON-RPC |
/v1/* | Gerekli | MCP kullanmayan çağıranlar için REST yüzeyi |
GET /health | Herkese açık | { ok, sessions } döndürür |
GET /, /docs | Herkese açık | Oluşturulmuş araç kataloğu |
/.well-known/oauth-protected-resource | Herkese açık | RFC 9728 kaynak meta verileri |
Oturum sürekliliği, istemcinin sonraki isteklerde geri gönderdiği Mcp-Session-Id yanıt başlığıyla sağlanır. Her oturum, sunucu tarafında onu açan user_id'ye bağlanır. Bir oturum kimliğinin farklı bir kimlik bilgisiyle yeniden sunulması sessizce yeniden bağlanmak yerine reddedilir; dolayısıyla sızdırılmış bir oturum kimliği tek başına bir hesabı okumak için yeterli değildir.
MCP stdio, MCP Streamable HTTP ve /v1 adresindeki REST API, hepsi aynı runTool() işlem hattı üzerinden çalışır. Yetkilendirme, argüman doğrulama, mülk başına erişim izni denetimi, abonelik kapısı, hız sınırlayıcı ve denetim kaydı yalnızca bu tek yerde uygulanır; böylece taşıma katmanları arasında birbirinden sapamaz. Kayıt defterine eklenen bir araç, üçünde de erişilebilir olur ve aynı şekilde yönetilir.
İstemcinin yeteneğine göre seçilen iki mekanizma. Claude'un Bağlayıcılar arayüzü OAuth 2.1 kullanır; yapılandırma dosyası kullanan ve başsız çalışan istemciler sabit bir API anahtarı sunar.
MCP sunucusu kaynak sunucusudur; tool.gscwizard.com adresindeki uygulama ise yetkilendirme sunucusudur. Claude zinciri gözetimsiz izler:
Kaynağa yapılan kimliği doğrulanmamış bir GET isteği, yetkilendirme sunucusunu ve kapsamları bildirir.
Claude, uç noktaları bulmak için yayımcıdan /.well-known/oauth-authorization-server adresini çeker.
Claude kendini kaydeder ve kendi istemci kimliğini alır. İstemci kimliği ve gizli anahtar alanlarının bu yüzden boş bırakılması gerekir: bağlayıcıyı eklerken bunları doldurmak kaydı engeller ve akışı bozar.
S256 challenge'lı, yenilenebilir bir authorization_code akışı. Google ile oturum açma ve onay, yetkilendirme sunucusunda gerçekleşir, hiçbir zaman Claude içinde değil.
Kaynak meta verileri
GET https://mcp.gscwizard.com/.well-known/oauth-protected-resource
{
"resource": "https://mcp.gscwizard.com/mcp",
"authorization_servers": ["https://tool.gscwizard.com"],
"scopes_supported": ["mcp:read", "mcp:write"],
"bearer_methods_supported": ["header"]
}Yetkilendirme sunucusu meta verileri
GET https://tool.gscwizard.com/.well-known/oauth-authorization-server
{
"issuer": "https://tool.gscwizard.com",
"authorization_endpoint": "https://tool.gscwizard.com/oauth/authorize",
"token_endpoint": "https://tool.gscwizard.com/api/oauth/token",
"registration_endpoint": "https://tool.gscwizard.com/api/oauth/register",
"revocation_endpoint": "https://tool.gscwizard.com/api/oauth/revoke",
"scopes_supported": ["mcp:read", "mcp:write"],
"response_types_supported": ["code"],
"grant_types_supported": ["authorization_code", "refresh_token"],
"code_challenge_methods_supported": ["S256"],
"token_endpoint_auth_methods_supported": [
"none", "client_secret_post", "client_secret_basic"
]
}Token verilmeden önce iki kapı. Yetkilendirme uç noktası, etkin bir abonelik ve bağlı en az bir Search Console mülkü gerektirir. İkisi de olmayan bir hesap, sonraki her araç çağrısının reddedeceği bir token almak yerine önce bunları tamamlamaya yönlendirilir.
Anahtarların öneki gscw_live_'dır; Hesap → API anahtarları altında oluşturulur ve Authorization: Bearer olarak sunulur. Yalnızca SHA-256 karması saklanır; bu yüzden düz metin oluşturma anında bir kez gösterilir ve sonradan geri alınamaz. Anahtarı yenilemek, yeni bir anahtar vermek ve eskisini iptal etmek anlamına gelir.
Her anahtar, oluşturulurken sabitlenen bir kapsam taşır. Okuma kapsamlı bir anahtar bir değiştirme aracını çağıramaz: denetim, işleyiciden önce işlem hattında çalışır; yani salt okunur olmak, modelin ikna edilerek aşılabileceği bir talimat değil, kimlik bilgisinin yapısal bir özelliğidir.
Dört Claude yüzeyi, üç farklı bağlantı mekanizması.
Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle. URL'yi girin ve iki OAuth alanını da boş bırakın.
URL: https://mcp.gscwizard.com/mcp
OAuth Client ID: (leave blank)
OAuth Secret: (leave blank)Tek bir komut, uzak sunucuyu bir anahtar başlığıyla kaydeder. Bir oturum içinde /mcp ile doğrulayın.
claude mcp add --transport http gsc-wizard \
https://mcp.gscwizard.com/mcp \
--header "Authorization: Bearer gscw_live_..."Masaüstü yapılandırma dosyası yalnızca yerel stdio sunucularını başlatır; bu yüzden bir "type": "http" girdisi doğrulamadan geçemez. OAuth yerine sabit bir anahtara ihtiyacınız varsa uzak sunucuyu mcp-remote üzerinden köprüleyin (Node.js gerekir).
{
"mcpServers": {
"gsc-wizard": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.gscwizard.com/mcp",
"--header", "Authorization: Bearer gscw_live_..."
]
}
}
}Bunu ajan seçeneklerinde bir HTTP MCP sunucusu olarak tanımlayın; SDK, JSON-RPC el sıkışmasını yönetir.
mcpServers: {
"gsc-wizard": {
type: "http",
url: "https://mcp.gscwizard.com/mcp",
headers: { Authorization: `Bearer ${process.env.GSCW_API_KEY}` }
}
}Gözetimsiz çalışan her şey için okuma kapsamlı bir anahtar kullanın. Ajanın yalnızca bir avuç araca ihtiyacı varsa izin verilen araç listesini istemci tarafında da kısıtlayın: daha küçük bir yüzey tur başına daha ucuzdur ve getirilen sayfa içeriğindeki bir istem enjeksiyonunun ulaşabileceği alanı daraltır.
128 kayıtlı araç: 96 okuma ve 32 değiştirme aracı; hepsi her hesap için kullanılabilir. Her araç MCP ek açıklamalarını (readOnlyHint, destructiveHint, openWorldHint, title) bildirir; böylece istemci, adları koda gömmeden bunları gösterebilir veya denetleyebilir.
| Grup | Örnek araçlar | Kapsam |
|---|---|---|
| Arama analizleri | query_search_analytics, query_top_queries, query_top_pages, query_countries, query_devices | okuma |
| Analiz | find_decaying_content, analyze_cannibalization, get_ranking_changes, score_opportunities, analyze_ctr_curve | okuma |
| Tespit | detect_anomalies, detect_change_points, forecast_traffic, get_decay_overview | okuma |
| Dizine ekleme | inspect_url, bulk_inspect_urls, get_indexing_tracker, list_sitemaps | okuma |
| Diğer kaynaklar | Bing Webmaster, GA4, Yandex, Merchant Center, Core Web Vitals | okuma |
| Değiştirme araçları | submit_sitemap, submit_indexnow_urls, create_topic_cluster, create_annotation, add_site | yazma |
Analiz sunucu tarafında çalışır. Değer kaybı, yamyamlık, TO eğrisi modelleme, değişim noktası tespiti ve fırsat puanlama sunucuda hesaplanır ve sonuç olarak döndürülür. Model, istatistiksel olarak üzerinde akıl yürütmesi gereken ham bir döküm değil, sonuçları ve arkasındaki satırları alır; bu hem tur başına daha ucuzdur hem de aritmetik sapmaya maruz kalmaz.
Argüman şemaları ve örnek yüklerle birlikte araç başına tam katalog mcp.gscwizard.com adresinde gösterilir ve kayıt defterine karşı kapsam testinden geçer; dolayısıyla gerçekte kayıtlı araçların gerisinde sessizce kalamaz.
Risk satır sınırları değil, açıklanmayan sınırlardır. Tam olarak limit kadar satır alan bir model, eksiksiz bir yanıtı kırpılmış bir yanıttan ayırt edemez ve kendinden emin biçimde "sitenizde 100 sorgu var" diye rapor eder. Bu yüzden satır sınırlı araçlar fazladan bir yoklama satırı çeker, en fazla limit kadarını döndürür ve pencereyi, daha fazlasının olup olmadığını ve tam olarak bir sonraki çağrıyı belirten bir blok ekler.
"pagination": {
"limit": 100,
"offset": 0,
"returned": 100,
"hasMore": true,
"note": "Showing rows 1-100. Call again with offset: 100 for the next page."
}query_search_analytics varsayılan olarak ilk değer olan 1.000 yerine 100 satır döndürür: 1.000 satırda tek bir çağrı yaklaşık 58k token döndürüyordu; bu, tüm araç listesinden daha fazla bağlamdır. Sıralı analiz araçları ortak analiz çekirdeğinin içinde sınırlanır ve sayfalama bloğu taşımaz.
Hiçbir araç, çağıranın bugünün tarihini bilmesini gerektirmez. Belirtilmeyen pencereler, yaklaşık üç günlük Search Console raporlama gecikmesi hesaba katılarak son 28 oturmuş güne ayarlanır; karşılaştırma tabanı da varsayılan olarak aynı uzunluktaki önceki dönemdir. Tarih ayrıştırıcı ayrıca LLM istemcilerinin sık ürettiği null, "null" ve "" değerlerini doğrulama hatası vermek yerine "varsayılanı kullan" olarak yorumlar; bu da bir yeniden deneme döngüsü sınıfını tümüyle ortadan kaldırır.
| Alan | Anlam |
|---|---|
dataSource | clickhouse veya api: bu okumayı hangi yolun sunduğu |
settledThrough | Eksiksiz verinin bulunduğu son tarih |
dataMaturity | İlk eksik tarih, baz saat dilimi, kullanılan yoklama |
note | Modelin aktarması için düz yazı biçiminde güncellik uyarısı |
Bunlar, bir yanıtın kaynağının belirtilebilmesi için vardır. Claude geçen hafta trafiğin düştüğünü söylediğinde, gerçek bir düşüşü raporlama gecikmesinden ayıran şey settledThrough'dur; bu da otomatik Search Console analizindeki en yaygın yanlış alarmdır.
Okumaların çoğu Search Console API'sine gitmez. Geçmiş performans verileri bir ClickHouse veri ambarına alınır ve uygun okumalar buradan sunulur: API'nin 16 aylık penceresinden daha uzun geçmiş ve yüksek kardinaliteli mülklerde API tarafı örnekleme yok.
Sekiz arama analizi aracı (query_search_analytics, query_top_queries, query_top_pages, query_countries, query_devices, get_site_summary, get_query_performance, get_page_performance) ve on bir analiz aracı.
searchAppearance, googleNews türü, üç veya daha fazla ayrı boyut ya da sayfalama gerektiren istekler. Ayrıca geçmiş veri dolumu tamamlanmamış her mülk.
Yönlendirme otomatiktir ve istek başınadır; çağıran seçmez. Veri ambarı okumaları salt okunur bir rol ve hesaba bağlı bir satır ilkesi kullanır; yani kiracı sınırı yalnızca sorgu oluşturucu tarafından değil, veritabanı tarafından da uygulanır. Sunucu, bir okuma yolunda veri ambarına hiçbir zaman yazmaz.
Claude için pratik sonuç: veri ambarı gerçek zamanın yaklaşık iki gün gerisindedir, canlı API ise yaklaşık üç gün; veri ambarından sunulan yanıtlar bunu note alanında belirtir. "Geçen hafta" dediğinizde, düşüş gibi gösterilen kısmi bir kuyruk değil, eksiksiz haftalar alırsınız.
| Yüzey | Dakikada | Saatte |
|---|---|---|
| MCP | 60 | 1.000 |
REST /v1 | 180 | 2.000 |
Kullanıcı başına ve yüzey başına sayılır. Kısıtlanan bir çağrı hangi pencerenin aşıldığını ve kaç saniye beklenmesi gerektiğini bildirir; böylece bir ajan tahmin yürütmek yerine tam olarak geri çekilebilir. URL denetimlerinin Google'dan gelen ayrı bir günlük kotası vardır; get_inspection_quota ile okunabilir.
| Koşul | Davranış |
|---|---|
| Okuma anahtarı bir yazma aracını çağırıyor | İşleyici çalışmadan reddedilir |
| Mülk bağlı değil veya erişim izni verilmemiş | Erişim izni denetimi gerekçesiyle birlikte reddeder |
| Entegrasyon yapılandırılmamış | Hata vermek yerine bir gerekçeyle birlikte notConfigured: true döndürür |
| Oturum kimliği başka kimlik bilgileriyle yeniden kullanılıyor | Reddedilir, yeniden bağlanmaz |
| Yeni Google OAuth, mülk henüz yayılmamış | Google kısa bir süre 403 döndürür; bağlandıktan kısa süre sonra yeniden deneyin |
notConfigured kuralı ajanlar için önemlidir: yapılandırılmamış bir GA4 veya Merchant Center bağlantısı, yeniden denenecek bir istisna değil, raporlanacak bir durumdur; ikisini ayırt etmek, bir döngünün hiçbir yeniden denemenin çözemeyeceği bir koşul için hız sınırını tüketmesini önler.
Google kimlik bilgileri Claude'a hiçbir zaman ulaşmaz. Search Console token'ları sunucu tarafında tutulur, bekleme halinde şifrelenir ve sunucu tarafından yenilenir. Claude, Google'a değil GSC Wizard'a ait kapsamlı bir token veya anahtar tutar.
Kapsam yapısaldır. Okuma kapsamlı bir kimlik bilgisi bir değiştirme işleyicisine ulaşamaz. Bu, ortak işlem hattında uygulanır; dolayısıyla MCP'de ve REST'te aynı şekilde geçerlidir.
Anahtarlar karmalanır. Yalnızca SHA-256; düz metin bir kez gösterilir. İptal anında gerçekleşir.
Her çağrı denetim kaydına yazılır, başarılı da olsa başarısız da: okumalar argümanlar olmadan, yazmalar argümanlarla birlikte. Bir ajanın eylemleri sonradan yeniden oluşturulabilir.
Mülk erişimi izin bazlıdır. Claude yalnızca hesaba bağlı mülkleri görür; paylaşılan mülkler kendi izinlerini taşır ve bunlara, sahibin tarama bütçesini harcayamayan salt okunur izin sahipleri de dahildir.
Gözetimsiz bir ajan için önerilen yapılandırma, okuma kapsamlı bir anahtar ile işin ihtiyaç duyduğu belirli araçların istemci tarafı izin listesidir. Bu kombinasyon, ajanın getirdiği herhangi bir içerik üzerinden gelen bir istem enjeksiyonunun etki alanını sınırlar.
Çoğunlukla bir istemci kimliği veya gizli anahtar doldurulmuştur. Sunucu dinamik istemci kaydı kullandığından iki alan da boş olmalıdır. Bağlayıcıyı kaldırın, yalnızca URL ile yeniden ekleyin ve Claude'un kendini kaydetmesine izin verin.
Yetkilendirme uç noktasının uyguladığı iki kapıyı kontrol edin: etkin bir abonelik ve hesaba bağlı en az bir Search Console mülkü. Bağlı mülkü olmayan bir hesaba verilen token'ın okumasına izin verilen hiçbir şey yoktur.
Yapılandırma dosyası yalnızca yerel stdio süreçlerini başlatır; bu yüzden "type": "http" geçerli bir girdi değildir. Bağlayıcılar arayüzünü kullanın veya yukarıda gösterildiği gibi npx -y mcp-remote üzerinden köprüleyin.
Google'ın yeni verilen bir Search Console yetkisini yaymak için kısa bir süreye ihtiyacı vardır. Bağlandıktan sonraki ilk dakikalarda gelen bir 403 genellikle bir izin hatası değil, yayılma gecikmesidir; OAuth akışını yeniden çalıştırmadan önce tekrar deneyin.
Yanıttaki dataSource ve settledThrough alanlarını kontrol edin. Veri ambarından sunulan bir okuma ile aynı nominal aralığın arayüzdeki görünümü farklı tarihlerde bitebilir; ayrıca arayüzün kendisi yüksek kardinaliteli sorgu raporlarını örneklerken veri ambarı örneklemez.
Genellikle hiçbir yeniden denemenin çözemeyeceği bir notConfigured yanıtına karşı yeniden deneme döngüsü ya da tek bir analiz aracının tek çağrıda yanıtlayabileceği işi sayfa sayfa yinelemektir. Satır çekip bunlar üzerinde akıl yürütmek yerine sunucu tarafı analiz araçlarını tercih edin.
https://mcp.gscwizard.com/mcp adresinde Streamable HTTP. Oturum sürekliliği Mcp-Session-Id yanıt başlığıyla sağlanır ve her oturum sunucu tarafında onu açan kullanıcıya bağlanır; bu yüzden farklı kimlik bilgileriyle yeniden kullanılan bir oturum kimliği reddedilir. Yerel derlemeler için bir stdio giriş noktası vardır ve /v1 adresindeki bir REST yüzeyi, aynı işlem hattı üzerinden düz HTTP+JSON sunar.
MCP sunucusu OAuth 2.1 kaynak sunucusudur ve yetkilendirme sunucusu olarak tool.gscwizard.com adresini belirten RFC 9728 korumalı kaynak meta verilerini yayımlar. Claude daha sonra bu yayımcıdan RFC 8414 meta verilerini okur, RFC 7591 dinamik istemci kaydı ile kendini kaydeder ve PKCE S256 ile bir authorization_code akışı çalıştırır. İstemci kimliği ve gizli anahtar alanlarının boş bırakılmasının nedeni budur.
mcp:read ve mcp:write. Bearer token'lar yalnızca Authorization başlığında kabul edilir. API anahtarları aynı ayrımı oluşturma sırasında sabitlenen bir kapsam olarak taşır: bir okuma anahtarı bir değiştirme aracını çağıramaz; yani kapı bir istem talimatı değil, yapısaldır.
128 kayıtlı araç: 96 okuma ve 32 değiştirme aracı; hepsi her hesap için kullanılabilir. Üç yüzeyin tümü tek bir runTool() işlem hattı üzerinden çalışır; dolayısıyla yetkilendirme, doğrulama, erişim izni denetimi ve denetim kaydı aralarında birbirinden sapamaz.
Claude Desktop yapılandırma dosyası yalnızca yerel stdio sunucularını başlatır; bu yüzden uzak bir HTTP girdisi doğrulamadan geçemez. Ya OAuth üzerinden Streamable HTTP'yi yerel olarak konuşan Bağlayıcılar arayüzünü kullanın ya da uzak sunucuyu, Node.js gerektiren ve bunun yerine sabit bir gscw_live_ API anahtarı sunmanıza izin veren npx mcp-remote üzerinden köprüleyin.
MCP yüzeyi kullanıcı başına dakikada 60, saatte 1.000 çağrıya izin verir. /v1 adresindeki REST yüzeyi dakikada 180, saatte 2.000 çağrıya izin verir. Sınırlar kullanıcı başına ve yüzey başına sayılır; kısıtlanan bir çağrı, yeniden denemeden önce beklenecek saniye sayısını döndürür.
Okumaların çoğunda hayır. Sekiz arama analizi aracı ve on bir analiz aracı, hesabın geçmiş Search Console verilerini tutan bir ClickHouse veri ambarına otomatik yönlendirilir; bu da daha uzun geçmiş sağlar ve API'nin örneklemesinden kaçınır. Her yanıt, clickhouse veya api değerli bir dataSource alanı taşır; veri ambarından sunulduğunda ayrıca settledThrough ve bir güncellik notu içerir. searchAppearance, googleNews türü, üç veya daha fazla ayrı boyut ya da sayfalama gerektiren istekler her zaman canlı API'ye döner.
Satır sınırlı araçlar fazladan tek bir yoklama satırı çeker ve pencereyi, daha fazla satır olup olmadığını ve tam olarak bir sonraki çağrıyı belirten bir sayfalama bloğu döndürür. Tasarımla ortadan kaldırılan hata türü sessiz kırpmadır: tam olarak limit kadar satır alan bir model, eksiksiz bir yanıtı kırpılmış bir yanıttan ayırt edemez. query_search_analytics varsayılan olarak 100 satır döndürür, çünkü 1.000 satırda tek bir çağrı yaklaşık 58k token döndürüyordu; bu, tüm araç listesinden daha fazla bağlamdır.
Claude web, masaüstü ve Claude Code için adım adım kurulum rehberi.
Ürün genel bakışı: sunucunun her MCP istemcisinde neler yaptığı.
Aynı sunucunun GA4 yüzeyi: oturumlar, temel etkinlikler, e-ticaret ve LLM trafiği.
Aynı sunucunun Yandex yüzeyi: site kalite endeksi, sorgular ve dizine ekleme geçmişi.
Aynı sunucunun alışveriş yüzeyi: ücretsiz listelemeler, ürün sorunları, fiyatlar ve bir feed denetimi.
Claude'un yanı sıra Cursor, VS Code, Windsurf, Gemini, Grok ve ChatGPT.
Aynı veriler Gemini uygulamasında, Antigravity CLI'da, Gemini Enterprise'da veya Gemini API'de.
Bu sunucu ve bir tarayıcı MCP'si üzerine kurulu, gözetimsiz çalışan uygulamalı bir ajan örneği.
Birinci taraf veri sunucularının üçüncü taraf platformlarla karşılaştırması.
Tek bir uç nokta, OAuth veya kapsamlı bir anahtar ve zaten sahip olduğunuz mülkler üzerinde çalışan 128 araç.
Pratik GSC ve GA4 iş akışları, ürün güncellemeleri ve SEO deneyleri. Spam yok, istediğiniz zaman abonelikten çıkabilirsiniz.