Yandex Webmaster için MCP Sunucusu: LLM Ajanı için Sekiz Araç ve OAuth ile Etkileşimli Giriş

Habr'deki bir makale, TypeScript ile Yandex Webmaster v4 API'si için bir MCP sunucusu oluşturulmasını anlatıyor. Sunucu, çok sayıda endpoint'i sekiz araca indirgeyerek "tek soru - tek araç" prensibiyle adlandırıyor: get_hosts, search_queries, get_indexing, get_diagnostics, list_sitemaps, get_external_links, recrawl_status, recrawl_submit. Yetkilendirme için PKCE ve loopback URI ile OAuth akışı uygulanmış; bu sayede ajan, terminal ve istemci sırrı olmadan, EADDRINUSE gibi hataları düzgün şekilde ele alarak Yandex'e otomatik olarak giriş yapabiliyor. API'nin tuzakları detaylıca incelenmiş: önce kullanıcı kimliği (user_id) almanın gerekliliği, tekrarlanan anahtarlar aracılığıyla dizi formatı, 403 ve 401 durum kodları arasındaki fark, Yandex Webmaster ve Metrika'daki farklı hata formatları, 420 ve 429 durum kodlarına göre hız sınırlaması (throttling). Sunucu kodu MIT lisansı ile açık kaynak olarak yayınlanmıştır.