Conecte su asistente de IA a LabelGrid (MCP)

Actualizado en julio de 2026.

LabelGrid publica un servidor MCP (Model Context Protocol) oficial para que pueda conectar su propio asistente de IA a su cuenta de LabelGrid y trabajar en lenguaje natural. En lugar de escribir llamadas REST, puede pedirle a su IA que prepare un borrador de lanzamiento, lo valide, consulte su estado de revisión u obtenga sus analíticas, y ella usa la API de LabelGrid por debajo.

El servidor es el paquete npm @labelgrid/mcp y es de código abierto bajo licencia MIT en github.com/labelgrid/labelgrid-mcp. Funciona con Claude Desktop, Claude Code, Cursor o cualquier cliente compatible con MCP.

Qué puede hacer

Una vez conectado, puede pedirle a su asistente de IA que:

• Cree y actualice borradores de lanzamientos y pistas — complete los metadatos de forma conversacional
• Suba audio, portadas y documentos de licencia a sus lanzamientos y pistas
• Valide los lanzamientos antes de enviarlos para detectar problemas a tiempo
• Consulte incidencias de revisión, informes de calidad y estado de entrega
• Obtenga analíticas de streaming, informes de regalías y desgloses
• Gestione webhooks para notificaciones asíncronas
• Envíe lanzamientos a distribución o los retire — disponible solo cuando habilita explícitamente estas acciones (vea Seguridad y permisos)

Por debajo, el servidor expone más de 80 herramientas repartidas en diez conjuntos: identidad, datos de referencia, catálogo (sellos, artistas, autores y editores), lanzamientos y pistas, revisión y calidad, analíticas, contabilidad y regalías, estado de entrega, webhooks y distribución. Las subidas de archivos forman parte de los conjuntos de catálogo y distribución.

---

Qué necesita

1. Una cuenta de LabelGrid con acceso a la API. El acceso a la API forma parte de los planes de API de LabelGrid — vea la visión general de la API para saber cómo obtenerlo.
2. Un token de API. Genérelo en su panel de LabelGrid en Perfil → Tokens de API.
3. Node.js 20 o superior en el equipo donde se ejecuta su cliente de IA.

---

Instalación

Añada LabelGrid a la configuración MCP de su cliente de IA:

{
  "mcpServers": {
    "labelgrid": {
      "command": "npx",
      "args": ["-y", "@labelgrid/mcp"],
      "env": {
        "LABELGRID_API_TOKEN": "your-api-token"
      }
    }
  }
}

Sustituya your-api-token por el token de su panel y reinicie el cliente.

En Claude Code basta un solo comando:

claude mcp add labelgrid -e LABELGRID_API_TOKEN=your-api-token -- npx -y @labelgrid/mcp

---

Configuración guiada

Si inicia el servidor sin un token, no falla: arranca en un modo de configuración guiada. Añada LabelGrid a su cliente sin el valor de LABELGRID_API_TOKEN y luego pídale a su IA que “configure LabelGrid”; le guiará para crear el token y le indicará dónde colocarlo. El token en sí nunca se pega en el chat.

---

Seguridad y permisos

El servidor usa tres niveles de permisos para que usted decida cuánto puede hacer su IA:

• Las lecturas están siempre disponibles. Su IA puede consultar lanzamientos, pistas, revisiones, analíticas, informes y estado de entrega en cualquier momento.
• Las escrituras seguras están activadas por defecto. Crear y editar borradores, actualizar metadatos y gestionar webhooks vienen habilitados de serie. Puede desactivarlas con LABELGRID_ENABLE_WRITES=false, o forzar todo a solo lectura con LABELGRID_READ_ONLY=true.
• Las acciones de mayor alcance están desactivadas por defecto. Enviar un lanzamiento a distribución, retirarlo y las subidas de archivos inmutables requieren LABELGRID_ENABLE_FULL_WRITES=true más una frase de confirmación explícita, documentada en el README del proyecto.

Todas las protecciones de su cuenta — validación, límites del plan y límites de peticiones — las aplican los servidores de LabelGrid. La IA no puede eludirlas, con independencia de los permisos que le conceda.

---

Limitar qué herramientas están disponibles

Si solo quiere exponer una parte de su cuenta, configure LABELGRID_TOOLSETS para limitar qué áreas de herramientas ofrece el servidor. Así la IA se mantiene centrada en las áreas que usted elija.

---

Solución de problemas

• Token no válido o rechazado — vuelva a crear el token en su panel, en Perfil → Tokens de API, y actualícelo en su configuración MCP.
• No ve la página “Tokens de API” — su cuenta aún no tiene acceso a la API. Vea la visión general de la API para saber cómo habilitarlo.
• No sabe si el servidor se conectó — el servidor imprime su estado al arrancar; revise los registros MCP de su cliente.
• Quiere desconectarlo — puede revocar un token en cualquier momento desde su panel, lo que detiene el acceso de inmediato.

---

FAQ

”¿Tiene LabelGrid un servidor MCP?”

Sí. LabelGrid publica un servidor MCP oficial como el paquete npm @labelgrid/mcp, de código abierto bajo licencia MIT en github.com/labelgrid/labelgrid-mcp. Conecta Claude Desktop, Claude Code, Cursor o cualquier cliente de IA compatible con MCP a su cuenta de LabelGrid para que pueda trabajar en lenguaje natural.

”¿Qué puedo hacer con él?”

Crear y actualizar borradores de lanzamientos y pistas; subir audio, portadas y documentos de licencia; validar lanzamientos antes de enviarlos; consultar incidencias de revisión, informes de calidad y estado de entrega; obtener analíticas de streaming, informes de regalías y desgloses; y gestionar webhooks. Enviar lanzamientos a distribución y retirarlos solo está disponible cuando lo habilita explícitamente.

”¿Es seguro dejar que una IA gestione mi cuenta?”

El servidor tiene tres niveles de permisos. Las lecturas están siempre disponibles; las escrituras seguras (borradores, metadatos, webhooks) están activadas por defecto y pueden desactivarse; y las acciones de mayor alcance (envío a distribución, retiros, subidas de archivos inmutables) están desactivadas por defecto y requieren habilitar las escrituras completas más una confirmación explícita. Todas las protecciones de la cuenta — validación, límites del plan, límites de peticiones — las aplican los servidores de LabelGrid y la IA no puede eludirlas.

”¿Necesito un plan de API?”

Sí. El servidor MCP se conecta a través de la API pública de LabelGrid, por lo que su cuenta necesita acceso a la API, que forma parte de los planes de API de LabelGrid. Vea la visión general de la API para saber cómo obtener acceso.

”¿Qué aplicaciones de IA son compatibles?”

Cualquier cliente compatible con MCP, incluidos Claude Desktop, Claude Code y Cursor.

---

Relacionado

• Visión general de la API — cómo obtener acceso a la API y autenticarse
• Webhooks — notificaciones asíncronas de eventos
• @labelgrid/mcp en npm
• labelgrid-mcp en GitHub

---

¿Necesita ayuda?

Si tiene preguntas sobre el servidor MCP, contacte con nuestro equipo de soporte.