Hilfe & Dokumentation

Der Agent-Zugriff verbindet einen externen KI-Assistenten über einen sicheren Model-Context-Protocol-(MCP)-Server mit deinem Konto. Einmal verbunden, kann der Assistent deine Daten lesen, um Fragen zu beantworten, und — mit einem Schlüssel für Lesen & Schreiben — in deinem Auftrag Änderungen vornehmen. Er handelt immer als du und ist auf dein eigenes Konto beschränkt.

• Opt-in und standardmäßig aus. Nichts wird freigegeben, bevor du einen Schlüssel erzeugst.
• Zwei Zugriffsstufen: Nur lesen (der Agent kann nie etwas ändern) oder Lesen & schreiben (er kann auch anlegen, bearbeiten und archivieren).
• Nur auf dein Konto beschränkt. Jede Anfrage läuft unter derselben Zeilen-Sicherheit (RLS) wie die App — der Agent erreicht keine fremden Daten.
• Funktioniert mit jedem MCP-Client, der entfernte Server über Streamable HTTP unterstützt. Claude Desktop und Claude Code sind die gängigen.
• Änderungen des Agenten synchronisieren sich wie jede andere Bearbeitung auf deine Geräte und sind als von einem KI-Agenten vorgenommen markiert.

Der Agent-Zugriff ist eine Cloud-Funktion, daher müssen ein paar Dinge vorhanden sein, bevor er funktioniert.

• Ein Cine-Power-Planner-Konto, angemeldet.
• Ein aktives Abonnement — der Agent-Zugriff ist eine kostenpflichtige Funktion.
• Erteilte Cloud-Sync-Einwilligung — jede Änderung durch den Agenten braucht sie. Der Agent arbeitet auf derselben Cloud-Kopie, die deine Geräte synchronisieren — reine Lokal-Konten können ihn nicht nutzen.
• Eine einmalige Bestätigung des Datenzugriffs, die beim Erzeugen deines ersten Schlüssels festgehalten wird.

Schlüssel werden an einer Stelle erstellt und verwaltet, und jeder wird nur einmal angezeigt.

1. Öffne Einstellungen → Sicherheit & Datenschutz → Agent-Zugriff.
2. Wähle eine Zugriffsstufe: Nur lesen oder Lesen & schreiben.
3. Fülle optional Schlüsselname aus, damit du den Schlüssel später wiedererkennst (z. B. "Claude Desktop").
4. Wähle unter Läuft ab: 7 Tage, 30 Tage, 90 Tage (Standard), 1 Jahr oder Kein Ablauf.
5. Bestätige, dass du verstehst, worauf der Agent zugreifen kann.
6. Klick auf Schlüssel erzeugen.
7. Kopiere den Schlüssel sofort — er wird nur einmal angezeigt. Bewahre ihn in einem Passwort-Manager auf.

Die Verbindung ist bei jedem Client gleich: eine Server-Adresse plus dein Schlüssel als Bearer-Token.

• Server-Adresse (immer gleich): https://cine-power-planner.com/mcp
• Authentifizierung: sende deinen Schlüssel in einem 'Authorization: Bearer <dein-schlüssel>'-Header.
• Transport: entfernter MCP über Streamable HTTP.

1. Claude Desktop / claude.ai: Einstellungen → Connectors → Eigenen Connector hinzufügen → Server-Adresse von oben eintragen und den Schlüssel als Bearer-Token angeben (in den Authentifizierungs-Einstellungen des Connectors; die genaue Bezeichnung variiert je nach Version).
2. Claude Code (Terminal): führe aus — claude mcp add cine-power-planner https://cine-power-planner.com/mcp --transport http --header "Authorization: Bearer <dein-schlüssel>"
3. Jeder andere MCP-Client: richte ihn auf die Server-Adresse und setze den 'Authorization: Bearer'-Header. Alles, was entfernte MCP-Server über Streamable HTTP unterstützt, funktioniert.
4. Test: Bitte deinen Assistenten, den Kontostatus zu prüfen (das Tool get_account_status). Er sollte dein Konto als verbunden melden.

