freispace MCP Server

freispace MCP Server

Ein Model Context Protocol (MCP)-Server, der Analysen und Einblicke für die Planungssoftware freispace bereitstellt. Dieser Server ermöglicht KI-Assistenten (z. B. Copilot, Gemini), Daten in freispace abzufragen, wie etwa Projektstatistiken und planungsbezogene Informationen.

Überblick

Der freispace MCP Server verbindet jedes LLM mit Tooling-Fähigkeiten mit freispace, um analytische Daten abzufragen.

Medienteams, die freispace nutzen, können den MCP-Server einsetzen, um Planungsdaten mithilfe der unternehmensweiten KI (z. B. Copilot) für das gesamte Unternehmen verfügbar zu machen, ohne dass die Nutzer in freispace angemeldet sein oder überhaupt von freispace wissen müssen. Zudem hilft er Postproduktionsteams, bei der Planung und Disposition datengestützte Entscheidungen zu treffen.

Unser MCP-Server respektiert stets die Benutzerberechtigungen und stellt sicher, dass das LLM nur auf Daten auf Benutzerebene zugreifen kann, wodurch die Datensicherheit gewährleistet wird.

Beispielabfragen könnten sein: „Wer hat in der Vergangenheit mit Person X zusammengearbeitet?“ oder „Wie viele Urlaubstage habe ich noch?“

Voraussetzungen

1. freispace Flagship-Konto
2. Gültiger MCP-API-Schlüssel für freispace
   • Während beta wenden Sie sich an Ihr freispace-Supportteam, um einen MCP-API-Schlüssel zu erhalten

Verfügbare Werkzeuge

Alle Suchvorgänge basieren auf Namen. Teilweise Übereinstimmungen werden gefunden; die erste Übereinstimmung wird verwendet.

get_current_user

Wer der aufrufende Benutzer ist: Name, E-Mail und verknüpfter Personaldatensatz. Keine Argumente. Verwenden Sie es, um „ich“/„mich“/„mein“ einem Mitarbeiternamen zuzuordnen.

„Als wer bin ich angemeldet?“

get_staffs

Listet Mitarbeiter mit Name, Titel und Personalnummer auf.

• status (optional): active (Standard), inactive, all

„Alle Mitarbeiter auflisten“ · „Wer sind die Entwickler im Unternehmen?“

find_resources

Durchsucht Räume/Studios (Suiten), Ausrüstung/Lizenzen (Ressourcen) und Mitarbeiter nach Namen in einem Aufruf, gruppiert nach Typ.

• search (optional): Name oder Teilname; weglassen, um alles aufzulisten
• staff (optional): internal oder external
• site (optional): nur Suiten an übereinstimmenden Standorten
• status (optional): active (Standard), inactive, all

„Finde Sammy“ · „Externe Freelancer auflisten“

get_availability

Prüft, wann Mitarbeiter, Suiten oder Ressourcen in einem Datumsfenster frei sind (Standard 14 Tage, max. 92), unter Berücksichtigung von Buchungen, Feiertagen und Abwesenheiten/Arbeitszeiten der Mitarbeiter.

• type (erforderlich): staff, resource, suite oder site
• search, staff, site, status (optional): Entitätsauswahl wie in find_resources
• from, to, days, weeks (optional): das Datumsfenster
• duration + duration_unit (optional): erforderliche freie Dauer (minutes, hours oder days)

„Ist nächsten Dienstag ein Studio für 3 Stunden frei?“ · „Wer hat in den nächsten zwei Wochen 2 komplett freie Tage?“

get_my_schedule

Die eigenen Buchungen des aufrufenden Benutzers in einem Datumsfenster (Standard: nächste 7 Tage).

• from, to, days, weeks (optional): das Datumsfenster

„Was steht diese Woche in meinem Zeitplan?“

get_my_tasks

Aufgaben, die dem aufrufenden Benutzer zugewiesen sind, mit Fälligkeitsdatum, Priorität und Referenz.

• include_done (optional): auch abgeschlossene Aufgaben einschließen

„Was sind meine offenen Aufgaben?“

get_open_tasks

Alle offenen Aufgaben des Teams, mit Zuständigen.

• reference (optional): project, booking oder user

„Welche Projektaufgaben sind noch offen?“

get_staff_projects

