Locize

Sistema de gestión de traducciones Locize: 26 herramientas para traducciones, contexto de memoria de traducción/glosario/guía de estilo/captura de pantalla, versiones. OAuth.

Ver en locize.comPrueba este MCPPatrocinado

Documentación

Servidor MCP de Locize

El servidor MCP (Model Context Protocol) de Locize permite que los asistentes de IA (Claude, Cursor, GitHub Copilot y otros) interactúen directamente con tus proyectos de traducción.

URL del servidor: https://mcp.locize.app

smart_display

Video de YouTube

Este video está alojado en YouTube. Acepta las cookies de YouTube para verlo aquí.

Configuración

Claude Desktop / claude.ai (OAuth)

Ve a Configuración > Conectores > Agregar conector personalizado
Ingresa la URL: https://mcp.locize.app
Haz clic en Conectar y tu navegador abrirá una pantalla de inicio de sesión/consentimiento
Inicia sesión con tu cuenta de Locize y otorga los permisos solicitados
Se crea automáticamente un Token de Acceso Personal en tu perfil

Claude Code (CLI)

claude mcp add --transport http locize https://mcp.locize.app

Luego ejecuta /mcp en una sesión de Claude Code y completa el flujo de OAuth.

Nota: Después del primer OAuth, Claude Code puede mostrar "Autenticación exitosa, pero la reconexión del servidor falló." Este es un problema conocido de Claude Code; simplemente reinicia Claude Code y el servidor se conectará automáticamente usando el token almacenado.

Otros clientes nativos HTTP (Cursor, VS Code, etc.)

Agrega la URL del servidor https://mcp.locize.app en la configuración de MCP de tu cliente y completa el flujo de OAuth. Los pasos exactos varían según el cliente; consulta la documentación de MCP de tu cliente.

Transporte Stdio (alternativa a PAT)

Para clientes que admiten stdio pero no HTTP, usa mcp-remote como puente:

{
  "mcpServers": {
    "locize": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.locize.app"]
    }
  }
}

Autenticación

El servidor MCP admite dos métodos de autenticación:

OAuth 2.0 (recomendado): se usa automáticamente con Claude Desktop, Cursor y otros clientes MCP que lo admiten. No se necesita gestión manual de tokens. El flujo de OAuth crea un Token de Acceso Personal en tu perfil automáticamente. El acceso se puede revocar en cualquier momento.

Token de Acceso Personal (PAT): para CI/CD, scripts o clientes que no admiten OAuth. Crea uno en tu perfil en Tokens de Acceso Personal. Pásalo como Authorization: Bearer lz_pat_.... Consulta la documentación de PAT para detalles sobre alcances y seguridad.

Herramientas disponibles

El servidor MCP expone 28 herramientas organizadas por flujo de trabajo:

Descubrimiento

Herramienta	Descripción
`list_projects`	Lista todos los proyectos accesibles mediante tu token. Llama a esta primero.
`get_project_stats`	Cobertura de traducción por versión, idioma y espacio de nombres
`list_branches`	Lista los proyectos de rama de un proyecto padre
`list_tenants`	Lista los proyectos de tenant de un proyecto padre

Contenido de traducción

Herramienta	Descripción
`get_translations`	Obtén traducciones no publicadas (estado de editor) con filtrado por etiquetas, marcas de tiempo, la cola de revisión necesaria (`needsReviewOnly`) y paginación; `raw` incluye la bandera `needsReview`
`get_published_translations`	Obtén traducciones publicadas (CDN) para un espacio de nombres
`find_missing_translations`	Compara un idioma de destino contra el idioma de referencia; devuelve claves faltantes y desactualizadas
`report_missing_keys`	Agrega nuevas claves (nunca sobrescribe las existentes). Agrupa automáticamente en lotes de 1000 claves. Si la Traducción Automática está habilitada, las nuevas claves en el idioma de referencia se traducen automáticamente a todos los idiomas de destino.
`update_translations`	Actualiza o elimina claves de traducción. Establece un valor en `null` para eliminar. Estado `quality: "AI"` para textos generados por el agente (la regla de revisión necesaria del proyecto los marca) o `"HT"` para el texto de una persona; sin él, un push confirma, como antes. `needsReview` marca o confirma explícitamente.

Revisión

Herramienta	Descripción
`list_review_proposals`	Las propuestas de revisión pendientes de un espacio de nombres: clave, texto actual, texto propuesto, quién propuso (una persona, una clave de API, el pipeline de IA o revisión de IA), confianza, razón y crítica. Filtra por origen para ver lo que la revisión de IA duda.
`start_ai_review`	Inicia una ejecución de revisión de IA sobre una versión (idiomas, espacios de nombres, verifica todo de nuevo, límite de presupuesto). Se rechaza con la estimación cuando los tokens de IA son insuficientes; devuelve la ejecución y un jobId para `get_job_status`. Solo administrador o gerente.

Contexto

Estas herramientas de solo lectura le dan al agente el mismo contexto que tiene un traductor humano, para que pueda traducir, revisar y hacer lint en tu IDE.

Herramienta	Descripción
`get_glossary`	Obtén el glosario de terminología del proyecto (términos aprobados y prohibidos por idioma). Usa el valor preferido de cada término al traducir, o haz lint de nuevas cadenas fuente para detectar desviaciones de términos prohibidos.
`get_styleguide`	Obtén la guía de estilo del proyecto (tono, formalidad, audiencia objetivo, reglas de uso) por idioma
`search_translation_memory`	Encuentra segmentos previamente traducidos similares a una cadena fuente (exactos y aproximados) para reutilizar traducciones anteriores
`get_screenshot_context`	Obtén las capturas de pantalla y la región mapeada donde aparece una clave, para desambiguación visual

