KI-Lokalisierungsagent

Die Verbindung Ihres KI-Agenten mit dem ai-l10n MCP-Server macht ihn zu einem professionellen Lokalisierungstool. Anstatt rohe i18n-Dateiinhalte in den Kontext einzufügen, ruft der Agent l10n.dev als dedizierte Übersetzungs-Engine auf – mit Formatgarantien, persistenten Lexika, benutzerdefinierten Stilanweisungen und token-effizienter Ausgabe.

Warum sollten Sie Ihren KI-Agenten mit einem Lokalisierungs-MCP verbinden?

Der naive Ansatz – das Einfügen Ihrer i18n-Datei in den Chat – stößt schnell an Grenzen. Hier ist, was sich ändert, wenn Ihr Agent stattdessen eine professionelle Lokalisierungs-Engine verwendet:

• Große Dateien werden serverseitig verarbeitet – der Agent muss niemals rohe Dateiinhalte in sein Kontextfenster laden.
• Formatbeibehaltung garantiert – Platzhalter, Schlüssel und Struktur überstehen die Übersetzung wortgetreu und werden nach jedem Aufruf validiert.
• Persistente Lexika – Fachbegriffe bleiben über alle Dateien, alle Abschnitte und alle zukünftigen Sitzungen hinweg konsistent.
• Token-effizient – der Agent sendet nur einen Dateipfad; es werden nur Metadaten zurückgegeben.
• Inkrementelle Übersetzung – nur neue oder geänderte Strings werden übersetzt, wodurch Ihre bestehenden Übersetzungen geschützt werden.
• Produktionsreife Übersetzung – keine Nachbearbeitung erforderlich.

Professionelle Lokalisierungsfunktionen für Ihren KI-Agenten

Der ai-l10n MCP-Server fügt Funktionen hinzu, die Ihr KI-Agent nicht von alleine replizieren kann:

📖 KI-Lexikongenerierung

Bitten Sie den Agenten, vor der Übersetzung ein Lexikon aus Ihren Quellinhalten zu generieren. Das Lexikon wird in Ihrem l10n.dev-Konto gespeichert und automatisch auf jede nachfolgende Datei und jeden Abschnitt angewendet – dies stellt eine konsistente Terminologie über Ihre gesamte Anwendung hinweg dauerhaft sicher.

✏️ Benutzerdefinierte Stil- & Tonfallregeln

Erstellen Sie sprachliche Anweisungen pro Sprachpaar – zum Beispiel: "Verwenden Sie einen informellen Tonfall, ausgerichtet auf lateinamerikanisches Spanisch" oder "Behalten Sie Markennamen immer auf Englisch bei." Anweisungen bleiben in Ihrem Konto bestehen und werden bei jedem Übersetzungsaufruf automatisch angewendet, ohne dass Sie sich in jeder Sitzung wiederholen müssen.

💾 Token-effiziente Übersetzung

Ohne das MCP bedeutet die Übersetzung einer großen i18n-Datei, die gesamte Datei in das Kontextfenster des Agenten zu laden – das ist teuer und führt oft zu Kürzungen. Mit dem MCP sendet der Agent nur einen Dateipfad und erhält nur Metadaten zurück. Die gesamte Übersetzung wird serverseitig verarbeitet, wodurch Ihr Kontextfenster frei bleibt.

🛡️ Formatbeibehaltung garantiert

Der Server validiert nach jeder Übersetzung, dass das Ausgabeformat mit der Quelle übereinstimmt – unter Beibehaltung der JSON-Struktur, Flutter ARB-Metadaten, YAML-Schlüssel, PO-Kataloge, XLIFF-Segmente und der gesamten Platzhaltersyntax. Die Validierung erfolgt serverseitig, bevor die Ergebnisse zurückgegeben werden.

⚡ Inkrementelle Updates

Aktivieren Sie die hash-basierte Änderungserkennung, um Strings zu überspringen, die bereits übersetzt wurden. Nur neue oder geänderte Strings werden zur Übersetzung gesendet, was Ihr Zeichenlimit schont und Ihre bestehenden Übersetzungen vor dem Überschreiben schützt.

Erste Schritte

Holen Sie sich Ihren API-Schlüssel

Erstellen Sie ein kostenloses Konto und erhalten Sie Ihren API-Schlüssel unter l10n.dev/ws/keys. Sie können den Schlüssel als Umgebungsvariable in Ihrer Agentenkonfiguration festlegen (siehe unten) oder Ihren Agenten bitten, ihn einmalig mit dem l10n_set_api_key-Tool zu speichern – dies speichert ihn in ~/.ai-l10n/config.json für die automatische Verwendung.

Konfigurieren Sie Ihren KI-Agenten

Wählen Sie unten Ihren Agenten aus und fügen Sie die MCP-Serverkonfiguration hinzu. Alle Agenten verwenden dasselbe npm-Paket – nur das Konfigurationsformat unterscheidet sich.

Claude Desktop

Öffnen Sie Einstellungen → Entwickler → Konfiguration bearbeiten. Claude Desktop öffnet die richtige MCP-Konfigurationsdatei für Ihre Installation. Fügen Sie den l10n-Server-Block hinzu:

