Conectar Lokalise con Gemini CLI vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Lokalise, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Lokalise + Gemini

Gestión de traducciones con Lokalise mediante la API v2: proyectos con progreso por idioma, claves y traducciones con indicadores de revisión, idiomas, colaboradores, tareas de traducción y revisión, exportaciones de archivos como procesos en segundo plano, comentarios, metadatos de capturas, ramas, estados de traducción personalizados y el glosario.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

LOKALISE_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Lokalise con acceso a los proyectos.

1. En Lokalise haz clic en tu foto de perfil, abre Profile settings > API tokens y genera un token. Para las herramientas de lectura basta un token de solo lectura; los cambios necesitan un token de lectura y escritura.
2. Pégalo en LOKALISE_API_TOKEN. Se envía en la cabecera X-Api-Token y actúa con tus permisos en cada proyecto.
3. Instala el conector y ejecuta lokalise_list_projects para comprobar el token.

Los servidores MCP propios de Lokalise: Lokalise también ofrece servidores MCP en beta (https://mcp.lokalise.com/mcp/project-management y /mcp/software-development, con OAuth o una cabecera apikey). Este conector trabaja con la API v2 y tu token.

Qué lee:

• Proyectos con tipo, idioma base y equipo; con include_statistics: 1, el progreso, las claves, las palabras y los problemas de QA por idioma. Los idiomas del proyecto, todos los idiomas que admite Lokalise con su código ISO y formas plurales, y los estados de traducción personalizados.
• Claves con nombre por plataforma, descripción, etiquetas, nombres de archivo, contexto, límite de caracteres y, con include_translations: 1, sus textos. Filtros: nombre de clave, etiqueta, nombre de archivo, plataforma, sin traducir, problemas de QA o archivadas.
• Traducciones, una fila por clave e idioma, filtradas por idioma, revisadas, sin verificar, sin traducir, problemas de QA o tarea activa.
• Colaboradores con permisos e idiomas, y lokalise_get_my_contributor para el titular del token, a cuyo nombre se hacen las escrituras.
• Tareas con tipo, estado, fecha límite, idiomas, asignados y progreso; archivos con número de claves y última importación; comentarios por proyecto o por clave; metadatos de capturas con las claves vinculadas; ramas; términos del glosario con traducciones, etiquetas e indicadores.

Qué escribe:

• lokalise_create_keys añade cadenas nuevas con sus plataformas y texto de origen. lokalise_update_key y lokalise_bulk_update_keys cambian nombres, descripciones, etiquetas (merge_tags añade en lugar de sustituir), plataformas, nombres de archivo, contexto, límites de caracteres y traducciones.
• lokalise_update_translation cambia un texto y sus indicadores de revisada, sin verificar o estado personalizado. Las claves plurales aceptan una cadena JSON con las formas (one, other, ...).
• lokalise_add_languages por código ISO; lokalise_add_contributors, que envía emails de invitación; lokalise_create_task para una tarea translation, review o automatic_translation sobre algunas claves e idiomas, asignada a usuarios o grupos con fecha límite; lokalise_update_task, donde {"close_task": true} la cierra.
• lokalise_add_key_comments (una pregunta a los traductores o contexto para una cadena), lokalise_create_branch, lokalise_create_glossary_terms (por ejemplo nombres de marca que no se traducen, o palabras prohibidas) y lokalise_update_glossary_terms.

Exportación de archivos: lokalise_download_files inicia una exportación en un formato como json, xliff, strings, xml, po o yaml y devuelve un process_id. La IA llama a lokalise_get_process hasta que status sea finished y te entrega el enlace zip de details.download_url, que caduca al cabo de un rato. La exportación es un POST, pero no cambia el proyecto.

Desactivada al instalar: lokalise_delete_key, que borra una clave con todas sus traducciones y no se puede deshacer. Un admin del workspace la activa cuando el equipo la necesita.

Ids y formatos: los ids de proyecto tienen la forma 767946315e9866d013c1d0.08299127; para trabajar en una rama, pasa <project id>:<branch name>. Los ids de claves, traducciones, tareas, idiomas y usuarios son números. Los idiomas son códigos ISO como en, de o pt_BR. Las respuestas de listas envuelven los elementos (projects, keys, translations, ...). Las horas llegan como YYYY-MM-DD HH:MM:SS (Etc/UTC) más un ..._timestamp Unix. Los indicadores en filtros son 0 o 1.

Paginación: limit y page; los totales llegan en las cabeceras x-pagination-total-count y x-pagination-page-count, mostradas en _headers. Las claves y traducciones también aceptan pagination: cursor: la IA pasa el valor de x-pagination-next-cursor como cursor hasta que deja de aparecer. Los términos del glosario se paginan solo con cursor.

Límites: 6 peticiones por segundo por token y por dirección IP, y como máximo 10 peticiones simultáneas por proyecto; 429 significa ir más despacio.

Errores comunes: 401 indica un token incorrecto. 403 indica un token de solo lectura usado para escribir, o falta de permisos en el proyecto. 404 indica un proyecto o elemento desconocido. 400 es un error de validación que nombra el campo; también aparece cuando el valor de X-Api-Token no es un token válido, por ejemplo con espacios o comillas.

El conector no sube archivos de traducción (eso requiere contenido en base64) ni capturas, y no borra proyectos, idiomas, tareas ni términos del glosario.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Lokalise.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuál es el progreso de traducción del proyecto de la app móvil por idioma?"
• "¿Qué claves con la etiqueta checkout siguen sin traducir en alemán y francés?"
• "Exporta el proyecto web como archivos JSON para de e it y dame el enlace de descarga."
• "Crea una tarea de revisión para las traducciones al español de las claves del onboarding, con fecha límite el próximo viernes."
• "Añade "AnythingMCP" al glosario como nombre de marca que no se traduce."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot