Engineering//3 Min. Lesezeit

So verwendest du Better i18n MCP mit Coding-Agenten (Cursor, Claude, Windsurf, Zed)

Ali Osman Delismen
Teilen

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.

  1. Melde dich bei https://dash.better-i18n.com an
  2. Navigiere zu Einstellungen → API-Schlüssel
  3. Erstelle einen neuen API-Schlüssel
  4. Kopiere den Schlüssel zur späteren Verwendung

Blog post image

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

VariableErforderlichBeschreibung
BETTER_I18N_API_KEYJaOrganisations-API-Schlüssel
BETTER_I18N_API_URLNeinBenutzerdefinierte API-URL
BETTER_I18N_DEBUGNeinDebug-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.

Comments

Loading comments...