Lokalizasyon için MCP Server: Yapay Zeka Ajanları Çeviriler…

Lokalizasyon için MCP Server: Yapay Zeka Ajanları Çevirileri Nasıl Yönetiyor?

Geliştiricilerin uluslararasılaştırma süreçlerini ele alış biçimi köklü bir değişim geçiriyor. Cursor, Claude Code, Windsurf ve Zed gibi yapay zeka kodlama ajanlarının yükselişiyle birlikte soru artık yapay zekanın çevirileri yönetmeye yardımcı olup olmayacağı değil — nasıl yardımcı olacağıdır. Cevap yeni bir açık standartta yatıyor: Model Context Protocol (MCP).

Bu rehberde MCP'nin ne olduğunu, lokalizasyon için neden önemli olduğunu ve yapay zeka ajanlarının çevirileri oluşturmasını, güncellemesini ve yayınlamasını sağlayan bir MCP sunucusunu nasıl kurabileceğinizi keşfedeceğiz — üstelik IDE'nizden ayrılmadan.

MCP Nedir ve i18n İçin Neden Önemlidir?

Model Context Protocol (MCP), Anthropic tarafından oluşturulan ve yapay zeka modellerinin harici araçlar ve veri kaynaklarıyla birleşik bir arayüz üzerinden etkileşim kurmasını sağlayan açık bir standarttır. Bunu yapay zeka için bir USB-C portu olarak düşünün — herhangi bir yapay zeka ajanını herhangi bir harici servise bağlayan tek bir protokol.

Lokalizasyon için MCP dönüştürücü bir rol oynamaktadır çünkü şu ikisi arasındaki boşluğu kapatır:

Kod tabanınızı, bağlamı ve amacı anlayan yapay zeka kodlama ajanları
Çevirileri depolayan, organize eden ve sunan çeviri yönetim sistemleri (TMS)

MCP olmadan geliştiriciler IDE'leri, çeviri panoları, JSON dosyaları ve inceleme iş akışları arasında sürekli bağlam değiştirmek zorundadır. MCP ile yapay zeka ajanı tüm bunları tek bir konuşmada halleder.

i18n Ekipleri İçin Temel Faydalar

Fayda	MCP Olmadan	MCP İle
Çeviri anahtarı ekleme	TMS'yi açın, gezinin, anahtar oluşturun, değerleri ekleyin	IDE'nizde yapay zeka ajanına sorun
Bekleyen değişiklikleri inceleme	Panoya geçin, filtreleyin, inceleyin	"Almanca için bekleyen çevirileri göster"
Çevirileri yayınlama	Arayüz iş akışlarında tıklayarak ilerleyin	"Onaylanan tüm Fransızca çevirileri yayınla"
Eksik çevirileri bulma	Script çalıştırın veya panoları kontrol edin	"Hangi anahtarlarda Türkçe çeviri eksik?"

Sorun: Yapay Zeka Ajanları Çeviri Araçlarını Doğal Olarak Kullanamaz

Modern yapay zeka kodlama ajanları kod yazmada oldukça yeteneklidir, ancak kritik bir sınırlamaları vardır: varsayılan olarak harici servislerle etkileşim kuramazlar. Bir geliştirici yapay zeka ajanından "giriş butonu için yeni bir çeviri anahtarı ekle" diye istediğinde, ajan bir duvarla karşılaşır.

Genellikle Neler Ters Gider

Dosya tabanlı geçici çözümler: Ajan, TMS'yi tamamen atlayarak JSON çeviri dosyalarını doğrudan düzenler. Bu, senkronizasyon sorunları yaratır, diğer çevirmenlerin çalışmalarının üzerine yazar ve CI/CD pipeline'larını bozar.
Uydurma çeviriler: Mevcut çeviri belleğine veya sözlüklere erişim olmadan ajan çevirileri tahmin eder. Bunlar genellikle ince hatalar içerir — yanlış cinsiyet, hatalı resmiyat düzeyi veya anlamsal kayma.
İş akışı farkındalığının olmaması: Ajan, inceleme süreçleri, yayınlama kapıları veya ad alanı kuralları hakkında bilgi sahibi değildir. Yanlış ad alanında yinelenen anahtarlar oluşturabilir veya kalite kontrollerini atlayabilir.
Bağlam izolasyonu: Her konuşma sıfırdan başlar. Ajan hangi anahtarların zaten oluşturulduğunu, ekibin adlandırma kurallarını veya hangi dillerin aktif olduğunu hatırlamaz.

