Kodlama Ajanları ile Better i18n MCP Nasıl Kullanılır (Cursor, Claude, Windsurf, Zed)

Kodlama Ajanları ile Better i18n MCP Nasıl Kullanılır

Cursor, Claude Code, Windsurf ve Codex gibi modern kodlama ajanları Model Bağlam Protokolü (MCP) kullanarak doğrudan dış araçlarla etkileşime girebilir. Better i18n, AI asistanlarının çeviri verilerine erişmesini, proje durumunu kontrol etmesini ve yerelleştirme iş akışlarını yönetmesini sağlayan bir MCP sunucusu sağlar.

Bu kılavuzda, Better i18n MCP sunucusunu nasıl yapılandıracağınızı ve kodlama ajanınıza nasıl bağlayacağınızı inceleyeceğiz.

MCP Nedir?

MCP (Model Context Protocol), yapay zeka araçlarının yapılandırılmış araçlar kullanarak dış sistemlere bağlanmasını sağlayan bir standarttır.

Better i18n MCP sunucusu ile AI asistanınız şunları yapabilir:

• Çeviri kapsamını kontrol etme
• Eksik anahtarları getirme
• Çeviri önerme
• Yerelleştirmeyi doğrudan kodlama ortamınızdan yönetme

Adım 1 — Bir API Anahtarı Oluşturun

İlk olarak, Better i18n gösterge panelinden bir API anahtarı oluşturun.

1. https://dash.better-i18n.com adresine giriş yapın
2. Ayarlar → API Anahtarları bölümüne gidin
3. Yeni bir API anahtarı oluşturun
4. Anahtarı daha sonra kullanmak için kopyalayın

Adım 2 — Projenizi Yapılandırın

MCP sunucusunun hangi projeyi yönetmesi gerektiğini bilmesi gerekir.

i18n.config.ts dosyanıza project tanımlayıcısını ekleyin.

import { createI18n } from "@better-i18n/next";

export const i18n = createI18n({
  project: "your-org/your-project",
  defaultLocale: "en"
});

Adım 3 — Kodlama Ajanınızı Yapılandırın

MCP sunucusu yerel olarak npx kullanarak çalışır ve API anahtarınızla kimlik doğrulaması yapar.

Anahtar bir ortam değişkeni kullanılarak geçirilir:

BETTER_I18N_API_KEY=your-api-key

Aşağıda en yaygın kodlama ajanları için yapılandırma örnekleri bulunmaktadır.

Cursor

Aşağıdaki yapılandırmayı ekleyin:

~/.cursor/mcp.json

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

(Ekran görüntüsü: Cursor MCP ayarları)

Claude Code

Terminalinizde aşağıdaki komutu çalıştırın:

claude mcp add better-i18n -s user -e BETTER_I18N_API_KEY=your-api-key -- npx -y @better-i18n/mcp

Claude Code, MCP yapılandırmasını otomatik olarak yönetir.

(Ekran görüntüsü: terminal kurulum örneği)

Windsurf

Aşağıdaki dosyaya ekleyin:

~/.codeium/windsurf/mcp_config.json

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

Zed

Zed yapılandırma dosyanızı düzenleyin:

~/.config/zed/settings.json

{
  "context_servers": {
    "better-i18n": {
      "command": {
        "path": "npx",
        "args": ["@better-i18n/mcp"],
        "env": {
          "BETTER_I18N_API_KEY": "your-api-key"
        }
      },
      "settings": {}
    }
  }
}

Adım 4 — Entegrasyonu Doğrulayın

Yapılandırma tamamlandıktan sonra, AI asistanınıza şöyle bir şey sorun:

Mevcut projemin çeviri durumunu göster.

MCP sunucusu doğru bağlanmışsa, asistan Better i18n araçlarını çağıracak ve gerçek zamanlı proje istatistiklerini döndürecektir.

(Ekran görüntüsü: AI asistanı getProject aracını çağırıyor)

İsteğe Bağlı: İçerik Yönetimini Etkinleştirin

Better i18n CMS özelliklerini kullanıyorsanız, içerik MCP sunucusunu da yükleyebilirsiniz.

Örnek yapılandırma:

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

Bu, AI asistanınızın blog gönderilerini, changelog'ları ve diğer yerelleştirilmiş içerikleri yönetmesini sağlar.

Ortam Değişkenleri

Son Düşünceler

MCP ile kodlama ajanları yerelleştirme platformunuzla doğrudan etkileşime girebilir. Çeviri gösterge tablolarını elle kontrol etmek yerine, AI asistanınız proje durumunu analiz edebilir, çevirileri önerebilir ve çok dilli uygulamaların bakımına yardımcı olabilir.

Better i18n MCP, yerelleştirmeyi geliştirici iş akışınızın bir parçası yapar, ayrı bir süreç değil.