Claude oder Cursor mit Cinevva verbinden (MCP-Server)

Cinevva bietet einen gehosteten MCP-Server, mit dem Claude, Claude Code, Cursor oder jeder andere MCP-Client deine Spiele erstellen kann. Die KI, die du bereits nutzt, wird dabei zum Gehirn: Sie liest und bearbeitet die Dateien deiner Spiele direkt auf unseren Servern, ganz ohne geöffneten Browser-Tab. Öffne dein Spiel zusätzlich im Cinevva-Editor, um die Sitzung live zu schalten. Die KI kann dann Assets aus unserer CC0-Bibliothek importieren, 3D-Modelle riggen und animieren, Screenshots aufnehmen, Eingaben zum Testen des laufenden Spiels simulieren und die Vorschau aktualisieren, während jede Änderung direkt auf deinen Bildschirm übertragen wird.

Was du brauchst

Du benötigst ein Cinevva-Konto (die kostenlose Version genügt; 3D-Rigging verbraucht Guthaben aus deinem Kontostand) und einen MCP-Client, der Remote-Server mit OAuth unterstützt. Die Server-URL lautet:

https://api.cinevva.com/create/mcp

Der Server verwendet Streamable HTTP und authentifiziert sich mit OAuth 2.0. Wenn du eine Verbindung herstellst, öffnet dein Client im Browser eine Cinevva-Anmeldeseite. Bestätige den Zugriff einmal, danach bleibt der Client verbunden.

Überall bearbeiten. Live zuschauen und testen.

Zum Bearbeiten von Dateien ist lediglich die Verbindung erforderlich. Die Dateiwerkzeuge lesen und schreiben die maßgebliche Version deiner Spiele auf unseren Servern. So kann dein Assistent einen Fehler beheben oder eine Funktion hinzufügen, selbst wenn nirgendwo ein Cinevva-Tab geöffnet ist. Nenne einfach das gewünschte Spiel (oder lass die KI eines deiner Spiele auswählen) und gib deine Anweisung ein.

Die Live-Schaltung ist eine Erweiterung, keine Voraussetzung. Öffne das Spiel unter cinevva.com/create, warte, bis die Vorschau geladen ist, und klicke dann in der Werkzeugleiste des Editors auf Externer Agent (das Steckersymbol, auf kleinen Bildschirmen auch im Menü „Mehr“). Sobald die Verbindung hergestellt ist, zeigt das Panel „Agent live“ an. Eine Live-Sitzung gibt der KI Augen und Hände im laufenden Spiel: Screenshots, Konsolenprotokolle, simulierte Eingaben, Asset-Import und 3D-Rigging. Außerdem wird jede Änderung in dem Moment auf deinen Bildschirm übertragen, in dem sie eintrifft – unabhängig davon, ob sie über diesen Tab oder ohne Benutzeroberfläche vorgenommen wurde. Die Live-Verbindung bleibt bei zukünftigen Besuchen aktiv, bis du auf „Live-Sitzung beenden“ klickst.

Das Werkzeug list_live_sessions zeigt an, welche Verbindungen bestehen. Wenn genau ein Spiel geöffnet ist, wird es automatisch ausgewählt.

Einrichtung in Claude (claude.ai und Desktop-App)

1. Öffne die Einstellungen, dann „Konnektoren“, und wähle „Benutzerdefinierten Konnektor hinzufügen“.
2. Gib ihm den Namen Cinevva und füge https://api.cinevva.com/create/mcp als URL ein. Achte auf versehentlich eingefügte Zeichen; die URL muss mit /create/mcp enden.
3. Klicke auf „Hinzufügen“ und dann auf „Verbinden“. Melde dich mit deinem Cinevva-Konto an, sobald die Autorisierungsseite geöffnet wird (mit demselben Konto, mit dem du im Spiel-Tab angemeldet bist).
4. Bitte Claude beispielsweise: „Liste die Dateien meiner Cinevva-Spiele auf“, um die Verbindung zu bestätigen. Öffne für Live-Tests dein Spiel in einem anderen Tab unter cinevva.com/create und klicke in der Werkzeugleiste auf „Externer Agent“.

Einrichtung in Claude Code

claude mcp add --transport http cinevva https://api.cinevva.com/create/mcp

Claude Code führt dich bei der ersten Verwendung durch die OAuth-Anmeldung. Danach kannst du es auffordern, deine Spieldateien zu lesen oder eine Änderung vorzunehmen. Es funktioniert direkt im Terminal, ohne dass ein Browser-Tab geöffnet sein muss.

Einrichtung in Cursor

Füge Folgendes zu .cursor/mcp.json (pro Projekt) oder ~/.cursor/mcp.json (global) hinzu:

{
  "mcpServers": {
    "cinevva": {
      "url": "https://api.cinevva.com/create/mcp"
    }
  }
}

Cursor erkennt den Server, führt den OAuth-Ablauf in deinem Browser aus und listet die Werkzeuge in seinen MCP-Einstellungen auf.

Funktionen der Werkzeuge

Gruppe	Werkzeuge	Live-Sitzung erforderlich?
Spiel lesen	list_game_files, read_files, search_game_file	Nein, liest die Serverversion eines beliebigen deiner Spiele
Spiel bearbeiten	edit_files, write_files, delete_files, rename_files	Nein, Änderungen werden serverseitig gespeichert und an einen geöffneten Tab übertragen
Vorschau	game_ready	Aktualisiert die Vorschau eines Live-Tabs; andernfalls wird ohne Benutzeroberfläche gespeichert
Spiel beobachten	read_console_logs, take_screenshot	Ja
Tests	execute_js, simulate_input, get_task_status	Ja
Assets	search_assets, list_asset_packs, import_asset, search_fonts	Ja. Rund 7.000 CC0-Requisiten, Audiodateien und HDRIs
3D-Rigging	rig_model, apply_animation	Ja, verbraucht Guthaben
Dokumentation	list_library_docs, search_library_docs, read_library_docs, list_animations	Ja

Das Rigging kostet genauso viel Guthaben wie im integrierten Spiele-Editor. Alles andere ist kostenlos. Der integrierte Editor kann außerdem mit KI Bilder, Musik, Soundeffekte und Skyboxen erzeugen. Diese Werkzeuge sind direkt in der Cinevva-App verfügbar und nicht Teil des MCP-Konnektors.

Fehlerbehebung

Die Meldung „Unter der angegebenen URL wurde kein MCP-Server gefunden“ während der Einrichtung bedeutet normalerweise, dass die URL einen Tippfehler oder ein zusätzliches Zeichen am Ende enthält. Sie muss exakt https://api.cinevva.com/create/mcp lauten.

Die Meldung „Keine Live-Sitzung“ stammt ausschließlich von den Laufzeitwerkzeugen (Screenshots, Konsole, Eingaben, Assets und Rigging). Sie bedeutet, dass kein Browser-Tab dieses Spiel mit aktivierter Live-Verbindung geöffnet hat. Öffne dein Spiel, klicke in der Werkzeugleiste auf „Externer Agent“ und versuche es erneut. Die Dateiwerkzeuge benötigen dies nie: Ohne Sitzung bearbeiten sie über die gameId jedes deiner Spiele und listen deine Spiele auf, wenn du keine angibst.

Wenn die Werkzeuge bei einer neuen Verbindung nicht reagieren, aktualisiere den Spiel-Tab, damit die Verbindung neu hergestellt wird, und rufe anschließend list_live_sessions auf.

Fragen oder Probleme: [email protected].