better-i18n MCP Sunucusu: Çevirilerinizi AI IDE'nizden Yönetin

MCP Sunucusu: Çevirilerinizi AI IDE'nizden Yönetin

Geliştiriciler çalışma günlerinin büyük bölümünü bir kod editöründe geçirir. Yerelleştirme ayrı bir web uygulamasında yaşadığında, çevirileri yönetmek için bağlam değiştirmek zaman kaybettirir ve iş akışını bozar. Yeni bir dizenin zaten çevrilip çevrilmediğini kontrol etmek, çeviri dosyasına bir anahtar eklemek ya da bir dizenin Almancada nasıl göründüğünü görmek isteyen bir geliştirici editörden çıkmak, yerelleştirme platformuna giriş yapmak, projeyi bulmak, dizeyi bulmak ve geri dönmek zorunda kalır.

Bu sürtünmeyi sprint başına yüzlerce dize ve takımdaki tüm geliştiriciler için çarparsanız, ek yük önemli hale gelir. Daha da kötüsü, bu sürtünme geliştiricileri yerelleştirme işini ertelemeye — şeyleri "sonra yap" olarak işaretlemeye — yönlendirir; bu da bir lansmanı tetikleyecek kadar büyüyen bir birikime neden olur.

better-i18n bunu yerleşik bir MCP (Model Context Protocol) sunucusuyla çözer. AI IDE'niz — Claude, Cursor, Windsurf veya Zed — çeviri çalışma alanınıza doğrudan bağlanır ve doğal dil kullanarak okuyup yazabilir. Çeviri yönetimi, geliştirme iş akışının bir parçası haline gelir; ayrı bir bağlam değiştirme egzersizi olmaktan çıkar.

Nasıl Çalışır

Model Context Protocol Nedir?

Model Context Protocol (MCP), Anthropic tarafından geliştirilen ve AI asistanların harici araçlara ve veri kaynaklarına nasıl bağlanabileceğini tanımlayan açık bir standarttır. Bir uygulama MCP sunucusunu kullandığında, AI IDE'ler yeteneklerini keşfedebilir ve yapılandırılmış araç çağrıları aracılığıyla onunla etkileşime girebilir.

better-i18n'in MCP sunucusu, çeviri çalışma alanınızı herhangi bir MCP uyumlu AI IDE'nin çağırabileceği bir araç seti olarak sunar. AI, çeviri dizelerinizi okuyabilir, yenilerini gönderebilir, kapsama durumunu kontrol edebilir, QA kontrolleri çalıştırabilir ve sözlük girişlerini yönetebilir — hepsi kod yazmak için halihazırda kullandığınız doğal dil arayüzü üzerinden.

Bu bir eklenti veya API'den özünde farklıdır. API'yi çağırmak için kod yazmanıza gerek yoktur. AI asistanınızla zaten kullandığınız aynı sohbet arayüzünde ne istediğinizi açıklamanız yeterlidir; asistan arka planda araç çağrılarını işler.

IDE'nizi Bağlama

Kurulum birkaç dakika sürer. better-i18n MCP sunucu URL'sini ve proje API tokenınızı IDE'nizin MCP yapılandırmasına eklersiniz. Cursor'da bu bir mcp.json dosyasıdır. Claude Desktop'ta MCP ayarlar panelidir. Windsurf ve Zed'de benzer yapılandırma dosyaları geçerlidir.

Bağlandıktan sonra, AI asistanınız çeviri çalışma alanınızı tanır. Proje yapınızı, kaynak dilinizi, hedef dillerinizi, sözlüğünüzü ve mevcut onaylanmış çevirilerinizi bilir. Bu bağlam ek bir yönlendirme olmadan kullanılabilir — AI bunu MCP bağlantısından otomatik olarak okur.

Çeviri Durumunu Okuma

MCP bağlantısı aktifken, AI asistanınıza çevirileriniz hakkında doğrudan soru sorabilirsiniz:

• "Bu dosyadaki hangi dizeler henüz Fransızcaya çevrilmemiş?"
• "auth.login.button.label anahtarı için zaten bir çeviri var mı?"
• "Japonca'da inceleme bekleyen tüm çevirileri göster."
• "47. satırdaki dizenin Almanca çevirisi nedir?"

