Sklera Digital Signage MCP Server
DaScheife/Sklera-Digital-Signage-MCP-Server
Integração MCP para gerenciar Digital Signage do Sklera via Claude
Ver no GitHubServidor MCP que integra a API de Digital Signage do Sklera com Claude, permitindo gerenciar conteúdo, dispositivos e exibições de sinalização digital. Suporta múltiplas instâncias (SaaS e on-premise) com autenticação via token.
Instalação
npx convez-ai DaScheife/Sklera-Digital-Signage-MCP-Server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de conteúdo em painéis e displays de sinalização digital
- Gerenciamento centralizado de múltiplas instâncias Sklera
- Agendamento e distribuição de conteúdo para redes de displays
- Integração de Digital Signage em fluxos de trabalho Claude
Veredito

MCP especializado e bem estruturado para ecossistema Sklera, com suporte robusto a múltiplas instâncias e modos de transporte (stdio e HTTP). Implementação técnica sólida, mas público-alvo restrito a usuários do Sklera.
README
A tradução para o português deste README ainda está na fila.
sklera-mcp-server
Version 0.4.0
MCP Server für die Sklera Digital Signage Data API v1.
Versionshistorie siehe CHANGELOG.md.
Voraussetzungen
- Node.js >= 18
- Sklera API-Token (Manager-Rolle oder höher)
Installation
npm install
npm run build
Konfiguration
Einzelne Instanz (Standard)
| Variable | Pflicht | Default | Beschreibung |
|---|---|---|---|
SKLERA_API_TOKEN | Ja | – | API-Token aus dem Backend |
SKLERA_BASE_URL | Nein | https://my.sklera.tv | Für On-Premise-Instanzen |
Mehrere Instanzen (mehrere Sklera-Domains)
Für den Betrieb mehrerer Sklera-Domains (z.B. SaaS plus mehrere On-Premise-Installationen, je mit eigenem Token) steht die Variable SKLERA_INSTANCES als JSON zur Verfügung. Ist sie gesetzt, hat sie Vorrang vor SKLERA_API_TOKEN / SKLERA_BASE_URL.
{
"default": "my",
"instances": {
"my": { "baseUrl": "https://my.sklera.tv", "apiToken": "TOKEN_A" },
"gehtsichaus": { "baseUrl": "https://sklera.gehtsichaus.net", "apiToken": "TOKEN_B" }
}
}
Tools mit Instanz-Unterstützung akzeptieren einen optionalen Parameter instance (Name aus instances). Ohne Angabe wird die unter default definierte Instanz verwendet; fehlt default, gilt die erste Instanz.
Transport
stdio (Standard, für Claude Desktop / claude.ai)
SKLERA_API_TOKEN=<token> node dist/index.js
HTTP (für Remote-Zugriff)
Der HTTP-Modus (Streamable HTTP Transport) unterstützt zwei Betriebsarten:
Multi-User (empfohlen für zentrales Hosting): Server ohne Credentials starten; jeder Request bringt seine eigenen Credentials via Header mit.
TRANSPORT=http PORT=3000 node dist/index.js
Unterstützte Auth-Header pro Request:
| Header | Pflicht | Beschreibung |
|---|---|---|
X-Sklera-Token | Ja* | API-Token des Users |
X-Sklera-Url | Nein | Basis-URL der Sklera-Instanz, Default https://my.sklera.tv |
X-Sklera-Instances | Nein | Multi-Instanz-JSON (Format wie SKLERA_INSTANCES); hat Vorrang vor X-Sklera-Token |
*Entweder X-Sklera-Token oder X-Sklera-Instances muss gesetzt sein, sofern keine Server-Credentials existieren. Requests ohne Credentials werden mit HTTP 401 abgelehnt.
Single-Tenant (Fallback): Server mit Credentials in der Umgebung starten; Requests ohne Auth-Header nutzen diese.
TRANSPORT=http PORT=3000 SKLERA_API_TOKEN=<token> node dist/index.js
Endpoint: POST http://localhost:3000/mcp
Health-Check: GET http://localhost:3000/health
Weitere Umgebungsvariablen: HOST (Bind-Interface, Default 0.0.0.0).
Sicherheitshinweise für den Remote-Betrieb:
- Ausschließlich hinter TLS betreiben (Reverse Proxy oder Cloudflare Tunnel); Tokens werden im Klartext-Header übertragen
- Tokens werden weder serverseitig gespeichert noch geloggt; pro Request wird eine isolierte Client-Instanz erzeugt
- Rate-Limiting auf Proxy-Ebene (z.B. Cloudflare) wird empfohlen
Einbindung in Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) bzw.
%APPDATA%\Claude\claude_desktop_config.json (Windows):
Variante A: Lokal (stdio)
{
"mcpServers": {
"sklera": {
"command": "node",
"args": ["/pfad/zu/sklera-mcp-server/dist/index.js"],
"env": {
"SKLERA_API_TOKEN": "<dein-token>",
"SKLERA_BASE_URL": "https://my.sklera.tv"
}
}
}
}
Variante B: Remote (HTTP)
Der Token bleibt in der lokalen Konfiguration des Users; nur die Server-URL zeigt auf den gehosteten MCP Server.
{
"mcpServers": {
"sklera": {
"type": "http",
"url": "https://mcp.example.net/mcp",
"headers": {
"X-Sklera-Token": "<dein-token>",
"X-Sklera-Url": "https://my.sklera.tv"
}
}
}
}
Für mehrere Sklera-Instanzen pro User alternativ:
{
"mcpServers": {
"sklera": {
"type": "http",
"url": "https://mcp.example.net/mcp",
"headers": {
"X-Sklera-Instances": "{\"default\":\"my\",\"instances\":{\"my\":{\"baseUrl\":\"https://my.sklera.tv\",\"apiToken\":\"TOKEN_A\"},\"onprem\":{\"baseUrl\":\"https://sklera.example.net\",\"apiToken\":\"TOKEN_B\"}}}"
}
}
}
}
Remote-Einbindung über OAuth (GUI-Konnektor)
Claudes grafische Konnektor-Verwaltung ("Benutzerdefinierter Konnektor") akzeptiert nur eine URL und spricht zur Authentifizierung ausschließlich die MCP-Authorization- Spezifikation (OAuth 2.1 + PKCE, Dynamic Client Registration). Statische Header wie in Variante B lassen sich dort nicht hinterlegen. Schlägt die automatische Registrierung fehl ("Registrierung beim Anmeldedienst fehlgeschlagen"), liegt es daran, dass der Server kein OAuth anbietet. Ab Version 0.4.0 bringt der HTTP-Transport einen eigenen, schlanken OAuth-2.1-Server mit.
Aktivierung
TRANSPORT=http PORT=3000 PUBLIC_URL=https://mcp.example.net node dist/index.js
| Variable | Pflicht | Beschreibung |
|---|---|---|
PUBLIC_URL | Ja (für OAuth) | Extern erreichbare https-Origin des Servers; wird zum OAuth-Issuer und zur Resource-Kennung. Muss exakt der URL entsprechen, unter der Claude den Server erreicht. |
OAUTH_STORE_FILE | Nein | Pfad zu einer JSON-Datei zur Persistenz von Clients und Tokens über Neustarts hinweg. Ohne Angabe rein im Arbeitsspeicher. Hinweis: das Sklera-Token wird dann unverschlüsselt gespeichert, Datei mit Dateirechten 600 schützen. |
PUBLIC_URL muss auf die öffentliche https-Adresse zeigen (Reverse Proxy bzw.
Cloudflare Tunnel), nicht auf localhost. Ohne TLS funktioniert der Flow in Claude nicht.
Ablauf
- Konnektor in Claude mit der
/mcp-URL anlegen (z.B.https://mcp.example.net/mcp). - Claude entdeckt über
/.well-known/oauth-protected-resourceden Authorization-Server, registriert sich per Dynamic Client Registration und startet den Authorize-Flow. - Es öffnet sich eine Login-Seite des MCP-Servers. Dort das Sklera API-Token und bei On-Premise die Instanz-URL eintragen.
- Das Token wird gegen
/data/api/channels/listgeprüft und an den ausgestellten Bearer-Token gebunden. Ab dann sendet Claude den Bearer-Token automatisch mit.
Die bisherigen Header-Varianten (X-Sklera-Token, X-Sklera-Instances) bleiben parallel
nutzbar, etwa für die Einbindung per Konfigurationsdatei (Variante B).
Sicherheit
- Ausschließlich hinter TLS betreiben; sowohl die Login-Seite als auch die Tokens werden sonst im Klartext übertragen.
- Pro Verbindung legt Claude bei Dynamic Client Registration einen neuen Client an;
bei vielen Neuverbindungen wächst der Client-Bestand.
OAUTH_STORE_FILEregelmäßig prüfen oder bei Bedarf zurücksetzen. - Wird der Server neu gestartet und ist
OAUTH_STORE_FILEnicht gesetzt, müssen alle Nutzer sich neu autorisieren.
Verfügbare Tools (27)
Channels
sklera_list_channels– Alle zugänglichen Channels auflisten
Users
sklera_list_users– Alle sichtbaren Benutzerkonten auflisten (inkl. Channel-Zuordnung, Adresse, lastLogin); optionaler Parameterinstancefür Mehrdomänen-Betrieb
Screens / Player
sklera_list_screens– Alle Screens auflistensklera_screen_stats– Online/Offline-Statistikensklera_screen_connection_status– Echtzeit-Verbindungsstatussklera_send_screen_command– Fernbefehl senden (restart, reload, next, prev, ...)sklera_edit_screen– Screen-Eigenschaften bearbeitensklera_list_screengroups– Screen-Gruppen eines Channels
Playlists
sklera_list_playlists– Alle Playlists auflistensklera_create_playlist– Neue Playlist erstellensklera_edit_playlist– Playlist bearbeitensklera_delete_playlist– Playlist löschensklera_clear_playlist– Alle Spots einer Playlist entfernensklera_prune_playlist– Abgelaufene Spots entfernen
Nodes (Spots)
sklera_list_nodes– Spots einer Playlist auflistensklera_add_node– Neuen Spot hinzufügen (mit Scheduling)sklera_edit_node– Spot bearbeitensklera_delete_node– Spot löschen
Library Items
sklera_list_items– Bibliotheks-Items (filterbar nach Typ, Ordner, Datum)sklera_get_item– Einzelnes Item abrufensklera_replace_item_by_url– Item-Inhalt durch URL ersetzensklera_delete_item– Item löschensklera_copy_item– Item kopieren
Playouts
sklera_list_playouts– Alle Playouts auflistensklera_get_playout– Playout-Details abrufensklera_edit_playout– Playout bearbeiten (Screens, Playlists, Aktivierung)sklera_delete_playout– Playout löschen
Messages
sklera_list_messages– Laufschriften/Nachrichten auflistensklera_create_message– Neue Nachricht erstellen
Custom Values
sklera_get_custom_values– Alle Custom Values abrufensklera_edit_custom_value– Custom Value bearbeiten
Reporting
sklera_reporting_played_live– Rohe Wiedergabe-Logs (max. 7 Tage)sklera_reporting_played_hourly– Stündlich aggregierte Wiedergabe-Logs (max. 14 Tage)sklera_reporting_played_daily– Täglich aggregierte Wiedergabe-Logs (max. 364 Tage)sklera_reporting_touch_live– Rohe Touch-Logs (max. 7 Tage)sklera_reporting_touch_daily– Täglich aggregierte Touch-Logs (max. 364 Tage)
Roommanager (ab 0.2.0)
Basispfad /channelApi/roomManager; Authentifizierung über den apiToken-Query-Parameter. Alle Tools unterstützen den optionalen Parameter instance.
sklera_list_rooms– Alle Räume des Channels abrufensklera_create_rooms– Einen oder mehrere Räume anlegensklera_update_rooms– Mehrere Räume gesammelt aktualisieren (je_iderforderlich)sklera_delete_rooms– Mehrere Räume per ID löschensklera_edit_room– Einzelnen Raum perroomIdbearbeitensklera_delete_room– Einzelnen Raum perroomIdlöschensklera_list_events– Termine abrufen (optionaldateBegin/dateEnd)sklera_create_event– Termin anlegen (title,begin,end,roomIderforderlich)sklera_update_event– Termin pereventIdaktualisierensklera_delete_event– Termin pereventIdlöschensklera_delete_events_before– Termine vor einem Datum entfernen