Mit jedem Schlüssel kann der Assistent Fragen zu deinen Daten beantworten. Ein paar Beispiele, die gut funktionieren:

• Projekte — "Welche Projekte laufen gerade?", "Wer ist Oberbeleuchter*in bei Nightfall?", "Welches Equipment steht auf der Studio-X-Liste?"
• Zeitplan — "Was wird im Juli gedreht?", "Überschneiden sich nächste Woche Projekte?" (ein Aufruf scannt deinen gesamten Kalender).
• Equipment & Verfügbarkeit — "Ist meine ALEXA 35 vom 10.–14. Juni frei oder auf einem Job?", "Was besitze ich von ARRI?"
• Gerätespezifikationen — "Wie viel Strom zieht eine Sony FX6?", "Wie ist die Naheinstellgrenze eines 32-mm-Master-Prime?" (durchsucht den eingebauten Katalog).
• Angebote & Banking — "Wie viel sind meine offenen Angebote wert?", "Welche Angebote sind im Juni rausgegangen?" — dazu deine Bankkonten und Umsätze.
• Untervermietungen und eingehende Mietanfragen für deine öffentliche Geräteliste. E-Mail und Telefon einer Person im Projekt kommen mit Crew, Besetzung und Motiven.
• Shotlist — "Was drehen wir in Szene 12?", "Wie viele Shots stehen bei Nightfall noch aus?", "Gib mir die Szenenübersicht für Tag 2." Szenen kommen mit Slugline, INT/EXT, Tageszeit und Seitenachteln zurück, jeweils mit ihren Shots (Einstellungsgröße, Kamerawinkel, Bewegung, Optik).
• Dispositionen — "Wann ist Freitag Drehbeginn?", "Wo ist an Tag 3 das Basecamp?" — abrufbar, ohne das ganze Projekt zu öffnen.
• Besetzung — „Wer spielt Anna?“, „Welche Rollen sind noch nicht besetzt?“, „Ist Lea in der Woche ab 8. September frei?“, „Welche Schuhgröße hat unsere Hauptrolle?“ Liest den Reiter Figuren: Rolle und Darsteller*in, Spielalter, Casting-Status, Kontaktdaten, gesperrte Termine und — auf Nachfrage — Konfektionsgrößen, Maße, Erscheinungsbild, deine eigenen Spalten und das Kontaktprotokoll.
• Motive — „Wo drehen wir?“, „Wie ist die Parksituation an der Villa?“, „Welches Motiv liegt am nächsten an einem Krankenhaus?“ Motive kommen so gruppiert zurück, wie die App sie gruppiert (ein Hauptmotiv mit seinen Sets), und jedes einzelne mit dem vollständigen Motivbogen: Zufahrt und Anlieferung, Parken, Abteilungsbasen, Strom, Gefahren, Genehmigungen, Kosten, Kontakte.
• Kamerapaket & Anforderungen — "Welches Kamerapaket steht bei Nightfall?", "Welche Optiken stehen in den Anforderungen?"

Mit einem Schlüssel für Lesen & Schreiben kann der Assistent auch Änderungen vornehmen. Prüfe jede vorgeschlagene Änderung in deinem Client, bevor du sie freigibst.