{
  "mcpServers": {
    "l10n": {
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Öffnen Sie "Anpassen" in Cursor, um MCP-Server zu verwalten, oder fügen Sie die Konfiguration manuell hinzu. Verwenden Sie ~/.cursor/mcp.json für eine benutzerweite Einrichtung oder .cursor/mcp.json in Ihrem Projekt für eine arbeitsbereichsspezifische Einrichtung:

{
  "mcpServers": {
    "l10n": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

Öffnen Sie das MCP-Panel in Cascade oder gehen Sie zu Devin-Einstellungen → Cascade → MCP-Server. Für eine manuelle Einrichtung bearbeiten Sie ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "l10n": {
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

GitHub Copilot (VS Code)

Öffnen Sie die Befehlspalette und wählen Sie MCP: Benutzerkonfiguration öffnen oder erstellen Sie eine .vscode/mcp.json-Datei in Ihrem Arbeitsbereich:

{
  "servers": {
    "l10n": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

OpenAI Codex

Fügen Sie dies zu ~/.codex/config.toml für eine benutzerweite Einrichtung oder zu .codex/config.toml in einem vertrauenswürdigen Projekt hinzu:

[mcp_servers.l10n]
command = "npx"
args = ["-y", "ai-l10n-mcp"]

[mcp_servers.l10n.env]
L10N_API_KEY = "your-api-key-here"

Oder fügen Sie es direkt über das Terminal hinzu:

codex mcp add l10n --env L10N_API_KEY=your-api-key-here -- npx -y ai-l10n-mcp

Claude Code

Fügen Sie den Server über das Terminal hinzu. Dies funktioniert sowohl für die CLI als auch für die VS Code-Erweiterung:

claude mcp add --env L10N_API_KEY=your-api-key-here --transport stdio l10n -- npx -y ai-l10n-mcp

Beispiel: Übersetzung Ihrer App mit einem KI-Agenten

Sobald das MCP verbunden ist, prüft Ihr Agent proaktiv auf Anweisungen und Lexika, bevor er übersetzt. So sieht eine typische Sitzung aus, wenn Sie sagen: "Übersetze meine App ins Spanische und Französische":

Projekt-Setup-Prompt

Das MCP enthält einen integrierten l10n_project_setup-Prompt, der Ihren Agenten durch das Prüfen und Konfigurieren von sprachlichen Anweisungen und Lexika für eine optimale Übersetzungsqualität führt. Führen Sie ihn zu Beginn jedes neuen Projekts oder bei der Überprüfung Ihrer Lokalisierungseinstellungen aus.

"Führe den l10n_project_setup-Prompt aus" oder "Richte l10n.dev für dieses Projekt ein"

Automatisierungs-Setup-Prompt

Das MCP enthält einen integrierten l10n_automation_setup-Prompt, der Ihren Agenten durch die Konfiguration der automatisierten Übersetzung Ihrer i18n-Dateien führt. Führen Sie ihn einmal aus, um die automatische Übersetzung für alle zukünftigen Commits einzurichten, wodurch das manuelle Auslösen von Übersetzungen entfällt.

"Führe den l10n_automation_setup-Prompt aus" oder "Richte die automatische Lokalisierung für dieses Projekt ein"

Best Practices

• Lexikon verwenden: Aktivieren Sie die Lexikon-Generierung oder verwenden Sie ein bestehendes Lexikon. Bitten Sie die KI, das bestehende Lexikon zu Ihrem Projekt hinzuzufügen. Dies stellt eine konsistente Terminologie von der allerersten Übersetzung an sicher.
• Tonfallanweisungen pro Sprache festlegen: Verschiedene Märkte haben unterschiedliche Erwartungen. Legen Sie Anweisungen pro Sprachpaar fest – formeller Tonfall für deutsche Unternehmenssoftware, informell für spanische Verbraucher-Apps.
• Inkrementellen Modus für Updates verwenden: Aktivieren Sie immer die inkrementelle Übersetzung, wenn Zieldateien bereits existieren. Dies schützt Ihre aktuellen Übersetzungen und schont Ihr Zeichenlimit.
• API-Schlüssel sicher speichern: Verwenden Sie die Umgebungsvariable in der MCP-Konfiguration Ihres Agenten für gemeinsame oder CI/CD-Setups. Für den persönlichen Gebrauch bitten Sie den Agenten, ihn einmalig mit l10n_set_api_key zu speichern.
• Projekt-Setup-Prompt verwenden: Führen Sie l10n_project_setup zu Beginn jedes neuen Projekts aus, um sicherzustellen, dass Anweisungen und Lexika vor der Übersetzung konfiguriert sind.
• Automatisierungs-Setup-Prompt verwenden: Reduzieren Sie manuellen Aufwand & beschleunigen Sie Releases. Automatisieren Sie die Übersetzung Ihrer i18n-Dateien mit der ai-l10n CLI oder der VS Code-Erweiterung. Dies macht das manuelle Auslösen von Übersetzungen überflüssig und stellt konsistente Formatierung, Lexikonanwendung und Stilanweisungen über alle Dateien hinweg sicher.

Bereit, Ihrem KI-Agenten professionelle Lokalisierungsfunktionen zu verleihen?