AI uygun MCP araçlarını çağırır, better-i18n çalışma alanınızdan verileri alır ve yanıtı konuşmada sunar. Sekme değiştirme yok, web arayüzünde arama yok.

Yeni Dizeler Gönderme

Kod tabanınıza kullanıcıya yönelik yeni bir dize eklediğinizde, editörden çıkmadan better-i18n çalışma alanınıza gönderebilirsiniz:

• "83. satırdaki dizeyi 'Sipariş Toplamı' değeriyle checkout.summary.total.label olarak better-i18n'e ekle."
• "Bu bileşenden sabit kodlanmış tüm dizeleri çıkar ve better-i18n'e gönder."
• "Bu yeni özelliğin tüm dizeleri için mevcut adlandırma kuralımıza uygun çeviri anahtarları oluştur."

AI kodunuzu okur, dizeleri tanımlar, mevcut kurallarınıza dayalı uygun anahtar adları çıkarır ve tek bir işlemde better-i18n çalışma alanınızda girişleri oluşturur. Bu, geliştiricilerin şu anda ya elle yaptığı ya da süresiz ertelediği türden sıkıcı bir iştir.

Büyük ölçekli çıkarım için CLI aracı daha uygundur — kod tabanınızın tamamını tek seferde tarayabilir. MCP entegrasyonu, kod yazarken bireysel dizeler eklemenin süregelen iş akışı için en iyisidir.

AI Destekli Çeviri

Çeviri çalışma alanınıza, sözlüğünüze ve çeviri belleğinize erişimle AI asistanınız yüksek kaliteli çeviriler önerebilir:

• "Bu yeni dizeyi marka terimleri için sözlüğü kullanarak tüm hedef dillerimize çevir."
• "Mevcut onaylı dizelerimizin tonuyla uyumlu bir Almanca çeviri öner."
• "Bu dizenin Fransızca çevirisinin benzer dizeleri nasıl çevirdiğimizle tutarlı olup olmadığını kontrol et."

AI'ın eksiksiz çeviri belleğine erişimi vardır; bu nedenle önerileri genel değildir — ürününüzün özgün kelime dağarcığını, tonunu ve kurallarını yansıtır. Önerilen çeviriler better-i18n'de taslak olarak oluşturulur ve insan yorumlayıcılarınız için işbirliği iş akışında hemen görünür olur.

QA Kontrolleri Çalıştırma

IDE'den kalite güvence işlemlerini de tetikleyebilirsiniz:

• "Bugün eklediğim tüm dizeler için bir QA kontrolü çalıştır."
• "Yeni dizelerin herhangi birinde yer tutucu biçim sorunları olup olmadığını kontrol et."
• "Kaynak dizeden 40 karakterden fazla uzun olan tüm Fransızca çevirileri bul."

Bu işlemler, web editöründe otomatik olarak çalışan QA motoruyla aynı motoru kullanır. Fark, bunları geliştirme ortamınızdan, normal kod inceleme iş akışınızın bir parçası olarak programatik şekilde tetiklemenizdir.

İşbirliği Konularında @bahsetme

MCP entegrasyonu, better-i18n'in işbirliği arayüzündeki @bahsetme sistemini de güçlendirir. Bir inceleyici bir çeviri üzerine yorum bırakır ve @claude bu dizenin tonunu stil kılavuzumuza göre kontrol et yazarsa, AI MCP bağlantısı üzerinden dizeyi, stil kılavuzunu ve mevcut onaylı çevirileri okur ve doğrudan konuya yanıt verir.

Bu işbirliği özellik sayfasında daha ayrıntılı açıklanmıştır.

Temel Faydalar

Sıfır Bağlam Değişimi

En büyük pratik fayda, geliştiricilerin çeviriyle ilgili görevleri yönetmek için editörden hiçbir zaman çıkmak zorunda kalmamalarıdır. Kapsamı kontrol etmek, anahtar eklemek, dize göndermek, QA sonuçlarını almak — tümü AI IDE'nin sohbet arayüzünde gerçekleşir. Çevirileri yönetmenin zihinsel yükü neredeyse sıfıra iner.

Daha Hızlı Yerelleştirme Benimsemesi

