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 unas pocas herramientas consolidadas repartidas en ocho conjuntos: cuenta, referencia, catálogo, lanzamientos, análisis, finanzas, webhooks y distribución. Muchas herramientas eligen sobre qué actúan a partir de un argumento que usted indica; por ejemplo, una sola herramienta de búsqueda del catálogo abarca sellos, artistas, autores, editores, lanzamientos y pistas. Los datos de referencia, como géneros, idiomas y territorios, también se exponen como recursos MCP. Las subidas de archivos forman parte de los conjuntos de catálogo y distribución. Su cliente de IA enumera exactamente las herramientas que se le ofrecen, así que siempre puede ver la superficie actual desde el propio cliente.

---

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

Precaución

Ese comando deja el token en su línea de comandos, donde su shell lo registra en el historial y otros usuarios de la máquina pueden leerlo en la lista de procesos. Elimínelo del historial después, o añada el token a la configuración JSON de arriba.

---

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 flujo de configuración indica al asistente que le remita al archivo de configuración de su cliente y que nunca pida el token en el chat, así que guárdelo ahí y no pegue el token en la conversación aunque se lo pidan.

---

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.

---

Qué ve su cliente de IA

El servidor se ejecuta en su propia máquina y habla con la API de LabelGrid usando su token. No tiene ninguna conexión con LabelGrid más allá de las llamadas a la API que su IA le pide hacer, y LabelGrid no recibe sus conversaciones.

El flujo de datos va en sentido contrario, y conviene tratarlo con cuidado: todo lo que su IA lee a través del servidor — metadatos de lanzamientos, incidencias de revisión, analíticas, informes de regalías — se transmite al cliente de IA que usted haya configurado y, desde ahí, al modelo que ese cliente utilice. Es responsabilidad suya elegir un cliente al que confíe su catálogo y los datos de su cuenta, y declarar ese flujo allí donde sus propios acuerdos lo exijan.

Dos consecuencias prácticas:

• Si hay datos que nunca deben llegar a un proveedor de IA, use LABELGRID_TOOLSETS para retener esa área por completo en lugar de confiar en que la IA no pregunte. Una herramienta que no se ofrece no se puede llamar.
• Los datos financieros entran en el alcance. El conjunto finance lee informes y desgloses de regalías, así que déjelo fuera salvo que quiera eso en la conversación.

---

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. El conjunto webhooks está desactivado por defecto; añádalo a LABELGRID_TOOLSETS para activarlo.

---

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 — revoque el token desde su panel en cualquier momento. Eso detiene de inmediato todo lo que use ese token, incluido este servidor. Los demás tokens de su cuenta no se ven afectados, así que revoque uno a uno los que quiera retirar y elimine también el valor de su configuración MCP.

---

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.

Los permisos rigen lo que la IA puede hacer. Valore por separado lo que puede ver: todo lo que lee a través del servidor llega a su cliente de IA y al modelo que hay detrás. Vea Qué ve su cliente de IA.

”¿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
• Herramienta de línea de comandos de LabelGrid (CLI) — las mismas acciones desde su terminal o un script
• 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.