• Projekte, eigenes Equipment, Untervermietungen und Angebotsentwürfe anlegen, bearbeiten und archivieren. Ein Projekt, das der Assistent anlegt, startet in den Einheiten aus Einstellungen › Allgemein › Einheiten, genau wie ein Projekt aus der App; hast du nie gewählt, startet es metrisch.
• Gezielte Projekt-Änderungen: einen einzelnen Equipment-Posten oder ein einzelnes Crew-Mitglied hinzufügen / bearbeiten / entfernen, Vorbereitungs- / Dreh- / Rückgabe-Termine setzen oder Projektanforderungen aktualisieren — ohne den Rest des Projekts anzufassen.
• Dispositionen aus vorhandenen Informationen in ein Projekt einsetzen (siehe nächster Abschnitt).
• Die Besetzung aufbauen — „Setz Anna auf Nightfall, gespielt von Lea Roth, Angebot ist raus“, „Setz Marlow auf gebucht“, „Lea kann vom 1.–3. September nicht.“ Gesperrte Termine werden als Nichtverfügbarkeit gespeichert — genau das lesen die Drehtagesliste (DOOD) und die Verfügbarkeitsampeln. Die eigenen Besetzungs-Spalten deines Projekts sprichst du über ihren Spaltennamen an. Besetzungsfotos lassen sich setzen, wenn der Assistent sie als Bild-Link oder als WebP-Bild mit höchstens 400 KB liefert (bis zu 10 pro Person); ein neuer Satz ersetzt die bisherige Galerie.
• Die Motivliste aufbauen — „Leg die Villa Rossi an, bestätigt, Via Roma 1“, „Leg Küche und Innenhof als Sets darunter an.“ Ein Set erbt Adresse, Kontakte, Parken und Krankenhaus vom Hauptmotiv, wo sein eigener Wert leer ist — du füllst also nur die Unterschiede aus. Beim Löschen eines Hauptmotivs wird vorher gefragt, ob seine Sets eigenständig bestehen bleiben oder mitgehen.
• Einen Stundenzettel (Gage + Arbeitszeit- und Zuschlagsregeln) anlegen und mit einem Projekt verknüpfen — du oder die Crew tragen dann die täglichen Stunden im Reiter Zeiterfassung dagegen ein.
• Ein Dokument ohne eigenen KI-API-Schlüssel in die App einlesen — hänge im Chat einen Beleg, eine von dir gestellte Rechnung, eine Disposition oder ein Verleih-Angebot an. Der Assistent liest die Datei selbst und legt einen Entwurf zur Prüfung in Buchhaltung → Ausgaben, Buchhaltung → Rechnungen, im Reiter Dispositionen des Projekts oder im Angebotsvergleich des Projekts ab. Gespeichert wird erst, wenn du ihn dort annimmst; offene Importe sind auf 200 begrenzt und verfallen nach 7 Tagen.
• Eine ausstehende Kollaborations-Einladung annehmen.
• Deinen öffentlichen Mietkatalog-Link verwalten und eine eingehende Mietanfrage mit einem Angebot beantworten. Ein Angebot zu senden schickt der anfragenden Person eine E-Mail — der Assistent bestätigt Empfänger, Positionen und Preise vorher mit dir.
• Ein Projekt besetzen — "Setz Anna Weber als Oberbeleuchter*in mit 650 €/Tag auf Nightfall", "Nimm Tom von der Crew-Liste." Wer entfernt wird, ist nur aus diesem Projekt ausgetragen; der Kontakt bleibt in deinem Adressbuch.

Ein häufiger Ablauf: Drehinformationen, die du bereits hast — eine E-Mail, ein Briefing, ein Zeitplan — in eine Disposition verwandeln. Frag natürlich, und der Assistent legt das Projekt an (falls nötig) und setzt eine Dispo mit allem ein, was du angibst.

Der Agent-Zugriff ist so gebaut, dass du bestimmst, worauf ein Assistent zugreifen kann — und ihn jederzeit sofort abschalten kannst.

