MCP / Skills einrichten

KI-Tools mit ScreenWay verbinden.

Das ScreenWay-AI-Toolkit stellt einen gehosteten Streamable-HTTP-MCP-Server bereit. KI-Clients nutzen denselben Konto-API-Key wie die REST-API und steuern dann Screens, Medien, Apps, Programme, Designer-Projekte und Analytics über Tools.

Gehostetes MCP

MCP-Clients mit https://mcp.screenway.com verbinden. Der MCP-Service leitet Aufrufe an https://studio.screenway.com/api/v1 weiter, mit dem Bearer-Token des Kunden.

Remote-Server

Gehosteter Endpoint: https://mcp.screenway.com.

API-Key

ScreenWay-Konto-API-Key, beginnt mit swk_.

Sicherer Hosted-Modus

Hosted-Tools greifen nicht auf kundenseitige Dateipfade zu.

Codex

Den Remote-MCP-Server in Codex eintragen und den API-Key in der Shell verfügbar machen, die Codex startet.

Die beiden Snippets gehören zusammen: bearer_token_env_var nennt die Env-Variable, die Codex lesen soll, und der Shell-Export legt denselben ScreenWay-swk_-Key dort ab, bevor Codex startet.

~/.codex/config.toml
[mcp_servers.screenway]
url = "https://mcp.screenway.com"
bearer_token_env_var = "SCREENWAY_API_KEY"
Shell vor Codex-Start
export SCREENWAY_API_KEY=swk_your_api_key_here

Claude Desktop, Claude Code, Cursor

Clients, die Remote-MCP-JSON-Config akzeptieren, können direkt auf den gehosteten Server zeigen und den Authorization-Header übergeben.

MCP-Config
{
  "mcpServers": {
    "screenway": {
      "url": "https://mcp.screenway.com",
      "headers": {
        "Authorization": "Bearer swk_your_api_key_here"
      }
    }
  }
}

Optionales Codex-Skill

Im Toolkit liegt screenway-designer, ein Workflow-Skill zum Anlegen, Bearbeiten, Rendern und visuellen Prüfen von Designer-Projekten via MCP. Installieren aus dem ScreenWay-AI-Toolkit-Repository.

Aus GitHub installieren
git clone https://github.com/Bergx2/bx2_screenway-ai-toolkit.git
cd bx2_screenway-ai-toolkit
mkdir -p ~/.codex/skills
cp -R skills/screenway-designer ~/.codex/skills/
Nutzung
Nutzen Sie $screenway-designer, um ein Designer-Projekt zu aktualisieren und ein PNG zur Prüfung zu rendern.

Screens

Screens listen, Details einsehen, Metadaten aktualisieren und Befehle senden: Neustart, Reload, Playback-Jump oder einzelne Content-Items pushen. Jeder Screen im Konto ist erreichbar, sobald die Targets des Keys ihn abdecken.

Offline-Screens prüfen
Liste alle meine Screens, gruppiere sie nach Space und markiere jeden Screen, der länger als 24 Stunden offline ist. Inklusive last_seen_at und player_version pro Eintrag.
Screen neu starten
Starte den Screen namens "Lobby Display" neu und bestätige, wenn der Befehl gesendet wurde.
Instant-Content-Push
Schiebe das Medium "Wegen Renovierung geschlossen" sofort auf den Screen "Café Bühne".

Medien

Ordner und Medien listen, Assets per URL oder Data-URL hochladen, Ordner spontan anlegen. Nützlich, wenn eine Automation ein frisches Asset in den Studio-Storage ziehen muss, bevor es ausgespielt wird.

Import per URL
Importiere das Bild unter https://example.com/spring-promo.png in den Space "Lobby". Lege es in einem Ordner namens "Spring Campaign" ab und benenne das Asset "Spring Promo".

Apps & Programme

Apps listen, konfigurierte App-Instanzen anlegen, Programme listen und Programme an Screens zuweisen. Mit dieser Familie rollen Sie schablonisierte Inhalte in einer einzigen Unterhaltung über viele Screens aus.

Programm-Assignment in Masse
Finde jeden Screen im Space "Berlin HQ", der aktuell online ist, und weise dem Programm "Morning Loop" zu. Berichte, welche Screens zugewiesen und welche übersprungen wurden.
App-Instanz anlegen
Lege eine Clock-App-Instanz namens "Reception Clock" im Space "Lobby" an, mit 24-Stunden-Format und transparentem Hintergrund.

Designer

Projekte anlegen, editierbares design_data aktualisieren, Screenshots rendern, Thumbnails auffrischen. Designer-Projekte sind die hebelstärkste Oberfläche: ein Prompt kann komponieren, rendern und ausrollen.

Anlegen + rendern
Lege ein neues Designer-Projekt 1920×1080 an mit einer mittig zentrierten weißen "Willkommen"-Headline auf schwarzem Hintergrund. Render es als PNG und setze das Ergebnis als Thumbnail.
Aktualisieren mit neuen Daten
Öffne das Designer-Projekt "Tagesgerichte" und aktualisiere den Menü-Text auf die heutigen Gerichte (eines pro Zeile, siehe Liste). Neu rendern und allen Screens im Space "Restaurant" zuweisen.

Notifications

Screen-Notifications mit Kategorie, Priorität, optionaler Aktion und explizitem Target-Scope senden. Die erlaubten Targets des API-Keys werden respektiert; alles darüber hinaus wird mit 403 abgelehnt.

Gezielte Warnung
Sende eine CRITICAL-Emergency-Notification an alle Screens in der Gruppe "Emergency". Titel: "Jetzt evakuieren". Text: "Hauptausgang benutzen. Personalanweisungen folgen." Dauer 300 Sekunden.

Analytics

Konto- und Pro-Screen-Analytics für einen Zeitraum abrufen. Der KI-Client kann das Ergebnis zu Reports aggregieren, Auffälligkeiten erkennen und in derselben Unterhaltung mit konkreten Aktionen nachziehen.

Wochenzusammenfassung
Ziehe die Analytics der letzten 7 Tage. Nenne mir die Top-3-meistgespielten Items pro Screen, die durchschnittliche Uptime pro Space und eine Liste aller Screens mit weniger als 90 % Uptime.

Hosted vs. Lokal

  • Hosted-MCP akzeptiert Inline-JSON und Data-URLs
  • Hosted-MCP lädt öffentliche Assets per URL oder Base64/Data-URL hoch
  • Lokaler stdio-Modus kann Dateisystem-Helfer für Entwicklung bereitstellen
  • Designer-Edits sollten design_data und exported_html zusammen aktualisieren
  • Designer-Projekte vor Übergabe rendern
  • KI-Client nach Config-Änderung neu starten