Conectar Lokalise con Cursor vía MCP: claves

💡 ¿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 + Cursor

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar 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

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

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