localize.dev

Documenti / Agenti / GitHub Copilot in VS Code

Localizza un'app con GitHub Copilot

Aggiungi il server MCP localize.dev a .vscode/mcp.json, in modo che la modalità agente di Copilot possa assegnare chiavi di testo dell'interfaccia utente codificate e compilare le traduzioni di ogni lingua.

Come funziona

Copilot utilizza i server MCP in modalità agente e VS Code li legge da .vscode/mcp.json nell'area di lavoro. Esegui il commit di quel file e tutti coloro che aprono il repository otterranno gli strumenti localize.dev.

Chiedi a Copilot di tradurre nuove chiavi, aggiungere una lingua o controllare una pagina prima della revisione. I file di localizzazione cambiano nel tuo spazio di lavoro come qualsiasi altra modifica, quindi li esamini nello stesso diff.

Configuralo

Esegui prima npx localize-dev login nel tuo terminale. Ti autentica tramite il browser e salva una chiave, che il server legge, quindi la configurazione sottostante non ne contiene nessuna.

  1. Aggiungi localize a .vscode/mcp.json nel tuo spazio di lavoro.
  2. Riavvia l'agente o ricarica i suoi server MCP, in modo che avvii localize.
  3. Apri il tuo repository e chiedigli qualcosa come il prompt qui sotto.
.vscode/mcp.json
{
  "servers": {
    "localize": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Cosa ottieni

Dove va il server
.vscode/mcp.json
Server
localize-dev mcp, avviato con npx sulla tua macchina
Chiave
Quello che npx localize-dev login ha salvato
Cosa aggiunge init --agent
La sezione AGENTS.md con le istruzioni. Aggiungi il server manualmente, come sopra.

Buono a sapersi

  • Il file di VS Code usa servers, non mcpServers, e ogni server necessita di "type": "stdio". Uno snippet incollato da un altro client è il motivo usuale per cui il server non si avvia.
  • Gli strumenti MCP sono disponibili in modalità agente, non in modalità richiesta o modifica.
  • npx localize-dev init --agent scrive le istruzioni in AGENTS.md. Se la tua configurazione Copilot non legge AGENTS.md, copia la sezione in .github/copilot-instructions.md.

Provalo

Chiedi qualcosa del genere. L'agente dovrebbe chiamare lo strumento translate.

“Traduci le nuove chiavi in locales/en.json in tutte le lingue.”

Mantienilo tradotto

Il testo che l'agente lascia hardcoded viene comunque rilevato: npx localize-dev check in CI fallisce una pull request che aggiunge testo non tradotto e non necessita di una chiave.

npx localize-dev check

Tutti gli agenti e il riferimento allo strumento si trovano nella pagina del server MCP.