Flujo de trabajo de publicación

Herramienta	Descripción
`publish_version`	Publica una versión en el CDN. Devuelve un jobId para el seguimiento de estado.
`copy_version`	Copia todas las traducciones de una versión a otra (por ejemplo, latest → production)
`copy_language`	Copia un solo idioma entre versiones
`get_job_status`	Verifica o espera a que las operaciones asíncronas (publicar, copiar, fusionar) se completen

Flujo de trabajo de ramas

Herramienta	Descripción
`create_branch`	Crea una rama de traducción desde una versión
`merge_branch`	Fusiona una rama de vuelta a su proyecto padre

Estructura del proyecto

Herramienta	Descripción
`add_language`	Agrega un idioma al proyecto
`remove_language`	Elimina un idioma y todas sus traducciones
`change_languages`	Reemplaza la lista completa de idiomas de forma atómica
`add_version`	Agrega una nueva versión
`delete_version`	Elimina una versión y todas sus traducciones
`rename_namespace`	Renombra un espacio de nombres en todos los idiomas
`delete_namespace`	Elimina un espacio de nombres y todas sus traducciones

Ejemplos de prompts

Una vez conectado, puedes preguntarle a tu asistente de IA cosas como:

"Encuentra todas las traducciones al alemán faltantes en el espacio de nombres checkout"
"Publica la última versión de mi proyecto"
"Agrega japonés a todas las versiones"
"Crea una rama para la función v2, tradúcela y luego fusiónala de vuelta"
"Muéstrame qué claves cambiaron en inglés esta semana"
"Reporta estas nuevas claves de mi código base a Locize"
"¿Cuál es la cobertura de traducción para la versión de producción?"
"Traduce estas nuevas cadenas usando el glosario y la guía de estilo del proyecto"
"Haz lint de las nuevas cadenas en inglés de este PR para detectar términos prohibidos del glosario"
"Muéstrame la captura de pantalla donde aparece la clave checkout.title"

Convenciones del agente

Para que tu agente de IA use estas herramientas por defecto — obtener el glosario y la guía de estilo antes de traducir, reutilizar la memoria de traducción y hacer lint de las solicitudes de extracción para términos prohibidos — coloca nuestros archivos de convenciones listos para usar (CLAUDE.md, AGENTS.md, .cursorrules) en tu repositorio. Viven en el repositorio público locize/locize-agents.

Alcances de PAT

Las herramientas requieren alcances de PAT específicos. Si una herramienta devuelve un error de alcance, tu token necesita permisos adicionales.

Alcance	Herramientas
`read`	`list_projects`, `get_project_stats`, `list_branches`, `list_tenants`, `get_translations`, `get_published_translations`, `find_missing_translations`, `get_glossary`, `get_styleguide`, `search_translation_memory`, `get_screenshot_context`, `list_review_proposals`
`write`	`report_missing_keys`, `update_translations`, `rename_namespace`, `delete_namespace`
`manage`	`publish_version`, `copy_version`, `copy_language`, `get_job_status`, `create_branch`, `merge_branch`, `add_language`, `remove_language`, `change_languages`, `add_version`, `delete_version`, `start_ai_review`

Más allá de los alcances de PAT

Los alcances de PAT son solo la primera puerta. Tu rol y permisos a nivel de proyecto aún se aplican encima:

Rol de proyecto: tu rol en un proyecto determinado (admin / gerente / publicador / usuario / contador) siempre gana cuando es más estricto que el alcance del PAT. Por ejemplo, un PAT con alcance manage llamado por un usuario cuyo rol de proyecto es readonly aún no puede modificar ese proyecto.
Alcance de idioma / versión / espacio de nombres: si tu membresía está restringida a idiomas, versiones o espacios de nombres específicos, get_translations y find_missing_translations rechazarán solicitudes fuera de ese alcance.
Usuarios translateOnly: las herramientas estructurales (add_language, remove_language, change_languages, add_version, delete_version, publish_version, copy_version, copy_language, create_branch, merge_branch, rename_namespace, delete_namespace) están bloqueadas para usuarios marcados como solo traducción.
Cambios estructurales: add_language, remove_language, change_languages, add_version, delete_version, rename_namespace, delete_namespace y copiar a una versión nueva requieren el rol de admin o gerente sin restricción de versión, idioma o espacio de nombres, exactamente como el panel de control. merge_branch necesita el rol de admin o gerente; publish_version, copy_version y copy_language están abiertos también a publicadores, dentro de su restricción.
Acceso bloqueado / revocado: si tu membresía de proyecto está bloqueada o tu PAT ha sido revocado, cada llamada a herramienta falla inmediatamente con un 401.
Acceso al proyecto padre: para proyectos de tenant y rama, la fusión de traducciones con el padre solo ocurre si tu PAT también tiene acceso al proyecto padre; de lo contrario, ves la vista solo-hijo.

Detalles técnicos

Transporte: HTTP Streamable (Estándar Web Request / Response)
Autenticación: OAuth 2.0 (Código de Autorización + PKCE con Registro Dinámico de Clientes) o token Bearer PAT
Endpoint: POST https://mcp.locize.app
Metadatos de OAuth: GET https://mcp.locize.app/.well-known/oauth-protected-resource
Sin estado: Cada solicitud crea una instancia nueva del servidor MCP. No se requiere gestión de sesiones.

Ver también

¿Por qué no simplemente usar IA para traducir?: cómo Locize y las herramientas de IA se complementan
Traducción Automática: combina saveMissing con auto-traducción de IA para un flujo de trabajo totalmente automatizado
Tokens de Acceso Personal: crea y gestiona tokens para la autenticación de MCP