MCP-Server

Lokalisieren Sie von Ihrem Coding Agent.

localize-dev mcp gibt Ihrem Coding Agent die gleichen Werkzeuge wie die CLI. Fragen Sie nach einer Seite auf Spanisch, und er findet den fest codierten Text, extrahiert ihn in Schlüssel und übersetzt ihn gemäß Ihrem Glossar. Richten Sie ihn mit init --agent ein, und er tut dasselbe für jede Datei, während er sie schreibt.

Richten Sie es ein CLI-Dokumentation

$claude mcp add localize -- npx -y localize-dev mcp

~/acme/storefrontlocalize verbunden

Liefern Sie die Checkout-Seite auf Spanisch, Französisch und Deutsch.

localize.check(only: "strings")

2 hartcodierte Strings in components/Checkout.tsx.

components/Checkout.tsx:18 "Place order"
components/Checkout.tsx:24 "Discount code"

localize.localize(paths: ["components/Checkout.tsx"])

- <button>Place order</button>

+ <button>{t('checkout.place_order')}</button>

es Realizar pedido
fr Passer la commande
de Bestellung aufgeben

2 Schlüssel geschrieben, 3 Sprachen gefüllt. Die Änderungen befinden sich in Ihrem Arbeitsverzeichnis zur Überprüfung.

Werkzeuge

Fünf Werkzeuge, die, die die CLI bereits hat.

Der Agent wählt das Werkzeug aus; jedes antwortet mit strukturierten Ergebnissen (Dateien, Zeilen, Schlüssel), auf die es reagieren kann.

localize

Extrahiert fest codierte Zeichenfolgen in Übersetzungsschlüssel, schreibt den Code für Ihre i18n-Bibliothek neu und übersetzt die neuen Nachrichten in jede Sprache. Nur für einige Dateien oder zuerst als Testlauf.

- <h2>Order summary</h2>

+ <h2>{t('checkout.order_summary')}</h2>

locales/es.jsonlocales/fr.jsonlocales/de.json

check

Findet fest codierte UI-Texte im Code sowie fehlende oder veraltete Übersetzungen, jeweils mit Datei und Zeile. Ändert nichts. Angesichts der Dateien, die der Agent gerade geändert hat, antwortet er in etwa einer Sekunde.

hardcoded Checkout.tsx:18
missing fr · cart.empty
outdated de · cart.total

translate

Füllt fehlende Übersetzungen auf und überarbeitet solche, deren Quelltext sich geändert hat, in Ihren vorhandenen Lokalisierungsdateien.

JSON
YAML
.po
.arb
strings.xml
.xcstrings

add_language

Übersetzt jede Nachricht in eine neue Sprache und fügt sie dann zu localize.config.json hinzu. Ohne Schlüssel wird nichts geändert.

"targetLocales": ["es", "fr", "ja"]

config

Ihre Sprachen, Lokalisierungsdateien und i18n-Bibliothek sowie das Glossar des Projekts, damit die vom Agenten von Hand geschriebene Kopie diese ebenfalls befolgt.

Beibehalten: Acme
checkout → es: pago

Kein Schlüssel erforderlichAuf Ihrem Computer funktionieren Prüfung und Konfiguration ohne API-Schlüssel.

Eine Sitzung

Fragen Sie in einfachen Worten. Überprüfen Sie den Unterschied.

Der Agent entscheidet, wann jedes Werkzeug aufgerufen wird. Sie sehen jeden Aufruf, und das Ergebnis landet in Ihrem Arbeitsverzeichnis.

Scrolle, um durch eine Sitzung zu gehen

01 / 04

Sie fragen

„Liefern Sie die Checkout-Seite auf Spanisch“, „Fügen Sie Japanisch hinzu“ oder „Ist noch etwas unübersetzt?“

agent

Liefern Sie die Checkout-Seite auf Spanisch, Französisch und Deutsch.

Ich werde zuerst die Checkout-Seite auf hartcodierte Texte überprüfen.

localize.check(only: "strings")

Während Sie schreiben

Übersetzt, bevor der Pull Request geöffnet wird

Ein Befehl richtet Ihre Coding-Agenten ein. Danach wird jede Datei, die ein Agent bearbeitet, auf nicht übersetzten Text überprüft, und der Agent lokalisiert ihn, bevor er weitermacht.

1
Der Agent schreibt eine Komponente mit neuem Text darin.
2
Der After-Edit-Hook von Claude Code prüft diese eine Datei in etwa einer Sekunde, ohne Schlüssel oder Modell, und teilt dem Agenten mit, welche Zeilen noch fest codierten Text enthalten.
3
Der Agent ruft localize für die Datei auf. Der Text erhält Schlüssel und Übersetzungen, sodass der Pull-Request mit jeder ausgefüllten Sprache ankommt.

