freispace MCP Server

Serveur MCP freispace

Un serveur Model Context Protocol (MCP) qui fournit des analyses et des informations pour le logiciel de planification freispace. Ce serveur permet aux assistants IA (par exemple Copilot, Gemini) d'interroger les données dans freispace, telles que les statistiques de projet et les informations liées à la planification.

Aperçu

Le serveur MCP freispace connecte tout LLM doté de capacités d'outillage à freispace pour interroger des données analytiques.

Les équipes média utilisant freispace peuvent tirer parti du serveur MCP pour mettre les données de planification à disposition de toute l'entreprise via l'IA à l'échelle de l'entreprise (par exemple Copilot), sans que les utilisateurs aient besoin d'être sur freispace ou même de connaître freispace, et aider les équipes de post-production à prendre des décisions basées sur les données lors de la planification.

Notre serveur MCP respecte toujours les autorisations des utilisateurs, garantissant que le LLM ne pourra accéder aux données qu'au niveau de chaque utilisateur, assurant ainsi la sécurité des données.

Des exemples de requêtes pourraient être « Avec qui la personne X a-t-elle travaillé par le passé ? » ou « Combien de jours de vacances me reste-t-il ? »

Prérequis

1. Compte freispace Flagship
2. Clé API MCP valide pour freispace
   • Pendant beta, contactez votre équipe d'assistance freispace pour obtenir une clé API MCP

Outils disponibles

Toutes les recherches sont basées sur le nom. Les noms partiels correspondent ; la première correspondance est utilisée.

get_current_user

Qui est l'utilisateur appelant : nom, e-mail et enregistrement de personnel lié. Aucun argument. Utilisez-le pour résoudre « je »/« moi »/« mon » en un nom de personnel.

« Sous quel nom suis-je connecté ? »

get_staffs

Lister les membres du personnel avec leur nom, titre et numéro de personnel.

• status (optionnel) : active (par défaut), inactive, all

« Lister tous les membres du personnel » · « Qui sont les développeurs dans l'entreprise ? »

find_resources

Rechercher des salles/studios (suites), des équipements/licences (ressources) et du personnel par nom en un seul appel, regroupés par type.

• search (optionnel) : nom ou nom partiel ; omettre pour tout lister
• staff (optionnel) : internal ou external
• site (optionnel) : uniquement les suites sur les sites correspondants
• status (optionnel) : active (par défaut), inactive, all

« Trouver Sammy » · « Lister les freelances externes »

get_availability

Vérifier quand le personnel, les suites ou les ressources sont libres dans une fenêtre de dates (par défaut 14 jours, max 92), en tenant compte des réservations, des jours fériés et des absences/temps de travail du personnel.

• type (requis) : staff, resource, suite ou site
• search, staff, site, status (optionnel) : sélection d'entité comme dans find_resources
• from, to, days, weeks (optionnel) : la fenêtre de dates
• duration + duration_unit (optionnel) : durée libre requise (minutes, hours ou days)

« Un studio est-il libre mardi prochain pendant 3 heures ? » · « Qui a 2 jours entièrement libres dans les deux prochaines semaines ? »

get_my_schedule

Les propres réservations de l'utilisateur appelant dans une fenêtre de dates (par défaut : 7 prochains jours).

• from, to, days, weeks (optionnel) : la fenêtre de dates

« Quel est mon planning cette semaine ? »

get_my_tasks

Tâches assignées à l'utilisateur appelant, avec date d'échéance, priorité et référence.

• include_done (optionnel) : inclure également les tâches terminées

« Quelles sont mes tâches ouvertes ? »

get_open_tasks

Toutes les tâches ouvertes de l'équipe, avec les assignés.

• reference (optionnel) : project, booking ou user

« Quelles tâches de projet sont encore ouvertes ? »

get_staff_projects

Lister les projets sur lesquels un membre du personnel est réservé, avec la plage de dates et la durée.

• staff_name (requis)

« Sur quels projets Karl est-il réservé ? »

get_staff_collaborators

Montrer avec qui un membre du personnel a travaillé, sur la base des réservations partagées.

• staff_name (requis)

« Avec qui Alexander a-t-il travaillé ? »

get_staff_next_holiday

Obtenir les prochaines vacances à venir d'un membre du personnel (début, fin, durée, commentaire).

• staff_name (optionnel ; omettre pour l'utilisateur appelant)

« Quand sont mes prochaines vacances ? » · « Quand Hendrikje est-elle en vacances ? »

get_staff_holiday_quota

Obtenir le quota de vacances d'un membre du personnel pour une année : jours totaux, pris et restants.

• staff_name (optionnel ; omettre pour l'utilisateur appelant)
• year (optionnel ; par défaut l'année en cours)

« Combien de jours de vacances me reste-t-il ? »

get_project_stats

Statistiques de réservation pour un projet : réservations passées vs à venir avec répartition par statut, plus la durée du projet (début de la première réservation, fin de la dernière réservation et la durée en jours entre les deux).

• project_name (requis)

« Afficher les statistiques de réservation pour le projet Alpha » · « Combien de temps dure le projet Alpha ? »

get_project_team

Lister les membres du personnel qui ont travaillé sur un projet, avec leur nombre de réservations sur celui-ci.

• project_name (requis)

« Qui a travaillé sur la refonte du site web ? »

get_project_tasks

Statut des tâches d'un projet : toutes les tâches du projet et de ses réservations, avec un résumé ouvert/terminé/en retard.

• project_name (requis)

« Y a-t-il des tâches ouvertes sur le projet documentaire ? »

get_invoices

Lister les factures avec des filtres et des totaux par devise ; paginé. Groupes de statut : draft, open, overdue, paid, partially-paid, canceled, locked.

• search (optionnel) : correspond au numéro, numéro de commande, objet, adresse du destinataire
• 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 (optionnel)

« Quelles factures sont en retard ? » · « Factures ouvertes pour Acme »

get_offers

Lister les offres (devis) avec des filtres et des totaux nets par devise ; paginé. Groupes de statut : draft, locked, open, accepted, declined.

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

« Afficher les offres refusées de cette année »

get_orders

Lister les commandes (travaux) avec leurs offres et factures connectées en ligne ; paginé.

• search (optionnel) : correspond au numéro de commande et au nom
• status, number, date_min/date_max, sort, order, page, per_page (optionnel)

« Qu'est-ce qui a été devisé et facturé sur la commande 2026-014 ? »

search_docs

Rechercher dans la documentation freispace et retourner les extraits les plus pertinents.

• query (requis)
• limit (optionnel) : max extraits, par défaut 5

« Comment configurer la planification des équipes dans freispace ? »

Gestion des erreurs

Les erreurs sont retournées au modèle appelant sous forme de messages courts et exploitables (par exemple Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.). Les diagnostics sont journalisés sur stderr ; stdout ne transporte que le protocole MCP.

⚠️ Avis bêta

Notre serveur MCP freispace est actuellement en version bêta. Toutes les fonctionnalités sont gratuites pendant cette période. Nous apprécions vos retours et votre patience alors que nous continuons à améliorer la plateforme.

Licence

Licence MIT - voir le fichier LICENSE pour plus de détails.

Support

Pour le support et les questions :

• Documentation : documentation freispace
• Problèmes : Problèmes GitHub
• Contact : Support freispace