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
https://mcp.screenway.com.API-Key
swk_.Sicherer Hosted-Modus
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.
[mcp_servers.screenway]
url = "https://mcp.screenway.com"
bearer_token_env_var = "SCREENWAY_API_KEY"export SCREENWAY_API_KEY=swk_your_api_key_hereClaude Desktop, Claude Code, Cursor
Clients, die Remote-MCP-JSON-Config akzeptieren, können direkt auf den gehosteten Server zeigen und den Authorization-Header übergeben.
{
"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.
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/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.
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.Starte den Screen namens "Lobby Display" neu und bestätige, wenn der Befehl gesendet wurde.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.
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.
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.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.
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.Ö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.
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.
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