Inhaltsverzeichnis
So verwendest du Better i18n MCP mit Coding-Agenten
Moderne Coding-Agenten wie Cursor, Claude Code, Windsurf und Codex können über das Model Context Protocol (MCP) direkt mit externen Tools interagieren. Better i18n stellt einen MCP-Server bereit, mit dem KI-Assistenten auf deine Übersetzungsdaten zugreifen, den Projektstatus prüfen und Lokalisierungs-Workflows verwalten können.
In diesem Leitfaden zeigen wir, wie du den Better i18n MCP-Server konfigurierst und mit deinem Coding-Agenten verbindest.
Was ist MCP?
MCP (Model Context Protocol) ist ein Standard, der KI-Tools ermöglicht, über strukturierte Werkzeuge eine Verbindung zu externen Systemen herzustellen.
Mit dem Better i18n MCP-Server kann dein KI-Assistent:
- Übersetzungsabdeckung prüfen
- Fehlende Schlüssel abrufen
- Übersetzungen vorschlagen
- Lokalisierung direkt aus deiner Coding-Umgebung heraus verwalten
Schritt 1 — API-Schlüssel erstellen
Erstelle zunächst einen API-Schlüssel im Better i18n Dashboard.
- Melde dich bei https://dash.better-i18n.com an
- Navigiere zu Einstellungen → API-Schlüssel
- Erstelle einen neuen API-Schlüssel
- Kopiere den Schlüssel zur späteren Verwendung
Schritt 2 — Dein Projekt konfigurieren
Der MCP-Server muss wissen, welches Projekt er verwalten soll.
Füge den project-Bezeichner in deine i18n.config.ts-Datei ein.
import { createI18n } from "@better-i18n/next";
export const i18n = createI18n({
project: "your-org/your-project",
defaultLocale: "en"
});
Schritt 3 — Deinen Coding-Agenten konfigurieren
Der MCP-Server läuft lokal über npx und authentifiziert sich mit deinem API-Schlüssel.
Der Schlüssel wird über eine Umgebungsvariable übergeben:
BETTER_I18N_API_KEY=your-api-key
Nachfolgend findest du Konfigurationsbeispiele für die gängigsten Coding-Agenten.
Cursor
Füge diese Konfiguration hinzu unter:
~/.cursor/mcp.json
{
"mcpServers": {
"better-i18n": {
"command": "npx",
"args": ["@better-i18n/mcp"],
"env": {
"BETTER_I18N_API_KEY": "your-api-key"
}
}
}
}
(Screenshot: Cursor MCP-Einstellungen)
Claude Code
Führe folgenden Befehl in deinem Terminal aus:
claude mcp add better-i18n -s user -e BETTER_I18N_API_KEY=your-api-key -- npx -y @better-i18n/mcp
Claude Code verwaltet die MCP-Konfiguration automatisch.
(Screenshot: Terminal-Einrichtungsbeispiel)
Windsurf
Füge dies hinzu unter:
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"better-i18n": {
"command": "npx",
"args": ["@better-i18n/mcp"],
"env": {
"BETTER_I18N_API_KEY": "your-api-key"
}
}
}
}
Zed
Bearbeite deine Zed-Konfigurationsdatei:
~/.config/zed/settings.json
{
"context_servers": {
"better-i18n": {
"command": {
"path": "npx",
"args": ["@better-i18n/mcp"],
"env": {
"BETTER_I18N_API_KEY": "your-api-key"
}
},
"settings": {}
}
}
}
Schritt 4 — Integration überprüfen
Frage nach der Konfiguration deinen KI-Assistenten z. B. Folgendes:
Zeige mir den Übersetzungsstatus meines aktuellen Projekts.
Wenn der MCP-Server korrekt verbunden ist, ruft der Assistent die Better i18n-Tools auf und gibt Echtzeit-Projektstatistiken zurück.
(Screenshot: KI-Assistent ruft das getProject-Tool auf)
Optional: Content-Management aktivieren
Wenn du die Better i18n CMS-Funktionen nutzt, kannst du auch den Content-MCP-Server installieren.
Beispielkonfiguration:
{
"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"
}
}
}
}
Dadurch kann dein KI-Assistent Blogbeiträge, Changelogs und andere lokalisierte Inhalte verwalten.
Umgebungsvariablen
| Variable | Erforderlich | Beschreibung |
|---|---|---|
| BETTER_I18N_API_KEY | Ja | Organisations-API-Schlüssel |
| BETTER_I18N_API_URL | Nein | Benutzerdefinierte API-URL |
| BETTER_I18N_DEBUG | Nein | Debug-Logging aktivieren |
Abschließende Gedanken
Mit MCP können Coding-Agenten direkt mit deiner Lokalisierungsplattform interagieren. Anstatt Übersetzungs-Dashboards manuell zu prüfen, kann dein KI-Assistent den Projektstatus analysieren, Übersetzungen vorschlagen und bei der Pflege mehrsprachiger Apps helfen.
Better i18n MCP macht Lokalisierung zu einem Teil deines Entwickler-Workflows — kein separater Prozess mehr.