freispace MCP Server

offiziell

Fragen Sie freispace nach Ressourcenplanungs- und Projektplanungsdaten ab.

GitHub
1

Was kann man mit Freispace MCP machen?

  • Überprüfen Sie Ihren eigenen Zeitplan und Ihre Aufgaben — fragen Sie nach Ihren anstehenden Buchungen mit get_my_schedule oder offenen Aufgaben mit get_my_tasks.
  • Verfügbare Personen oder Räume finden — nutzen Sie get_availability, um zu sehen, wer oder was in einem bestimmten Zeitfenster frei ist.
  • Team und Statistiken eines Projekts abrufen — fragen Sie get_project_team nach Mitwirkenden oder get_project_stats nach Buchungsaufschlüsselungen ab.
  • Sehen, mit wem ein Kollege zusammengearbeitet hat — rufen Sie get_staff_collaborators auf, um gemeinsame Buchungshistorien anzuzeigen.
  • Urlaubskontingente und nächsten Urlaub prüfen — überprüfen Sie verbleibende Urlaubstage über get_staff_holiday_quota oder den nächsten anstehenden Urlaub mit get_staff_next_holiday.
  • Rechnungen, Angebote oder Bestellungen durchsuchen — filtern Sie Finanzunterlagen nach Status, Datum oder Betrag mit get_invoices, get_offers oder get_orders.

Dokumentation

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 innerhalb von 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 unternehmensweit über die firmenweite KI (z. B. Copilot) verfügbar zu machen, ohne dass Nutzer auf freispace sein oder überhaupt von freispace wissen müssen, und um Postproduktionsteams bei datengestützten Entscheidungen während der Disposition und Planung zu unterstützen.

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

Beispielabfragen könnten sein: „Wer hat in der Vergangenheit mit Person X gearbeitet?“ 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 Mitarbeiterdatensatz. 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 passenden 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.

  • project_name (erforderlich)

„Buchungsstatistiken für Projekt Alpha anzeigen“

get_project_team

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

  • project_name (erforderlich)

„Wer hat am Website-Redesign 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 zu Auftrag 2026-014 angeboten und abgerechnet?“

search_docs

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

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

„Wie richte ich die Schichtplanung in freispace ein?“

Fehlerbehandlung

Fehler werden dem aufrufenden Modell als kurze, handlungsorientierte Meldungen 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: