localize.dev

Dokumentation / Agenten / GitHub Copilot in VS Code

Lokalisieren Sie eine App mit GitHub Copilot

Fügen Sie den localize.dev MCP-Server zu .vscode/mcp.json hinzu, damit der Agentenmodus von Copilot hartcodierten UI-Textschlüsseln zuweisen und die Übersetzungen jeder Sprache ausfüllen kann.

Funktionsweise

Copilot verwendet MCP-Server im Agentenmodus, und VS Code liest sie aus .vscode/mcp.json im Workspace. Committen Sie diese Datei und jeder, der das Repository öffnet, erhält die localize.dev-Tools.

Bitten Sie Copilot, neue Schlüssel zu übersetzen, eine Sprache hinzuzufügen oder eine Seite vor der Überprüfung zu prüfen. Die Locale-Dateien ändern sich in Ihrem Arbeitsbereich wie jede andere Bearbeitung, sodass Sie sie im selben Diff überprüfen.

Richten Sie es ein

Führen Sie zuerst npx localize-dev login in Ihrem Terminal aus. Es meldet Sie über den Browser an und speichert einen Schlüssel, den der Server liest, sodass die folgende Konfiguration keine enthält.

  1. Fügen Sie localize zu .vscode/mcp.json in Ihrem Arbeitsbereich hinzu.
  2. Starte 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.
.vscode/mcp.json
{
  "servers": {
    "localize": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Was Sie erhalten

Wohin der Server geht
.vscode/mcp.json
Server
localize-dev mcp, gestartet mit npx auf Ihrem Computer
Schlüssel
Der, den npx localize-dev login gespeichert hat
Was init --agent hinzufügt
Der Abschnitt AGENTS.md mit den Anweisungen. Fügen Sie den Server manuell hinzu, wie oben.

Gut zu wissen

  • Die Datei von VS Code verwendet servers, nicht mcpServers, und jeder Server benötigt "type": "stdio". Ein aus einem anderen Client eingefügter Ausschnitt ist der übliche Grund dafür, dass der Server nicht startet.
  • MCP-Tools sind im Agentenmodus verfügbar, nicht im Ask- oder Edit-Modus.
  • npx localize-dev init --agent schreibt die Anweisungen in AGENTS.md. Wenn Ihr Copilot-Setup AGENTS.md nicht liest, kopieren Sie den Abschnitt in .github/copilot-instructions.md.

Probieren Sie es aus

Fragen Sie etwas wie dieses. Der Agent sollte das translate-Tool aufrufen.

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

Behalten Sie es übersetzt

Text, den der Agent hartcodiert hinterlässt, wird immer noch abgefangen: npx localize-dev check in CI schlägt eine Pull-Anfrage fehl, die nicht übersetzten Text hinzufügt, und sie benötigt keinen Schlüssel.

npx localize-dev check

Alle Agenten und der Tool-Referenz sind auf der MCP-Serverseite.