Conectar Crowdin con Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Crowdin.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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