• Dein Schlüssel ist ein Zugangsmittel — wer ihn hat, erreicht dein Konto in der Zugriffsstufe dieses Schlüssels. Bewahre ihn wie ein Passwort auf; teile ihn nie und lege ihn nie in ein Repository.
• Schlüssel sind nur auf dein Konto beschränkt. Der Server führt jede Anfrage als du aus, unter derselben Zeilen-Sicherheit (RLS) wie die App.
• Der Server hält keinen dauerhaften Zugriff auf dein Konto — er erzeugt pro Anfrage ein kurzlebiges Token und speichert deine Projektinhalte nie.
• Ein reines Metadaten-Protokoll hält fest, welches Tool wann lief (nie deine Daten). Es wird nach 180 Tagen automatisch gelöscht; das Agent-Zugriff-Panel zeigt, wann jeder Schlüssel zuletzt genutzt wurde.
• Datensätze, die die App auf deinen Geräten verschlüsselt (Kontakte, Rechnungen, Ausgaben und mehr), erreichen den Assistenten nie — der Agent-Zugriff-Server sieht nur verschlüsselte Daten und hat keinen Schlüssel dafür.
• Widerrufe jeden Schlüssel jederzeit unter Einstellungen → Sicherheit & Datenschutz → Agent-Zugriff. Beim Löschen deines Kontos werden alle Schlüssel und das Protokoll entfernt.

Dem Assistenten ist mitgeteilt, worauf er keinen Zugriff hat — er sagt das dann, statt zu raten oder eine Antwort zu erfinden. Nutze dafür die App.

• Kontakte, Rechnungen und Ausgaben — die App verschlüsselt sie auf deinen Geräten, bevor sie synchronisiert werden, und der Agent-Zugriff-Server hat keinen Schlüssel. Der Assistent kann sie daher weder lesen noch ändern und sagt das (ENCRYPTED), statt zu raten. Wie die Verschlüsselung funktioniert und wo ihre Grenzen liegen: Datenschutz & Daten → Verschlüsselung im Ruhezustand. E-Mail und Telefon einer Person im Projekt bleiben über Crew, Besetzung und Motive verfügbar.
• PDF-Export und -Erzeugung — Dispositionen, Briefings und Berichte entstehen in der App.
• Grundrisse, Moodboards sowie Datei- oder Foto-Uploads — Selftapes, Motivfotos und Skizzen (ein Link auf ein Selftape lässt sich speichern, die Datei nicht). Besetzungsfotos sind die einzige Ausnahme: Sie lassen sich setzen, aber nie zurücklesen.
• Projektdokumente, Gear-Sets und Schadensberichte.
• Erfasste Stunden aus Stundenzetteln auslesen — er kann einen Stundenzettel anlegen, die Stunden liegen aber im Reiter Zeiterfassung.
• Szenen und Shots bearbeiten — die Shotlist ist lesbar, aber noch nicht beschreibbar.
• Buchhaltungs- und Angebotsdaten sowie Beleg- und Rechnungsimporte bei Konten mit Mehrfirmen-Buchhaltung (Projekte, Equipment, Untervermietungen, Shotlists sowie Dispositions- und Verleih-Angebots-Importe funktionieren weiterhin).

Die häufigsten Meldungen, die dein Assistent zeigen könnte, und was sie bedeuten:

• "Invalid, expired, or revoked key" — der Schlüssel ist falsch oder wurde widerrufen. Erzeuge einen neuen und verbinde deinen Client neu.
• "Subscription required" — der Agent-Zugriff braucht ein aktives Abonnement auf deinem Konto.
• "Consent required (mcp_access)" — erteile die einmalige Datenzugriffs-Bestätigung im Agent-Zugriff-Panel und versuche es erneut.
• Der Assistent sieht eine kürzliche Änderung nicht — er liest deine Cloud-Kopie. Stelle sicher, dass Cloud Sync an ist und auf dem Gerät, auf dem du die Änderung gemacht hast, fertig synchronisiert wurde.
• Buchhaltungs- oder Angebotsfragen werden abgelehnt — diese Tools sind bei Konten mit Mehrfirmen-Buchhaltung in dieser Version nicht verfügbar.
• "ENCRYPTED" — du hast nach Kontakten, Rechnungen oder Ausgaben gefragt. Sie sind auf deinen Geräten verschlüsselt, der Assistent kann sie nicht lesen; nutze dafür die App.