El servidor MCP (Model Context Protocol) de Better i18n permite que agentes de codificación de IA como Claude Code y Cursor gestionen tus traducciones directamente — creando claves, traduciendo contenido, publicando y administrando entradas de contenido.
Instalar el servidor MCP
npx @better-i18n/mcp
O agrégalo a tu archivo de configuración MCP:
{
"mcpServers": {
"better-i18n": {
"command": "npx",
"args": ["-y", "@better-i18n/mcp"],
"env": {
"BETTER_I18N_API_KEY": "sk_tu_clave_secreta"
}
}
}
}
Herramientas disponibles
Gestión de claves de traducción
| Herramienta | Qué hace |
|---|---|
listProjects |
Lista todos tus proyectos |
getProject |
Obtiene detalles del proyecto (idiomas, recuento de claves) |
listKeys |
Navega por las claves de traducción con filtros |
createKeys |
Crea nuevas claves de traducción con valores |
updateKeys |
Actualiza claves existentes o agrega traducciones |
deleteKeys |
Elimina claves de tu proyecto |
publishTranslations |
Envía traducciones al CDN |
CMS de contenido
| Herramienta | Qué hace |
|---|---|
listContentModels |
Lista los esquemas de modelos de contenido |
getContentEntry |
Obtiene una entrada con todas sus traducciones |
listContentEntries |
Lista entradas con filtros |
createContentEntry |
Crea una nueva entrada (todos los idiomas a la vez) |
updateContentEntry |
Actualiza una entrada existente |
bulkUpdateEntries |
Actualiza hasta 20 entradas en una sola llamada |
bulkCreateEntries |
Crea múltiples entradas a la vez |
publishContentEntry |
Publica una entrada en el CDN |
Ejemplos de prompts para agentes
"Agrega una clave de traducción common.save_button con el valor 'Save' y tradúcela al turco, francés y español"
"Encuentra todas las claves sin traducir en el espacio de nombres 'auth' y tradúcelas al alemán"
"Crea un artículo de ayuda sobre cómo empezar con Better i18n, tradúcelo a todos los idiomas del proyecto y publícalo"
"Verifica si todas las claves están sincronizadas con el código y corrige las que faltan"
Autenticación
El servidor MCP usa tu clave API secreta (sk_...). Mantenla segura — no la subas a git.
Para Claude Code, agrega la clave en tu .claude/settings.json bajo env.
Para Cursor, agrégala en la configuración MCP bajo env.
Lo que los agentes pueden y no pueden hacer
Los agentes que usan el servidor MCP pueden:
- Crear, leer, actualizar, eliminar claves de traducción
- Traducir contenido usando IA
- Gestionar entradas y modelos de contenido
- Publicar en el CDN de producción
Los agentes no pueden:
- Acceder a la configuración de facturación o pagos
- Eliminar proyectos u organizaciones
- Invitar miembros del equipo
- Acceder a datos privados de otros usuarios
Registro de actividad MCP
Todas las operaciones MCP se registran en el registro de Actividad de tu proyecto con la etiqueta «Agente» para que puedas ver qué hizo la IA.
¿Te resultó útil este artículo?