Yerelleştirme zahmetsiz olduğunda, geliştiriciler gerçekten ertelemek yerine gerçek zamanlı olarak yapar. MCP entegrasyonunu kullanan ekipler, "üretimde çevrilmemiş dizeler" sayılarının kullanımın ilk sprintinde önemli ölçüde düştüğünü tutarlı biçimde bildirmektedir.

Gerçek Bağlama Sahip AI

Genel AI çeviri araçları, ürününüzün özgün kelime dağarcığı, ton kılavuzları veya mevcut çeviriler hakkında hiçbir bilgiye sahip değildir. better-i18n'in MCP entegrasyonu, herhangi bir öneri oluşturmadan önce AI'a çeviri belleğinize ve sözlüğünüze tam erişim sağlar. Bağlamlı ve bağlamsız AI önerileri arasındaki kalite farkı önemlidir.

Tutarlı Adlandırma Kuralları

AI yeni çeviri anahtarları oluştururken, mevcut anahtar yapınızı okur ve otomatik olarak aynı kuralları izler. auth.login.button.label ve checkout.summary.total.label gibi anahtarlar öngörülebilir bir düzeni izler. Otomasyonsuz geliştiriciler, özellikle son teslim tarihi baskısı altında kuralları tutarsız biçimde uygular.

Tam Özellik Setiyle Entegrasyon

MCP entegrasyonu, better-i18n'in yeteneklerinin sınırlı bir alt kümesi değildir. Web arayüzü üzerinden erişilebilen her şey MCP araçları aracılığıyla da erişilebilir. Sürüm geçmişi, analitik veriler, QA sonuçları, sözlük yönetimi — tümü IDE'nizden kullanılabilir.

Kullanım Senaryoları

Aktif Geliştirme: Bir geliştirici yeni bir bileşen yazarken, AI'ı sabit kodlanmış dizeleri çıkarmak, uygun anahtar adları oluşturmak, anahtarları better-i18n'e göndermek ve ilk AI çevirilerini talep etmek için kullanır — editörden çıkmadan tek bir sohbet oturumunda tüm bunları yapar.

Kod İncelemesi: Bir inceleyici yeni kullanıcıya yönelik dizeler ekleyen bir PR görür. AI'dan dizelerin better-i18n'e gönderilip gönderilmediğini ve tüm hedef diller için çevirilerin mevcut olup olmadığını kontrol etmesini ister. AI bir saniyeden kısa sürede kontrol edip raporlar.

Yeniden Düzenleme: Bir geliştirici bir bileşeni yeniden adlandırır ve çeviri anahtarlarını eşleşecek şekilde güncellemesi gerekir. AI'dan eski öneke sahip tüm anahtarları bulmasını, better-i18n'de yeniden adlandırmasını ve kod tabanındaki referansları güncellemesini ister.

Lansman Öncesi QA: Lansmanın bir gün öncesi, bir geliştirici AI'dan tüm diller için tam bir kapsama raporu oluşturmasını ve geçen haftada eklenen, onaylı çevirisi olmayan dizeleri işaretlemesini ister. AI önceliklendirilmiş bir liste döndürür.

Sözlük Yönetimi: Bir ürün yöneticisi marka terminolojisini günceller ve AI'dan better-i18n sözlüğünü güncellemesini ve tüm dillerde eski terimi kullanan tüm çevirileri işaretlemesini ister.

better-i18n'in MCP Uygulaması

better-i18n'in MCP sunucusu tam MCP spesifikasyonuna göre uygulanmıştır. get_string, create_string, update_string, search_strings, get_coverage, run_qa, get_glossary_entries, create_glossary_entry ve diğerleri gibi adlandırılmış araçlardan oluşan bir set sunar — her biri parametrelerini ve dönüş türlerini açıklayan bir JSON şemasına sahiptir.

MCP uyumlu bir AI bu araçlardan birini çağırdığında, sunucu isteği proje API tokenını kullanarak doğrular, web arayüzüne uygulananlarla aynı rol tabanlı erişim kontrollerini uygular ve AI'ın yanıtını oluşturmak için kullanabileceği yapılandırılmış veriler döndürür.

