Documentación / Agentes / Codex
Localizar una aplicación con Codex
Agregue localize.dev a ~/.codex/config.toml para que OpenAI Codex pueda encontrar texto de interfaz de usuario codificado, asignarle claves y traducirlo, tanto en la CLI como en la extensión del IDE.
Cómo funciona
Codex lee los servidores MCP desde ~/.codex/config.toml, y la CLI y la extensión del IDE comparten ese archivo. Agregue la tabla [mcp_servers.localize] una vez y ambos podrán llamar a las herramientas de localize.dev.
Codex sigue AGENTS.md. npx localize-dev init --agent agrega una sección allí que le indica que llame a localize después de cambiar el texto de la interfaz de usuario y que ejecute npx localize-dev check --changed antes de que termine.
Configúralo
Primero ejecuta npx localize-dev login en tu terminal. Te inicia sesión a través del navegador y guarda una clave, que el servidor lee, por lo que la configuración a continuación no lleva ninguna.
- Agrega la tabla [mcp_servers.localize] a ~/.codex/config.toml.
- Reinicia el agente o recarga sus servidores MCP para que comience a localizar.
- Abre tu repositorio y pídele algo similar a la indicación de abajo.
[mcp_servers.localize]
command = "npx"
args = ["-y", "localize-dev", "mcp"]Lo que obtienes
- Dónde va el servidor
~/.codex/config.toml- Servidor
localize-dev mcp, iniciado con npx en tu máquina- Clave
- El que guardó
npx localize-dev login - Lo que añade
init --agent - La sección
AGENTS.mdcon las instrucciones. Agrega el servidor manualmente, como se indicó anteriormente.
Bueno saberlo
- El archivo de configuración es TOML, no JSON:
commandyargsvan debajo de[mcp_servers.localize]. - Codex no recibe un hook posterior a la edición. La sección
AGENTS.mdy unchecken CI capturan el texto que deja codificado. - Comience con una indicación de solo lectura: pida a Codex que ejecute
checkantes de abrir una solicitud de extracción.checkyconfigno necesitan clave y nunca usan su asignación.
Pruébalo
Pregunta algo como esto. El agente debería llamar a la herramienta check.
“Antes de abrir el PR, verifica si hay texto codificado y traducciones faltantes.”
Mantenlo traducido
El texto que el agente deja codificado aún se detecta: npx localize-dev check en CI falla una solicitud de extracción que agrega una copia no traducida, y no necesita una clave.
npx localize-dev checkTodos los agentes y la referencia de herramientas están en la página del servidor MCP.