Bu sorunlar ölçek büyüdükçe katlanarak artar. Gerçek dünyadan bir örnekte, bir yapay zeka ajanı updateKeys yerine createKeys kullanarak ve doğru ad alanını bilmediği için yanlış ad alanında 1.000'den fazla hayalet anahtar oluşturmuştur. Bu tam olarak MCP araç açıklamalarının önlemek için tasarlandığı türden bir hatadır.

Çözüm: Better i18n MCP Server

Better i18n, lokalizasyon işlemlerini yapay zeka ajanlarının çağırabileceği yapılandırılmış araçlar olarak sunan özel olarak oluşturulmuş bir MCP sunucusu sağlar. JSON dosyalarını hacklemek yerine ajan, çeviri yönetim sisteminizle yerleşik güvenlik önlemleri bulunan iyi tanımlanmış bir API aracılığıyla etkileşim kurar.

Mimari Genel Bakış

+-------------------------------------+
|         AI Coding Agent             |
|   (Cursor, Claude, Windsurf, Zed)   |
+----------------+--------------------+
                 | MCP Protocol (stdio)
                 v
+-------------------------------------+
|      Better i18n MCP Server         |
|  +-----------+  +----------------+  |
|  |Translation|  |    Content     |  |
|  |   Tools   |  |     Tools      |  |
|  +-----------+  +----------------+  |
+----------------+--------------------+
                 | REST API
                 v
+-------------------------------------+
|     Better i18n Cloud Platform      |
|  Translations - Content - Analytics |
+-------------------------------------+

Mevcut Araç Kategorileri

MCP sunucusu iki araç seti sunar:

Çeviri Araçları (@better-i18n/mcp):

listKeys — Çeviri anahtarlarını durum bilgisiyle birlikte listeleme ve filtreleme
getTranslations — Belirli anahtarlar ve diller için çevirileri getirme
createKeys — Başlangıç değerleriyle yeni çeviri anahtarları ekleme
updateKeys — Mevcut çevirileri değiştirme
publishTranslations — Onaylanan çevirileri canlıya gönderme
getPendingChanges — Yayınlamadan önce bekleyen değişiklikleri inceleme

İçerik Araçları (@better-i18n/mcp-content):

listContentEntries — Blog yazıları, pazarlama sayfaları vb. listeleme
createContentEntry — Çoklu dil desteğiyle yeni içerik oluşturma
updateContentEntry — Mevcut içeriği düzenleme
publishContentEntry — İçeriği üretime yayınlama

Demo: 5 Adımda MCP Server Kurulum Rehberi

Better i18n MCP sunucusunu çalıştırmak 5 dakikadan az sürer. İşte nasıl yapılır:

Adım 1: API Anahtarınızı Alın

Better i18n panonuza gidin ve Settings ardından API Keys ardından Create New Key yolunu izleyin. Anahtarı kopyalayın — bir sonraki adımda ihtiyacınız olacak.

Adım 2: Yapay Zeka Ajanınızı Yapılandırın

