Blog

Localizando mientras tu agente de codificación escribe

El servidor MCP de localize.dev y un hook posterior a la edición permiten a Claude Code, Cursor y otros agentes traducir nuevo texto de la interfaz de usuario en el mismo cambio que lo añade.

Stephen Ufort · 11 de noviembre de 2026 · 3 min de lectura

Claude Code llamando a la herramienta localize MCP para arreglar una línea que falló la verificación i18n

Los agentes de codificación escriben texto de interfaz de usuario rápidamente, y casi todo es inglés codificado. Una aplicación que se localizó completamente el mes pasado puede tener docenas de cadenas sin traducir este mes, y nadie las escribió a mano.

localize.dev proporciona a los agentes la misma motor que usa la CLI, como un servidor MCP, además de un hook que informa al agente cuando un archivo que acaba de editar tiene texto sin traducir. Este post explica cómo encajan las dos cosas.

Cinco herramientas

El servidor MCP tiene cinco herramientas. Dos de ellas son gratuitas y no requieren clave:

  • check: copias codificadas y traducciones faltantes o desactualizadas, cada una con su archivo y línea. Usa paths para verificar solo los archivos que cambió el agente.
  • config: las convenciones de la app para escribir texto de interfaz de usuario, de modo que el código nuevo llame a t() de la misma manera que el resto de la app.
  • localize: proporciona claves de texto codificadas, reescribe el código y traduce los nuevos mensajes.
  • translate: llena traducciones faltantes en los archivos de idioma.
  • add_language: agrega un idioma a la configuración y traduce todos los mensajes a ese idioma.

Ejécútalo localmente con npx -y localize-dev mcp, para que la reescritura del código ocurra en tu máquina. Los constructores de navegador como Lovable, Bolt y v0 no pueden iniciar un proceso local, así que se conectan al servidor alojado en https://uselocalize.dev/api/mcp con OAuth o una clave API.

El hook que cierra el ciclo

Una herramienta MCP solo ayuda si el agente recuerda llamarla. En Claude Code, un hook post-edición asegura que lo haga. Después de cada edición o escritura, el hook ejecuta check en el archivo que acaba de cambiar el agente. Si el archivo es código UI sin traducir, el hook sale con código 2, y Claude Code muestra su mensaje al agente:

what the agent sees
localize.dev: src/components/SignIn.tsx has UI text that isn't translated yet.
  line 9: "We'll email you a 6-digit code. No password needed."
Call the localize tool of the localize-dev MCP server with paths ["components/SignIn.tsx"]: it gives this text translation keys, rewrites the code and translates it.
Without the MCP server, run in the project folder: npx localize-dev run --files src/components/SignIn.tsx

El agente luego llama a localize con esa ruta. La oración obtiene una clave, la línea se reescribe para llamar a t(), y el nuevo mensaje se traduce a todos los idiomas que tiene la aplicación, en el mismo cambio que el código que el agente estaba escribiendo.

El hook nunca interfiere con el agente. Un archivo que no sea código UI, un archivo limpio, y cualquier error en el hook mismo todos salen con código 0 y no muestran nada. Configura LOCALIZE_DEV_HOOK=off para desactivarlo en una sesión.

Configuración

Un comando añade todo al repositorio:

npx localize-dev init --agent
  • El servidor MCP en .mcp.json para Claude Code y .cursor/mcp.json para Cursor.
  • El hook post-edición en .claude/settings.json, en Editar, MultiEditar y Escribir.
  • Una sección en AGENTS.md y CLAUDE.md, y una regla Cursor para los archivos UI de la app, que indica al agente que localice mientras escribe y que ejecute check antes de terminar.

Solo añade a lo que ya está. Tus otros servidores, hooks e instrucciones permanecen, y ejecutarlo de nuevo reemplaza su propia sección en lugar de añadir una segunda. Añade --pre-commit para verificar también los archivos en staging antes de cada commit, para cambios realizados sin un agente.

¿Por qué no simplemente preguntar al agente?

Puedes pedirle a un agente que extraiga y traduzca cadenas sin todo esto, y para un archivo a menudo funciona. En toda la aplicación, las claves se desplazan entre archivos, las formas plurales que el agente no consideró desaparecen, y nada detecta la siguiente oración sin traducir. El servidor MCP le da al agente el mismo registro de claves, las mismas verificaciones de traducción y la misma comprobación CI que en una ejecución completa.

Pruébalo en tu propio código en la zona de juegos, no se necesita cuenta