Servidor MCP

azbox-mcp-server permite a un agente de código leer tu proyecto de AZbox sin salir del editor. Funciona con cualquier cliente MCP —Claude Code, Cursor, Claude Desktop y otros— y es de código abierto (GitHub).

Para qué sirve

Tres cosas que un agente que edita tu código necesita a menudo, respondidas desde el proyecto en lugar de adivinadas:

• «¿Qué clave tiene el texto “Ir a pagar” de la pantalla del carrito?»
• «¿Qué falta por traducir al francés?»
• «Antes de añadir checkout.total, ¿hay ya una clave parecida?»

Qué necesitas

• Node 18 o superior
• Una clave de API. En el panel, abre Ajustes → API keys y crea una atada al proyecto en el que trabaja el agente. Un agente solo necesita leer ese proyecto, así que no hay motivo para darle el resto de la cuenta. Copia la clave cuando aparezca: no se puede volver a mostrar.

Configuración

Claude Code

claude mcp add azbox --env AZBOX_TOKEN=azb_live_… -- npx -y azbox-mcp-server

Cursor

En ~/.cursor/mcp.json:

{
  "mcpServers": {
    "azbox": {
      "command": "npx",
      "args": ["-y", "azbox-mcp-server"],
      "env": { "AZBOX_TOKEN": "azb_live_…" }
    }
  }
}

Claude Desktop

El mismo bloque, en claude_desktop_config.json (en macOS, dentro de ~/Library/Application Support/Claude/). Reinicia la aplicación después.

Cualquier otro cliente

Comando npx -y azbox-mcp-server, con la clave en la variable de entorno AZBOX_TOKEN. El servidor habla por stdio.

Herramientas

Las seis son de solo lectura. Nada de lo que hace este servidor puede cambiar tu proyecto.

Herramienta	Qué responde
azbox_list_projects	Qué proyectos ve la clave, y en qué idiomas
azbox_get_project	El nombre de un proyecto y sus códigos de idioma válidos
azbox_list_categories	Cómo está organizado el proyecto
azbox_list_keywords	Una página de claves con sus traducciones
azbox_search_keywords	Qué clave tiene este texto, o qué claves empiezan por checkout.
azbox_find_untranslated	Qué falta todavía en un idioma

Los listados van paginados: aceptan limit y offset y devuelven total_count, has_more y next_offset. Un proyecto real tiene miles de claves, y volcarlas todas dejaría al agente sin espacio para trabajar.

Lo que no hace, a propósito

• No escribe. Las claves se crean en el panel o importando un fichero.
• No traduce. La traducción automática se hace en el panel, donde ves el resultado antes de publicarlo.

Conviene saber

• La clave que usas en el código es key. El campo id de la API es un identificador interno del documento.
• translation es null cuando una clave todavía no tiene texto en el idioma pedido.
• Un idioma vacío no es un error: la herramienta devuelve una lista vacía.
• Las claves salen ordenadas, así que llamadas repetidas dan lo mismo.

Por debajo usa la misma API REST que las librerías. Para enseñar además al agente a integrar AZbox en el código, añade el skill para agentes de código.