MCP sunucusunu ajanınızın yapılandırma dosyasına ekleyin. Popüler ajanlar için nasıl yapıldığını görelim:

Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "better-i18n": {
      "command": "npx",
      "args": ["-y", "@better-i18n/mcp@latest"],
      "env": {
        "BETTER_I18N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor (.cursor/mcp.json proje kök dizininde):

{
  "mcpServers": {
    "better-i18n": {
      "command": "npx",
      "args": ["-y", "@better-i18n/mcp@latest"],
      "env": {
        "BETTER_I18N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf (~/.windsurf/mcp.json):

{
  "mcpServers": {
    "better-i18n": {
      "command": "npx",
      "args": ["-y", "@better-i18n/mcp@latest"],
      "env": {
        "BETTER_I18N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Adım 3: Bağlantıyı Doğrulayın

Ajanınızı yeniden başlattıktan sonra araçların kullanılabilir olduğunu doğrulayın:

Siz: "Çeviri projelerimi listele"

Ajan: 2 proje buldum:
  - my-org/web-app (12 dil, 2.847 anahtar)
  - my-org/mobile-app (8 dil, 1.203 anahtar)

Adım 4: Çevirileri Yönetmeye Başlayın

Artık çevirilerinizle doğal bir şekilde etkileşim kurabilirsiniz:

Siz: "'auth.login.welcome_message' adında yeni bir anahtar ekle,
      İngilizce değeri 'Welcome back!' ve Almanca değeri
      'Willkommen zurueck!' olsun"

Ajan: 'auth' ad alanında 'auth.login.welcome_message' anahtarı oluşturuldu
       - en: "Welcome back!"
       - de: "Willkommen zurueck!"
       Durum: taslak (yayınlanmamış)

Adım 5: İnceleyin ve Yayınlayın

Siz: "Auth ad alanındaki tüm bekleyen değişiklikleri göster"

Ajan: 'auth' ad alanında 3 bekleyen değişiklik:
  1. auth.login.welcome_message — yeni anahtar (en, de)
  2. auth.login.forgot_password — güncellendi (de)
  3. auth.signup.terms_label — yeni anahtar (en)

Siz: "Tüm bekleyen değişiklikleri yayınla"

Ajan: 3 değişiklik üretime yayınlandı.

Kullanım Senaryoları: MCP'nin Lokalizasyonda Parladığı Noktalar

1. Çeviri Farkındalığı ile PR İncelemesi

Bir pull request incelerken yapay zeka ajanı, yeni arayüz metinlerinin karşılık gelen çeviri anahtarlarına sahip olup olmadığını otomatik olarak kontrol edebilir:

Siz: "Bu PR'ı eksik çeviriler açısından incele"

Ajan: Çeviri anahtarı olmayan 3 yeni kullanıcıya yönelik metin buldum:
  - src/components/Checkout.tsx:42 - "Processing your order..."
  - src/components/Checkout.tsx:58 - "Payment failed. Please try again."
  - src/components/Checkout.tsx:73 - "Order confirmed!"

  Bunlar için çeviri anahtarları oluşturmamı ister misiniz?

2. İnsan İncelemesiyle Otomatik Çeviri

Ajan, yapay zeka kullanarak çeviri önerebilir, ancak MCP iş akışı bunların ekibinizin inceleme sürecinden geçmesini sağlar:

Siz: "'checkout' ad alanındaki tüm eksik Almanca anahtarları çevir"

Ajan: 12 eksik anahtar için Almanca çeviri önereceğim.
       Bunlar çevirmenlerinizin incelemesi için taslak olarak kaydedilecek.

       12 Almanca çeviri önerildi (durum: inceleme bekliyor)

3. Anahtar Yönetimi ve Temizlik

Siz: "Auth ad alanındaki kullanılmayan çeviri anahtarlarını bul"

Ajan: Auth ad alanı anahtarlarını kod tabanınızla karşılaştırdım:
  - auth.legacy.old_login — hiçbir yerde referans edilmiyor
  - auth.legacy.reset_v1 — hiçbir yerde referans edilmiyor
  - auth.experimental.biometric — yalnızca yorum satırına alınmış kodda referans ediliyor

  Bu anahtarları arşivlememi ister misiniz?

4. İçerik Lokalizasyonu

Çeviri anahtarlarının ötesinde, MCP sunucusu CMS içeriğini de yönetir:

Siz: "v2.0 sürümümüz hakkında İngilizce yeni bir blog yazısı oluştur,
      ardından başlığı ve özetini Almanca ve Türkçeye çevir"

Ajan: "Announcing Better i18n v2.0" blog yazısı oluşturuldu
       Almanca çeviri eklendi: "Better i18n v2.0 — Jetzt verfuegbar"
       Türkçe çeviri eklendi: "Better i18n v2.0 Duyurusu"
       Durum: taslak (incelemeye hazır)

5. Lokalizasyon Analitiği

Siz: "Mobil uygulama için çeviri kapsama oranımız nedir?"

Ajan: my-org/mobile-app çeviri kapsamı:
  - İngilizce: %100 (1.203/1.203 anahtar)
  - Almanca: %94 (1.131/1.203 anahtar) — 72 eksik
  - Fransızca: %91 (1.095/1.203 anahtar) — 108 eksik
  - Japonca: %87 (1.047/1.203 anahtar) — 156 eksik

Teknik Derinlik: Güvenlik Bariyeri Olarak Araç Açıklamaları

MCP sunucu tasarımının en kritik yönlerinden biri, önemsiz görünebilecek bir şeydir: araç açıklamaları. Pratikte araç açıklamaları, yapay zeka ajanı kötüye kullanımını önlemenin birincil mekanizmasıdır.

Açıklamalar Neden Düşündüğünüzden Daha Önemli

Bir yapay zeka ajanı kullanılabilir araçların listesini gördüğünde, araç açıklamaları ajanın davranışını yönlendiren sistem promptları işlevi görür. Belirsiz bir açıklama kötüye kullanıma yol açar; kesin bir açıklama bunu önler.

Better i18n'in MCP sunucusundan gerçek bir örneği ele alalım:

Kötü açıklama (ajan hatalarına yol açar):

name: "createKeys"
description: "Create new translation keys"

İyi açıklama (hataları önler):

name: "createKeys"
description: "Create NEW translation keys that don't exist yet.

IMPORTANT: Use this ONLY for brand-new keys. To modify existing
translations, use updateKeys instead.

WORKFLOW: 1. listKeys to check if key exists 2. createKeys if new,
OR updateKeys if existing.

NAMESPACE: Must match an existing namespace. Using a wrong namespace
creates duplicate keys that are hard to clean up.

REQUIRED: project, keys array with {key, namespace, translations}
OPTIONAL: tags for categorization"

Güvenlik Mekanizmaları

Better i18n MCP sunucusu birden fazla güvenlik katmanı uygular:

1. Proaktif Bariyerler (Araç Açıklamaları)

Her araç açıklamasında belgelenmiş adım adım iş akışları
Parametre bağımlılıkları açıkça belirtilmiş (ör. "status filtresi languages parametresini GEREKTİRİR")
Yaygın kötüye kullanım kalıpları doğrudan açıklamada uyarılmış

2. Reaktif Güvenlik Ağları (Yanıt Uyarıları)

{
  "result": { "created": 1 },
  "warn": "Key 'auth.login.title' already exists in namespace 'auth-v2'. Did you mean to use updateKeys?",
  "hint": "Use listKeys with namespace filter to verify the correct namespace before creating keys."
}

3. Çapraz Varlık Çarpışma Tespiti

Bir anahtar adı birden fazla ad alanında mevcut olduğunda, sunucu yanlışlıkla oluşturulabilecek yinelemeleri önlemek için ajanı uyarır.

4. İdempotentlik Korumaları

publishTranslations gibi işlemler güvenle tekrarlanabilir — zaten yayınlanmış çevirileri yayınlamak bir hata değil, etkisiz bir işlemdir.

Açıklama Öncelikli Tasarım Deseni

Herhangi bir alan için MCP araçları oluştururken şu deseni izleyin:

Ne yanlış gidebilir? Bir ajanın aracı kötüye kullanabileceği her yolu listeleyin
Proaktif bariyerler ekleyin — Doğru iş akışlarını açıklamada kodlayın
Reaktif uyarılar ekleyin — Kötüye kullanım tespit edildiğinde uyarı alanları döndürün
Gerçek ajanlarla test edin — Farklı yapay zeka modellerinin açıklamalarınızı nasıl yorumladığını gözlemleyin

Bu desen lokalizasyonun ötesinde de geçerlidir. Herhangi bir MCP sunucusu, araç açıklamalarını yapay zeka ajanlarıyla birincil arayüz sözleşmesi olarak ele almaktan fayda görür.

Sonuç: Yapay Zeka Odaklı Lokalizasyonda Öncü Olmanın Avantajı

Lokalizasyon endüstrisi bir dönüm noktasındadır. Yapay zeka kodlama ajanları, geliştiricilerin harici servislerle etkileşim kurduğu birincil arayüz haline gelmektedir. Bugün MCP tabanlı lokalizasyon iş akışlarını benimseyen ekipler şu avantajları elde eder:

Geliştirici hızı: IDE ve TMS panoları arasında bağlam değiştirmeye artık gerek yok
Tutarlılık: Yapay zeka ajanları her seferinde aynı iş akışlarını izler, insan hatasını azaltır
Ölçeklenebilirlik: Yapay zeka ajanına sahip tek bir geliştirici, düzinelerce dilde çevirileri yönetebilir
Kalite: Yerleşik güvenlik bariyerleri, dosya tabanlı i18n iş akışlarını rahatsız eden yaygın hataları önler

Better i18n, yapay zeka odaklı geliştirme çağı için özel olarak tasarlanmış, yerel MCP desteğine sahip ilk lokalizasyon platformudur. Diğer platformlar hâlâ API entegrasyonları oluşturup oluşturmamayı tartışırken, Better i18n'in MCP sunucusu zaten üretimde kullanılmaktadır — milyonlarca çeviri anahtarını yöneten mühendislik ekipleri tarafından her gün kullanılmaktadır.

Bugün Başlayın

Better i18n'e kaydolun — ücretsiz katman mevcut
MCP sunucusunu kurun — 5 dakikalık kurulum
Özellikleri keşfedin — nelerin mümkün olduğunu görün
Geliştirici topluluğuna katılın — diğer i18n geliştiricileriyle bağlantı kurun

Lokalizasyonun geleceği yapay zeka odaklıdır. Soru MCP'yi benimseyip benimsemeyeceğiniz değil — ne kadar çabuk başlayabileceğinizdir.

MCP'yi uygulamada görmek mi istiyorsunuz? Cursor, Claude Code, Windsurf ve Zed ile uygulamalı bir eğitim için Better i18n MCP'yi kodlama ajanlarıyla kullanma rehberimize göz atın.

Lokalizasyon için MCP Server: Yapay Zeka Ajanları Çevirileri Nasıl Yönetiyor?