Listet die Projekte auf, für die ein Mitarbeiter gebucht ist, mit Datumsbereich und Dauer.

• staff_name (erforderlich)

„Für welche Projekte ist Karl gebucht?“

get_staff_collaborators

Zeigt, mit wem ein Mitarbeiter zusammengearbeitet hat, basierend auf gemeinsamen Buchungen.

• staff_name (erforderlich)

„Mit wem hat Alexander zusammengearbeitet?“

get_staff_next_holiday

Ruft den nächsten anstehenden Urlaub eines Mitarbeiters ab (Beginn, Ende, Dauer, Kommentar).

• staff_name (optional; für den aufrufenden Benutzer weglassen)

„Wann ist mein nächster Urlaub?“ · „Wann hat Hendrikje Urlaub?“

get_staff_holiday_quota

Ruft das Urlaubskontingent eines Mitarbeiters für ein Jahr ab: Gesamttage, genommene und verbleibende Tage.

• staff_name (optional; für den aufrufenden Benutzer weglassen)
• year (optional; Standard ist das aktuelle Jahr)

„Wie viele Urlaubstage habe ich noch?“

get_project_stats

Buchungsstatistiken für ein Projekt: vergangene vs. anstehende Buchungen mit Aufschlüsselung nach Status, zuzüglich der Projektlaufzeit (erster Buchungsbeginn, letztes Buchungsende und die Dauer in Tagen dazwischen).

• project_name (erforderlich)

„Buchungsstatistiken für Projekt Alpha anzeigen“ · „Wie lange läuft Projekt Alpha?“

get_project_team

Listet die Mitarbeiter auf, die an einem Projekt gearbeitet haben, mit ihrer Anzahl an Buchungen darauf.

• project_name (erforderlich)

„Wer hat am Website-Relaunch gearbeitet?“

get_project_tasks

Aufgabenstatus eines Projekts: alle Aufgaben des Projekts und seiner Buchungen, mit einer Zusammenfassung offen/erledigt/überfällig.

• project_name (erforderlich)

„Gibt es offene Aufgaben beim Dokumentarfilmprojekt?“

get_invoices

Listet Rechnungen mit Filtern und Summen pro Währung auf; paginiert. Statusgruppen: draft, open, overdue, paid, partially-paid, canceled, locked.

• search (optional): gleicht Nummer, Bestellnummer, Betreff, Empfängeradresse ab
• status, number, date_min/date_max, due_date_min/due_date_max, sum_min/sum_max, outstanding_min/outstanding_max, sort, order, page, per_page (optional)

„Welche Rechnungen sind überfällig?“ · „Offene Rechnungen für Acme“

get_offers

Listet Angebote mit Filtern und Netto-Summen pro Währung auf; paginiert. Statusgruppen: draft, locked, open, accepted, declined.

• search, status, number, date_min/date_max, sum_min/sum_max, sort, order, page, per_page (optional)

„Abgelehnte Angebote aus diesem Jahr anzeigen“

get_orders

Listet Aufträge (Jobs) mit ihren verknüpften Angeboten und Rechnungen inline auf; paginiert.

• search (optional): gleicht Auftragsnummer und Name ab
• status, number, date_min/date_max, sort, order, page, per_page (optional)

„Was wurde bei Auftrag 2026-014 angeboten und abgerechnet?“

search_docs

Durchsucht die freispace-Dokumentation und gibt die relevantesten Auszüge zurück.

• query (erforderlich)
• limit (optional): max. Auszüge, Standard 5

„Wie richte ich die Schichtplanung in freispace ein?“

Fehlerbehandlung

Fehler werden als kurze, handlungsorientierte Meldungen an das aufrufende Modell zurückgegeben (z. B. Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.). Diagnosen werden nach stderr protokolliert; stdout enthält nur das MCP-Protokoll.

⚠️ Beta-Hinweis

Unser freispace MCP-Server befindet sich derzeit in der Beta-Phase. Alle Funktionen sind in diesem Zeitraum kostenlos. Wir freuen uns über Ihr Feedback und Ihre Geduld, während wir die Plattform weiter verbessern.

Lizenz

MIT-Lizenz – siehe LICENSE-Datei für Details.

Support

Für Support und Fragen:

• Dokumentation: freispace-Dokumentation
• Issues: GitHub Issues
• Kontakt: freispace Support