Sunucu durumsuz (stateless) ve yatay olarak ölçeklenebilirdir. Her araç çağrısı bağımsız bir API isteğidir. Yönetilecek oturum durumu yoktur ve bağlantı, bağlam kaybetmeden kesilebilir ve yeniden başlatılabilir.

Kimlik doğrulama, proje kapsamlı API tokenları kullanır. Bir proje için verilen token, her iki proje de aynı kuruluşa ait olsa bile başka bir projeye erişmek için kullanılamaz.

Alternatiflerle Karşılaştırma

Lokalise ve Phrase Eklentileri: Her iki platform da bazı IDE'ler için editör eklentileri sunar, ancak bunlar geleneksel UI eklentileridir — editör içinde web arayüzünü çoğaltan kenar çubukları veya paneller. Doğal dil etkileşimini veya AI destekli işlemleri desteklemez.

Özel API Betikleri: Ekipler bazen dize göndermek veya almak için bir yerelleştirme platformunun API'sini çağıran özel betikler yazar. Bu sürekli bakım gerektirir, doğal dil sorgularını desteklemez ve teknik olmayan ekip üyeleri tarafından kullanılamaz.

Bağlamlsız AI Çevirisi: Çeviri belleğinize, sözlüğünüze veya mevcut onaylı çevirilerinize erişim olmadan genel amaçlı bir AI kullanmak tutarsız sonuçlar üretir. MCP entegrasyonu, AI'a ihtiyaç duyduğu tüm bağlamı vererek bunu çözer.

Doğrudan Dosya Düzenleme: Kod tabanında JSON veya YAML çeviri dosyalarını doğrudan düzenlemek en basit yaklaşımdır, ancak senkronizasyon sorunları yaratır, işbirliğini zorlaştırır ve QA sağlamaz. CLI aracı, dosya tabanlı iş akışları için daha iyi yapılandırılmış bir alternatiftir ve MCP entegrasyonu bunun üzerine inşa edilmiştir.

Sık Sorulan Sorular

Hangi AI IDE'ler MCP'yi destekler? 2026 başı itibarıyla MCP; Claude Desktop, Cursor, Windsurf, Zed ve giderek büyüyen diğer AI destekli geliştirme ortamları tarafından desteklenmektedir. Protokol açık kaynaktır ve sektör genelinde aktif olarak benimsenmektedir.

Takımdaki her geliştirici için ayrı bir API anahtarına ihtiyacım var mı? Hayır. API tokenları bir projeye kapsamlandırılıp paylaşılabilir ya da denetim izi amaçlı her geliştirici için bireysel tokenlar oluşturulabilir. Token yönetimi proje ayarları panelinde mevcuttur.

AI, üretim çevirilerini doğrudan değiştirebilir mi? MCP sunucusu, iş akışı yapılandırmanıza saygı gösterir. Projeniz yayınlamadan önce bir inceleme adımı gerektiriyorsa, AI tarafından oluşturulan veya düzenlenen çeviriler doğrudan yayınlanmaz; "inceleme bekliyor" durumuna alınır. AI, diğer katkıda bulunanlarla aynı erişim kontrolleri içinde çalışır.

MCP bağlantısı güvenli mi? Evet. IDE ile better-i18n MCP sunucusu arasındaki tüm iletişim HTTPS kullanır. API tokenları belirli projelere kapsamlandırılır ve proje ayarlarından istedğiniz zaman iptal edilebilir. Sunucu her araç çağrısında rol tabanlı erişimi uygular.

Binlerce dizinim varsa AI bunalıma girer mi? MCP araçları tam veri kümesi alımı için değil, verimli ve hedefli erişim için tasarlanmıştır. AI ilgili dizeleri bulmaya ihtiyaç duyduğunda, her şeyi yüklemek yerine arama ve filtre araçlarını kullanır. Toplu işlemler için CLI aracı daha uygundur.

Çevirilerinizi Geliştirme İş Akışınıza Dahil Edin

Çeviri yönetimi ayrı bir uygulama olmamalıdır. Ürününüzü oluşturmak için zaten kullandığınız araçların bir parçası olmalıdır. better-i18n'in MCP entegrasyonu, herhangi bir MCP uyumlu AI IDE ile bunu bugün mümkün kılar.

Ücretsiz denemenizi başlatın ve IDE'nizi dakikalar içinde bağlayın.