MCP sunucusunu AI kodlama ajanlarıyla nasıl kullanırım?

Better i18n MCP (Model Context Protocol) sunucusu, AI kodlama ajanlarının çevirilerinizi doğrudan yönetmesine olanak tanır. Anahtar oluşturun, çevirileri güncelleyin, senkronizasyon durumunu kontrol edin — IDE'nizdeki doğal dil komutlarıyla hepsini yapın.

MCP nedir?

MCP, AI ajanlarının harici araçlarla etkileşim kurmasını sağlayan bir protokoldür. Better i18n MCP sunucusunu bağladığınızda, AI ajanınız şunları yapabilir:

• Çeviri anahtarlarını listeleyin ve arayın
• Değerlerle yeni anahtarlar oluşturun
• Diller arası çevirileri güncelleyin
• Senkronizasyon durumunu kontrol edin ve eksik çevirileri bulun
• CDN'e değişiklikleri yayınlayın
• Content SDK aracılığıyla içeriği yönetin

Kurulum

Claude Code

Projenizin .mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "better-i18n": {
      "command": "npx",
      "args": ["-y", "@better-i18n/mcp"],
      "env": {
        "BETTER_I18N_API_KEY": "sk_..."
      }
    }
  }
}

Cursor / Windsurf

IDE'nizin MCP ayarlarına ekleyin (genellikle Ayarlar → MCP Sunucuları):

{
  "better-i18n": {
    "command": "npx",
    "args": ["-y", "@better-i18n/mcp"],
    "env": {
      "BETTER_I18N_API_KEY": "sk_..."
    }
  }
}

Not: MCP sunucusu için genel anahtar değil, gizli anahtar (sk_...) kullanın. MCP sunucusunun yazma erişimine ihtiyacı vardır.

Örnek iş akışları

Kodlarken anahtar ekleme

Siz: "Bir ayarlar sayfası ekliyorum. settings.title, settings.save_button
      ve settings.cancel_button için İngilizce değerlerle çeviri anahtarları oluştur."

Ajan: createKeys aracını kullanarak üç anahtarı da değerleriyle ekler.

Çevirme

Siz: "'settings' ad alanındaki tüm çevrilmemiş anahtarları Türkçeye çevir."

Ajan: Boşlukları bulmak için getTranslations, ardından Türkçe çeviriler
      eklemek için proposeLanguageEdits kullanır.

Durumu kontrol etme

Siz: "Türkçe çevirisi eksik olan anahtar var mı?"

Ajan: Çevrilmemiş anahtarları bulmak için dil filtresiyle listKeys kullanır.

Yayınlama

Siz: "Tüm bekleyen çevirileri yayınla."

Ajan: CDN'e değişiklikleri göndermek için publishTranslations kullanır.

İçerik yönetimi

İçerik yönetimi için ayrı bir MCP sunucusu da mevcuttur:

{
  "better-i18n-content": {
    "command": "npx",
    "args": ["-y", "@better-i18n/mcp-content"],
    "env": {
      "BETTER_I18N_API_KEY": "sk_..."
    }
  }
}

Bu, yapılandırılmış içerik modelleri ve girişleri yönetmeyi sağlar — blog yazıları, değişiklik günlükleri, yardım makaleleri ve daha fazlası.

Güvenlik konuları

• MCP sunucusu yerel olarak makinenizde çalışır
• API anahtarınız yerel ortamınızda kalır
• Ajan yalnızca projenizin izinleri dahilinde işlem yapabilir
• Tüm değişiklikler panodaki etkinlik günlüğünde denetlenir

Desteklenen ajanlar

MCP uyumlu herhangi bir ajan çalışır:

• Claude Code (CLI)
• Claude Desktop
• Cursor
• Windsurf
• Continue
• MCP SDK ile oluşturulmuş özel ajanlar

Sonraki adımlar

• MCP belgeleri
• AI çeviri kalitesi