Tolgee
Gestiona las traducciones de tu aplicación directamente desde tu asistente de codificación de IA. Busca claves, crea traducciones, activa la traducción automática. Todo sin salir de tu editor.
Documentación
Versión: 3.x.x
En esta página
El servidor MCP de Tolgee lleva todo el poder de Tolgee a tu asistente de codificación con IA, permitiéndote gestionar traducciones sin salir de tu editor. Conecta Claude Code, Cursor o cualquier asistente de IA compatible con MCP a tu proyecto de Tolgee y comienza a gestionar tareas de localización de forma conversacional.
¿Qué es el servidor MCP de Tolgee?
El servidor MCP de Tolgee es el endpoint del Model Context Protocol integrado en la plataforma Tolgee. Permite que los asistentes de IA (Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT y cualquier otro cliente compatible con MCP) gestionen tus proyectos de localización de Tolgee mediante lenguaje natural.
Está alojado en https://app.tolgee.io/mcp/developer para Tolgee Cloud y está disponible en cada instancia de Tolgee autoalojada. Sin proxy, sin procesos separados. Tu cliente de IA se comunica con Tolgee directamente a través de HTTP.
El servidor es mantenido por el equipo de Tolgee y está listado en el Registro MCP como io.github.tolgee/tolgee.
¿Qué clientes MCP son compatibles?
El servidor MCP de Tolgee utiliza el transporte MCP estándar streamable-HTTP, por lo que funciona con cualquier cliente compatible con MCP que admita servidores HTTP remotos y encabezados de solicitud personalizados. La autenticación siempre se realiza mediante el encabezado X-API-Key.
Roles disponibles
El servidor MCP actualmente expone un único endpoint basado en roles:
| Rol | Endpoint | Descripción |
|---|---|---|
| Desarrollador | /mcp/developer | Acceso completo a claves, traducciones, idiomas, etiquetas, espacios de nombres, ramas y operaciones por lotes. |
Se planean más roles (por ejemplo, traductor, gestor de proyectos) para futuras versiones.
Cómo empezar
- Sigue la guía de configuración para conectar tu cliente de IA a Tolgee.
- Consulta la guía de uso para ver flujos de trabajo de ejemplo y mejores prácticas.
¿Cómo se compara el servidor MCP de Tolgee con la CLI de Tolgee y la API REST?
Los tres hablan con la misma API subyacente de Tolgee, pero están dirigidos a diferentes flujos de trabajo. El servidor MCP de Tolgee es para uso en lenguaje natural desde un asistente de IA. La CLI de Tolgee es para operaciones scriptadas y repetibles, como push y pull en pipelines de CI. La API REST de Tolgee es para crear tus propias integraciones, paneles o funciones dentro del producto. Son complementarios, no alternativas; la mayoría de los equipos terminan usando dos o tres.
| Servidor MCP de Tolgee | CLI de Tolgee | API REST de Tolgee | |
|---|---|---|---|
| Mejor para | Uso conversacional desde asistentes de IA | Scripts, sincronización CI | Crear tus propias apps e integraciones |
| Dónde se usa | Claude, Cursor, ChatGPT, Windsurf… | Terminal | Tu código (cualquier lenguaje) |
| Autenticación | PAK o PAT mediante X-API-Key | PAK o PAT | PAK o PAT |
| Descubribilidad | Alta (la IA lista herramientas y solicita parámetros faltantes) | Media (usa tolgee --help) | Baja (lee la especificación OpenAPI) |
| Determinismo | Bajo: el lenguaje natural puede ser ambiguo | Alto | Alto |
| Operaciones masivas / por lotes | ✔ | ✔ | ✔ |
Un estado final común de nuestros usuarios:
- Servidor MCP — trabajo exploratorio diario y correcciones puntuales desde Claude o Cursor.
- CLI — sincronización confirmada entre el repositorio y Tolgee en CI (por ejemplo,
tolgee pushal fusionar enmain). - API REST — consulta de traducciones dentro de la app, paneles personalizados o webhooks.