Integración con Servidor MCP

El servidor MCP (Model Context Protocol) de Screenzzie permite que asistentes de IA como Claude gestionen tu señalización digital a través de conversaciones en lenguaje natural.

¿Qué es MCP?

Model Context Protocol es un estándar abierto que permite a los asistentes de IA interactuar con herramientas y fuentes de datos externas. Con el servidor MCP de Screenzzie, puedes:

Pedir a Claude que liste tus pantallas y su estado
Crear y gestionar listas de reproducción a través de conversación
Consultar tu biblioteca de medios
Configurar horarios (plan Growth)

Instalación

Instala el servidor MCP globalmente:

npm install -g @screenzzie/mcp-server

O ejecuta directamente con npx:

npx @screenzzie/mcp-server --api-key TU_CLAVE_API

El paquete del servidor MCP está actualmente en desarrollo. Contáctanos para acceso anticipado.

Configuración de Claude Desktop

Agrega el servidor MCP de Screenzzie a tu configuración de Claude Desktop:

macOS

Edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "screenzzie": {
      "command": "npx",
      "args": ["@screenzzie/mcp-server", "--api-key", "sk_live_tu_clave_aqui"]
    }
  }
}

Windows

Edita %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "screenzzie": {
      "command": "npx",
      "args": ["@screenzzie/mcp-server", "--api-key", "sk_live_tu_clave_aqui"]
    }
  }
}

Usando Variables de Entorno

Para mayor seguridad, usa variables de entorno:

{
  "mcpServers": {
    "screenzzie": {
      "command": "npx",
      "args": ["@screenzzie/mcp-server"],
      "env": {
        "SCREENZZIE_API_KEY": "sk_live_tu_clave_aqui"
      }
    }
  }
}

Herramientas Disponibles

Una vez configurado, Claude puede usar estas herramientas:

Herramientas de Organización

Herramienta	Descripción
`get_organization_info`	Obtener información sobre tu clave API, organización, límites de tasa y funciones disponibles
`list_organizations`	Listar organizaciones accesibles con tu clave API

Herramientas de Pantallas

Herramienta	Descripción
`list_screens`	Listar todas las pantallas con filtros opcionales
`get_screen`	Obtener detalles de una pantalla específica
`create_screen`	Crear una nueva pantalla
`update_screen`	Actualizar una pantalla existente

Herramientas de Listas

Herramienta	Descripción
`list_playlists`	Listar todas las listas de reproducción
`get_playlist`	Obtener detalles de lista con items
`create_playlist`	Crear una nueva lista
`update_playlist`	Actualizar una lista
`delete_playlist`	Eliminar una lista

Herramientas de Medios

Herramienta	Descripción
`list_media`	Listar archivos de medios
`get_media`	Obtener detalles de archivo de medio
`delete_media`	Eliminar un archivo de medio

Herramientas de Horarios (Plan Growth)

Herramienta	Descripción
`list_schedules`	Listar todos los horarios
`get_schedule`	Obtener detalles de horario
`create_schedule`	Crear un nuevo horario
`update_schedule`	Actualizar un horario
`delete_schedule`	Eliminar un horario

Recursos

El servidor MCP también proporciona recursos para acceso rápido:

screenzzie://organization - Contexto actual de la organización y uso de API
screenzzie://screens - Vista general de todas las pantallas
screenzzie://playlists - Vista general de todas las listas
screenzzie://media - Vista general de la biblioteca de medios

Ejemplos de Conversaciones

Aquí hay algunas cosas que puedes preguntar a Claude:

Organización y Cuenta

"¿Cuál es mi uso actual de API?"

"Muéstrame los detalles de mi organización"

"¿Cuántas pantallas puedo tener con mi plan actual?"

"¿Qué funciones están disponibles en mi plan?"

Gestionando Pantallas

"Muéstrame todas mis pantallas"

"¿Cuáles pantallas están actualmente desconectadas?"

"Crea una nueva pantalla llamada 'Pantalla de Recepción' con orientación horizontal"

"Asigna la lista 'Bienvenida' a todas las pantallas del lobby"

Trabajando con Listas

"Lista todas mis listas de reproducción"

"Crea una nueva lista llamada 'Promociones Navideñas'"

"¿Qué items hay en la lista 'Contenido Principal'?"

"Elimina la lista 'Campaña Antigua'"

Biblioteca de Medios

"Muéstrame todos los videos en mi biblioteca de medios"

"¿Cuántas imágenes tengo?"

"Obtener detalles del medio ID abc123"

Horarios (Growth)

"Mostrar todos los horarios activos"

"Crear un horario de fin de semana para la lista promocional de 9 AM a 9 PM"

"Desactivar el horario 'Noticias Matutinas'"

Solución de Problemas

Errores de "herramienta desconocida"

Asegúrate de que estás ejecutando la última versión:

npm update -g @screenzzie/mcp-server

Errores de autenticación

Verifica tu clave API:

¿Es correcta la clave? (comienza con sk_live_)
¿Está todavía activa la clave? (no revocada)
¿Tiene la clave los permisos requeridos?

Errores de límite de tasa

Si ves errores de límite de tasa, tu clave API puede haber excedido el límite diario. Verifica tu uso en Configuración > Claves API.

Variables de Entorno

Variable	Descripción
`SCREENZZIE_API_KEY`	Tu clave API de Screenzzie (requerida)
`SCREENZZIE_BASE_URL`	URL de API personalizada (opcional)

Siguientes Pasos

Crea una Clave API con los permisos apropiados
Revisa la documentación de Endpoints de la API
Explora la Descripción General de la API REST

Servidor MCP

Acceso a la API REST