Cursor, Codex und andere Agenten erhalten die gleichen Anweisungen von AGENTS.md und einer Cursor-Regel. Fügen Sie --pre-commit hinzu, um auch gestagte Dateien vor jedem Commit zu überprüfen, und setzen Sie LOCALIZE_DEV_HOOK=off, um den Hook anzuhalten.

In Ihrem App-Ordner

npx localize-dev init --agent

Was der Agent nach einer Bearbeitung sieht

localize.dev: src/components/Promo.tsx has UI text that isn't translated yet.
  line 4: "Free shipping on orders over $50"
Call the localize tool of the localize-dev MCP server with paths ["components/Promo.tsx"]: it gives this text translation keys, rewrites the code and translates it.

Einrichtung

Richte es in deinem Agenten ein.

Agenten auf Ihrem Computer führen den Server aus dem npm-Paket aus, ohne etwas hosten zu müssen. npx localize-dev init --agent richtet ihn für Claude Code und Cursor zusammen mit dem After-Edit-Hook ein. Lovable, Bolt und v0 verbinden sich mit dem gehosteten Server mit einem API-Schlüssel.

Zuerst, einmal pro Maschine:npx localize-dev login

Claude Code

Anthropic's Coding Agent im Terminal. Fügen Sie den Server aus dem Repository hinzu, in dem Sie arbeiten. Mit --scope project wird er in .mcp.json für alle im Team gespeichert. npx localize-dev init --agent tut dies und fügt den After-Edit-Hook hinzu.

1Führen Sie claude mcp add in Ihrem Repository aus.
2Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
3Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.

Versuche zu fragen

“Lokalisieren Sie src/components/Checkout.tsx ins Spanische und Französische.”

→ localize.localize

terminal

claude mcp add localize -- npx -y localize-dev mcp

# Share it with your team through .mcp.json
claude mcp add --scope project localize -- npx -y localize-dev mcp

# Or the server, the after-edit hook and AGENTS.md in one go
npx localize-dev init --agent

Cursor

Cursor liest MCP-Server aus .cursor/mcp.json im Projekt oder ~/.cursor/mcp.json für jedes Projekt. npx localize-dev init --agent schreibt die Projektdatei und eine Regel für Ihre UI-Dateien.

1Fügen Sie Lokalisierung zu .cursor/mcp.json hinzu.
2Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
3Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.

Versuche zu fragen

“Fügen Sie Japanisch zu dieser App hinzu.”

→ localize.add_language

.cursor/mcp.json

