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.
- Fügen Sie localize zu .vscode/mcp.json in Ihrem Arbeitsbereich hinzu.
- Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
- Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.
{
"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 logingespeichert hat - Was
init --agenthinzufügt - Der Abschnitt
AGENTS.mdmit den Anweisungen. Fügen Sie den Server manuell hinzu, wie oben.
Gut zu wissen
- Die Datei von VS Code verwendet
servers, nichtmcpServers, 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 --agentschreibt die Anweisungen inAGENTS.md. Wenn Ihr Copilot-SetupAGENTS.mdnicht 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 checkAlle Agenten und der Tool-Referenz sind auf der MCP-Serverseite.