Conectar Crowdin con Gemini CLI vía Crowdin MCP

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

Crowdin + Gemini

Localización con Crowdin en crowdin.com y Crowdin Enterprise mediante la API v2: proyectos y progreso por idioma, archivos, cadenas de origen, traducciones y aprobaciones, comentarios e incidencias, tareas, informes, builds y exportaciones de traducciones, memorias de traducción, glosarios y miembros de los proyectos.

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:

CROWDIN_PERSONAL_ACCESS_TOKEN, CROWDIN_API_HOST

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta en crowdin.com o en Crowdin Enterprise.

1. Crea un personal access token. En crowdin.com: Account Settings > API > New Token. En Crowdin Enterprise: profile > Settings > API > New Token dentro de tu organización.
2. Elige los scopes que necesitas: Projects, Source files and strings, Translations, Tasks, Reports, Translation memory, Glossaries. Con scopes de solo lectura tienes una configuración de solo lectura. Copia el token: solo se muestra una vez.
3. Pégalo en CROWDIN_PERSONAL_ACCESS_TOKEN; se envía como Authorization: Bearer <token>.
4. CROWDIN_API_HOST: api.crowdin.com para crowdin.com, o <organization>.api.crowdin.com para Enterprise, con la organización de tu URL de Enterprise https://<organization>.crowdin.com.
5. Instala el conector y ejecuta crowdin_get_authenticated_user: muestra el usuario al que pertenece el token y confirma token y host.

El servidor MCP propio de Crowdin: Crowdin también ofrece un servidor MCP oficial (https://mcp.crowdin.com/v2/mcp, en Enterprise https://<organization>.mcp.crowdin.com/v2/mcp, con el personal access token como Bearer). Este conector trabaja directamente con la API v2.

Qué lee:

• Proyectos con idiomas de origen y destino, tipo (basado en archivos o en cadenas) y ajustes como workflow, comprobaciones de QA, traducción automática y memoria de traducción; el progreso por idioma del proyecto o de un archivo; todos los idiomas admitidos con su id de Crowdin.
• Ramas, directorios y archivos de origen, más un enlace de corta duración a la versión de origen de un archivo (crowdin_download_file).
• Cadenas de origen con clave, texto, contexto, longitud máxima, etiquetas y formas plurales, filtradas por archivo, rama, directorio, etiqueta, tarea, una coincidencia de texto o una expresión CroQL.
• Traducciones (sugerencias) a un idioma cada vez con autor y valoración, y las aprobaciones con quién aprobó y cuándo.
• Comentarios e incidencias sobre cadenas, por ejemplo peticiones de contexto sin resolver.
• Tareas con tipo, estado, idioma, asignados, progreso y fecha límite; miembros del proyecto con rol e idiomas.
• Memorias de traducción y sus segmentos, una búsqueda de concordancias (crowdin_search_tm) para ver cómo se tradujo antes una frase, glosarios y sus términos.

Qué escribe:

• crowdin_add_string añade una cadena de origen a un archivo (proyectos basados en archivos). crowdin_edit_string la cambia con JSON Patch sobre /text, /identifier, /context, /isHidden, /maxLength o /labelIds; update_option decide qué pasa con las traducciones existentes cuando cambia el texto.
• crowdin_add_translation añade una sugerencia; crowdin_approve_translation la aprueba para que entre en los archivos exportados (requiere permisos de proofreader en ese idioma).
• crowdin_add_comment comenta una cadena o informa de una incidencia: una pregunta, un error de traducción o del texto de origen, una petición de contexto.
• crowdin_create_task crea una tarea de traducción o revisión para archivos (o cadenas en proyectos basados en cadenas) en un idioma, con asignados y fecha límite; en Enterprise usa workflow_step_id en lugar de type. crowdin_edit_task la cambia con JSON Patch, por ejemplo /status a done.
• crowdin_add_tm_segment añade a una memoria de traducción la misma frase en varios idiomas; crowdin_add_glossary_term añade un término, opcionalmente como traducción de un término existente o dentro de un concepto.

Informes y archivos traducidos: los informes se generan en segundo plano. crowdin_generate_report devuelve data.identifier; la IA consulta crowdin_get_report_status hasta que status sea finished y después obtiene el enlace con crowdin_download_report. crowdin_export_project_translation exporta un idioma al momento como un único archivo. crowdin_build_project_translations genera todos los archivos e idiomas en un zip: la IA consulta crowdin_get_build_status y después llama a crowdin_download_build. Los enlaces de descarga caducan al poco tiempo (expireIn), así que la IA te los entrega en lugar de guardarlos. Estas llamadas son POST, pero no cambian el contenido.

Nada está desactivado al instalar: no hay herramientas de borrado.

Ids y formatos: los ids de proyectos, archivos, cadenas, traducciones, tareas y usuarios son números; los identificadores de informes son cadenas. Los idiomas usan ids de Crowdin como de, fr, es-ES, pt-BR o zh-CN. Las horas son ISO 8601 con desfase. Las herramientas PATCH aceptan listas JSON Patch: [{"op": "replace", "path": "/status", "value": "done"}]. Las listas llegan como {"data": [{"data": {...}}, ...], "pagination": {"offset": 0, "limit": 25}} y los elementos individuales como {"data": {...}}. El progreso se cuenta en words y phrases, con translationProgress y approvalProgress en porcentaje.

Paginación: limit (25 por defecto, como máximo 500) y offset. Cuando una página trae limit elementos, la IA pide la siguiente con offset + limit.

Límites: 20 peticiones simultáneas por cuenta, sumando todos sus tokens, en crowdin.com y en Enterprise; 429 significa esperar.

Errores comunes: 401 indica un token incorrecto o caducado, o el host equivocado. 403 indica un token sin el scope o una cuenta sin permisos en el proyecto. 404 indica un id desconocido. 400 y 422 son errores de validación que nombran el campo.

El conector no borra proyectos, archivos, cadenas ni traducciones y no sube archivos de origen.

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 Crowdin.

Herramientas disponibles

Ejemplos de prompts

• "¿Cómo van las traducciones al alemán y al japonés de nuestro proyecto de la app, entre traducido y aprobado?"
• "¿Qué cadenas del archivo checkout tienen incidencias abiertas que piden contexto?"
• "¿Cómo tradujimos antes "Sign in" al francés? Busca en la memoria de traducción."
• "Crea una tarea de revisión para la traducción al español del archivo de onboarding, con fecha límite el viernes, y asígnasela a Maria."
• "Genera los archivos traducidos de todos los idiomas, solo con traducciones aprobadas, y dame el enlace del zip."

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