{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Codex

OpenAI's Codex liest MCP-Server aus seiner Konfigurationsdatei, die von CLI und IDE-Erweiterung gemeinsam genutzt wird.

1Fügen Sie die Tabelle [mcp_servers.localize] zu ~/.codex/config.toml hinzu.
2Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
3Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.

Versuche zu fragen

“Bevor ich den PR öffne, prüfen Sie auf fest codierten Text und fehlende Übersetzungen.”

→ localize.check

~/.codex/config.toml

[mcp_servers.localize]
command = "npx"
args = ["-y", "localize-dev", "mcp"]

GitHub Copilot in VS Code

Der Agentenmodus von Copilot in VS Code liest MCP-Server aus .vscode/mcp.json im Arbeitsbereich.

1Fügen Sie localize zu .vscode/mcp.json in Ihrem Arbeitsbereich hinzu.
2Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
3Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.

Versuche zu fragen

“Übersetzen Sie die neuen Schlüssel in locales/en.json in alle Sprachen.”

→ localize.translate

.vscode/mcp.json

{
  "servers": {
    "localize": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Devin

Devin, früher Windsurf, liest MCP-Server aus ~/.config/devin/mcp_config.json oder .devin/mcp_config.json im Projekt. Das Devin CLI fügt einen mit devin mcp add hinzu.

1Fügen Sie localize zu ~/.config/devin/mcp_config.json hinzu (%APPDATA%\devin\mcp_config.json unter Windows).
2Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
3Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.

Versuche zu fragen

“Führen Sie eine Trockenübung der Lokalisierung der Einstellungsseite durch und wenden Sie sie an.”

→ localize.localize

~/.config/devin/mcp_config.json

{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Gemini CLI

Google's Gemini CLI liest MCP-Server aus ~/.gemini/settings.json oder .gemini/settings.json im Projekt.

1Fügen Sie localize zu den mcpServers in settings.json hinzu.
2Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
3Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.

Versuche zu fragen

“Welche Sprachen unterstützt diese App und was ist in ihrem Glossar?”

→ localize.config

~/.gemini/settings.json

{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Lovable

Die Chat-Konnektoren von Lovable können jeden entfernten MCP-Server aufrufen. Verbinden Sie den gehosteten Server mit einem API-Schlüssel, und der Agent von Lovable kann die App, die er erstellt, überprüfen und übersetzen. Die Verbindung gehört Ihnen allein und ist niemals Teil der veröffentlichten App.

1Wählen Sie unter Konnektoren "Benutzerdefiniert hinzufügen", dann "MCP-Server" und geben Sie die URL ein.
2Wählen Sie "Bearer-Token" oder "API-Schlüssel", fügen Sie Ihren localize.dev API-Schlüssel ein und klicken Sie auf "Server hinzufügen".
3Öffnen Sie Ihr Projekt und fragen Sie etwas wie die Eingabeaufforderung unten. Der Agent sendet die Dateien, die das Tool benötigt, und schreibt die zurückgegebenen Dateien zurück.

Versuche zu fragen

“Überprüfen Sie diese App auf hartcodierten Text und sagen Sie mir, was nicht übersetzt wurde.”

→ localize.check

Connectors → Add custom → MCP server

Name            localize
URL             https://uselocalize.dev/api/mcp
Authentication  Bearer token or API key
Key             ldv_live_… (your localize.dev API key)

Bolt

Bolt fügt benutzerdefinierte MCP-Server von seiner Konnektoren-Seite hinzu. Richten Sie einen auf den gehosteten Server, und der Agent von Bolt kann das im Editor geöffnete Projekt lokalisieren.

1Klicken Sie im Chat auf +, öffnen Sie Connectors (MCP) und wählen Sie Custom MCP server. Geben Sie die URL ein und stellen Sie den Transport auf HTTP.
2Wählen Sie API-Schlüssel als Authentifizierung und fügen Sie Ihren localize.dev API-Schlüssel ein.
3Öffnen Sie Ihr Projekt und fragen Sie etwas wie die Eingabeaufforderung unten. Der Agent sendet die Dateien, die das Tool benötigt, und schreibt die zurückgegebenen Dateien zurück.

Versuche zu fragen

“Lokalisieren Sie die Preisseite ins Spanische und Deutsche.”

→ localize.localize

Connectors (MCP) → Custom MCP server

Name            localize
URL             https://uselocalize.dev/api/mcp
Transport       HTTP
Authentication  API key
Key             ldv_live_… (your localize.dev API key)

v0

v0 verwendet benutzerdefinierte MCP-Server, während es Code generiert. Verbinden Sie den gehosteten Server, und v0 kann Sprachen zu der App hinzufügen, die es erstellt, und deren Übersetzungen ausfüllen.

1Öffnen Sie + im Eingabeaufforderungsformular, wählen Sie MCPs, dann Configure und geben Sie die URL ein.
2Wählen Sie Bearer Token und fügen Sie Ihren localize.dev API-Schlüssel ein.
3Öffnen Sie Ihr Projekt und fragen Sie etwas wie die Eingabeaufforderung unten. Der Agent sendet die Dateien, die das Tool benötigt, und schreibt die zurückgegebenen Dateien zurück.

Versuche zu fragen

“Fügen Sie Japanisch zu dieser App hinzu.”

→ localize.add_language

+ → MCPs → Configure

Name            localize
URL             https://uselocalize.dev/api/mcp
Authentication  Bearer Token
Key             ldv_live_… (your localize.dev API key)

Gehosteter Server

Für Agenten, die keine Befehle ausführen können.

Builder wie Lovable, Bolt, v0 und andere, die im Browser laufen, können `npx localize-dev mcp` nicht starten. Stattdessen können sie sich mit dem gehosteten Server verbinden. Er bietet dieselben fünf Tools und läuft auf localize.dev.

1
Fügen Sie einen benutzerdefinierten MCP-Server mit der URL https://uselocalize.dev/api/mcp hinzu.
2
Wenn die App OAuth unterstützt, wählen Sie diese aus und genehmigen Sie die Verbindung auf localize.dev. Andernfalls geben Sie Ihren localize.dev API-Schlüssel im Authorization-Header als Bearer-Token an.
3
Der Agent sendet die Dateien, die ein Tool benötigt, und schreibt die zurückgegebenen Dateien zurück. Sie liegen in einem temporären Ordner während des Aufrufs und werden gelöscht, wenn der Agent antwortet.

MCP-Konfiguration (Streamable HTTP)

{
  "mcpServers": {
    "localize": {
      "type": "http",
      "url": "https://uselocalize.dev/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Sicherheit und Datenschutz

Nur das Nötigste verlässt Ihren Computer.

Der lokale Server ist die CLI, die auf Ihrem Computer läuft, und nur das, was übersetzt werden muss, geht an die API. Der gehostete Server empfängt die Dateien, die ein Agent sendet, und löscht sie, wenn er antwortet.

Läuft lokal
Der Server läuft auf deinem Rechner über stdio, gestartet durch deinen Agenten. Es gibt nichts zu hosten und keinen Port zu öffnen.
Strings, nicht Quellcode
Nur die extrahierten Strings werden an die API gesendet, mit ihrem Dateipfad und Komponenten als Kontext. Ganze Dateien werden nie übertragen.
Bleibt in seinem Ordner
Jedes Tool arbeitet im Ordner, in dem der Server gestartet wurde. Ein App-Argument wählt eine App in einem Monorepo, niemals einen Pfad außerhalb.
Nichts committet
Änderungen landen in deinem Arbeitsbaum. Der Server committet oder pusht nie, und Tool-Aufrufe laufen nacheinander.

Häufige Fragen

Fragen zum MCP-Server

Mit welchen Agenten funktioniert es?+

Jeder MCP-Client, der Server über stdio startet: Claude Code, Cursor, Codex, GitHub Copilot in VS Code, Devin (ehemals Windsurf), Gemini CLI und andere. Die Einrichtung ist derselbe Befehl: npx -y localize-dev mcp. Lovable, Bolt, v0 und andere Builder, die im Browser laufen, verbinden sich stattdessen mit dem gehosteten Server.

Woher weiß der Agent, was er lokalisieren soll, wenn er schreibt?+

npx localize-dev init --agent sagt es ihm. Die Anweisungen des MCP-Servers, ein Abschnitt in AGENTS.md und eine Cursor-Regel fordern ihn auf, localize für die geänderten Dateien aufzurufen. In Claude Code prüft ein After-Edit-Hook jede Datei, die der Agent bearbeitet, und listet jeden unübersetzten Text auf, damit der Agent ihn behebt, bevor er weitermacht.

Verbraucht der Hook mein Kontingent?+

Nein. Der Hook liest nur die Datei, auf Ihrem Rechner, ohne Schlüssel oder Modell. Zeichen zählen, wenn der Agent localize aufruft und sie übersetzt werden, wie bei jeder Ausführung.

Brauche ich einen API-Schlüssel?+

Auf Ihrem Rechner benötigen check und config keine. localize, translate und add_language übersetzen über localize.dev, daher benötigen sie den Schlüssel von npx localize-dev login (oder LOCALIZE_API_KEY). Der gehostete Server benötigt für jeden Aufruf einen Schlüssel, obwohl check und config immer noch nicht auf Ihren Plan angerechnet werden. Übersetzungen werden wie jeder andere Lauf auf Ihren Plan angerechnet.

Brauche ich noch die GitHub-Aktion?+

Nein, sie funktionieren von selbst. Der MCP-Server lokalisiert während des Builds und mit init --agent jede Datei, während der Agent sie schreibt. Die Aktion hält jeden Push lokalisiert und öffnet einen Pull Request. Sie lesen dieselbe localize.config.json und dasselbe Glossar.

Wird es meinen Code committen oder pushen?+

Der Server tut das nicht: Er schreibt Dateien in Ihren Arbeitsbaum und gibt zurück, was sich geändert hat. Was Ihr Agent als Nächstes tut, liegt bei Ihnen und den Berechtigungen des Agents.

Funktioniert es in einem Monorepo?+

Ja. Jedes Tool nimmt ein app-Argument, wie z.B. apps/web, und arbeitet dort mit der Konfiguration und den Sprachdateien dieser App.

Kann ich es ohne etwas auf meinem Gerät auszuführen verwenden?+

Ja, über den gehosteten Server unter https://uselocalize.dev/api/mcp. Verbinden Sie ihn als Streamable HTTP-Server und melden Sie sich dann mit OAuth an oder senden Sie Ihren API-Schlüssel als Bearer-Token. Jeder Aufruf benötigt einen Schlüssel oder eine Anmeldung, aber Prüfungen und Konfigurationen zählen immer noch nicht für Ihren Plan.

Erhalten Sie einen API-Schlüssel und fügen Sie den Server hinzu.

Der kostenlose Plan deckt kleine Apps ab, und check läuft auf Ihrem Rechner ohne Schlüssel.

API-Schlüssel erstellen Wählen Sie Ihren Agenten aus

Lokalisieren Sie von Ihrem Coding Agent.

Fünf Werkzeuge, die, die die CLI bereits hat.

localize

check

translate

add_language

config

Fragen Sie in einfachen Worten. Überprüfen Sie den Unterschied.

Sie fragen

Übersetzt, bevor der Pull Request geöffnet wird

Richte es in deinem Agenten ein.

Claude Code

Cursor

Codex

GitHub Copilot in VS Code

Devin

Gemini CLI

Lovable

Bolt

v0

Für Agenten, die keine Befehle ausführen können.

Nur das Nötigste verlässt Ihren Computer.

Läuft lokal

Strings, nicht Quellcode

Bleibt in seinem Ordner

Nichts committet

Fragen zum MCP-Server

Erhalten Sie einen API-Schlüssel und fügen Sie den Server hinzu.