Better i18n MCP (Model Context Protocol) sunucusu, Claude Code ve Cursor gibi AI kodlama ajanlarının çevirilerinizi doğrudan yönetmesine olanak tanır — anahtar oluşturma, içerik çevirisi, yayınlama ve içerik girişlerini yönetme.
MCP sunucusunu yükleme
npx @better-i18n/mcp
Ya da MCP yapılandırma dosyanıza ekleyin:
{
"mcpServers": {
"better-i18n": {
"command": "npx",
"args": ["-y", "@better-i18n/mcp"],
"env": {
"BETTER_I18N_API_KEY": "sk_gizli_anahtariniz"
}
}
}
}
Kullanılabilir araçlar
Çeviri anahtarı yönetimi
| Araç | Ne yapar |
|---|---|
listProjects |
Tüm projelerinizi listeler |
getProject |
Proje ayrıntılarını alır (diller, anahtar sayısı) |
listKeys |
Filtrelerle çeviri anahtarlarına göz atar |
createKeys |
Değerlerle yeni çeviri anahtarları oluşturur |
updateKeys |
Mevcut anahtarları günceller veya çeviri ekler |
deleteKeys |
Projenizden anahtarları kaldırır |
publishTranslations |
Çevirileri CDN'e gönderir |
İçerik CMS
| Araç | Ne yapar |
|---|---|
listContentModels |
İçerik modeli şemalarını listeler |
getContentEntry |
Tüm çevirileriyle bir girişi alır |
listContentEntries |
Filtrelerle girişleri listeler |
createContentEntry |
Yeni bir giriş oluşturur (tüm dillerde aynı anda) |
updateContentEntry |
Mevcut bir girişi günceller |
bulkUpdateEntries |
Tek bir çağrıda 20 adede kadar girişi günceller |
bulkCreateEntries |
Birden fazla girişi aynı anda oluşturur |
publishContentEntry |
Bir girişi CDN'de yayınlar |
Örnek ajan istemleri
"common.save_button çeviri anahtarını 'Save' değeriyle ekle ve Türkçe, Fransızca ve İspanyolcaya çevir"
"'auth' ad alanındaki tüm çevrilmemiş anahtarları bul ve Almancaya çevir"
"Better i18n ile başlamak hakkında bir yardım makalesi oluştur, tüm proje dillerine çevir ve yayınla"
"Tüm anahtarların kod tabanıyla senkronize olup olmadığını kontrol et ve eksik olanları düzelt"
Kimlik doğrulama
MCP sunucusu gizli API anahtarınızı (sk_...) kullanır. Bunu güvende tutun — git'e işlemeyin.
Claude Code için anahtarı .claude/settings.json dosyanızda env altına ekleyin.
Cursor için MCP ayarlarına env altında ekleyin.
Ajanların yapabilecekleri ve yapamayacakları
MCP sunucusunu kullanan ajanlar şunları yapabilir:
- Çeviri anahtarları oluşturma, okuma, güncelleme, silme
- AI kullanarak içerik çevirisi
- İçerik girişlerini ve modellerini yönetme
- Üretim CDN'inde yayınlama
Ajanlar şunları yapamaz:
- Faturalama veya ödeme ayarlarına erişme
- Projeleri veya kuruluşları silme
- Ekip üyelerini davet etme
- Diğer kullanıcıların özel verilerine erişme
MCP etkinliğini günlükleme
Tüm MCP işlemleri, AI'ın ne yaptığını görebilmeniz için projenizin Etkinlik günlüğüne "Ajan" etiketiyle kaydedilir.
Bu makale yardımcı oldu mu?