freispace MCP Server

resmi

Kaynak zamanlaması ve proje planlama verileri için freispace'i sorgula

GitHub
1

Freispace MCP ile neler yapabilirsiniz?

  • Kendi programınızı ve görevlerinizi kontrol edin — gelecek rezervasyonlarınızı get_my_schedule ile veya açık görevlerinizi get_my_tasks ile sorgulayın.
  • Müsait kişileri veya odaları bulun — belirli bir tarih aralığında kimin veya neyin boş olduğunu görmek için get_availability kullanın.
  • Bir projenin ekibini ve istatistiklerini inceleyin — katkıda bulunanlar için get_project_team veya rezervasyon dökümleri için get_project_stats sorgulayın.
  • Bir iş arkadaşınızın kimlerle çalıştığını görün — paylaşılan rezervasyon geçmişini ortaya çıkarmak için get_staff_collaborators çağrısı yapın.
  • Tatil bakiyelerini ve bir sonraki tatili gözden geçirin — kalan izin günlerini get_staff_holiday_quota ile veya bir sonraki tatili get_staff_next_holiday ile kontrol edin.
  • Faturaları, teklifleri veya siparişleri arayın — finansal kayıtları durum, tarih veya tutara göre get_invoices, get_offers veya get_orders kullanarak filtreleyin.

Dokümantasyon

freispace MCP Sunucusu

Planlama yazılımı freispace için analitik ve içgörüler sağlayan bir Model Bağlam Protokolü (MCP) sunucusu. Bu sunucu, yapay zeka asistanlarının (ör. Copilot, Gemini) proje istatistikleri ve planlama ile ilgili bilgiler gibi freispace içindeki verileri sorgulamasını sağlar.

Genel Bakış

freispace MCP Sunucusu, araç kullanma yeteneğine sahip herhangi bir LLM'yi analitik verileri sorgulamak üzere freispace'e bağlar.

freispace kullanan medya ekipleri, kullanıcıların freispace'te olmasına veya freispace hakkında bilgi sahibi olmasına gerek kalmadan, şirket çapındaki yapay zekayı (ör. Copilot) kullanarak planlama verilerini tüm şirketin kullanımına sunmak ve post-prodüksiyon ekiplerinin zamanlama ve planlama yaparken veriye dayalı kararlar almasına yardımcı olmak için MCP sunucusundan yararlanabilir.

MCP Sunucumuz her zaman kullanıcı izinlerine saygı gösterir, böylece LLM'nin verilere yalnızca kullanıcı bazında erişebilmesini sağlayarak veri güvenliğini garanti eder.

Örnek sorgular: "Geçmişte X Kişisi ile kimler çalıştı" veya "Kaç tatil günüm kaldı?"

Ön Koşullar

  1. freispace Flagship hesabı
  2. freispace için geçerli MCP API anahtarı
    • beta sırasında, bir MCP API anahtarı almak için freispace destek ekibinizle iletişime geçin

Kullanılabilir Araçlar

Tüm aramalar isme dayalıdır. Kısmi isimler eşleşir; ilk eşleşme kullanılır.

get_current_user

Arayan kullanıcının kim olduğu: isim, e-posta ve bağlı personel kaydı. Argüman gerektirmez. "Ben"/"beni"/"benim" ifadelerini bir personel ismine çözümlemek için kullanın.

"Kim olarak giriş yaptım?"

get_staffs

Personel üyelerini isim, unvan ve personel numarası ile listeler.

  • status (isteğe bağlı): active (varsayılan), inactive, all

"Tüm personel üyelerini listele" · "Şirketteki geliştiriciler kimler?"

find_resources

Odaları/stüdyoları (suitler), ekipmanı/lisansları (kaynaklar) ve personeli isme göre tek bir çağrıda, türe göre gruplandırarak arar.

  • search (isteğe bağlı): isim veya kısmi isim; her şeyi listelemek için atlayın
  • staff (isteğe bağlı): internal veya external
  • site (isteğe bağlı): yalnızca eşleşen konumlardaki suitler
  • status (isteğe bağlı): active (varsayılan), inactive, all

"Sammy'yi bul" · "Harici serbest çalışanları listele"

get_availability

Bir tarih aralığında (varsayılan 14 gün, maksimum 92) personelin, suitlerin veya kaynakların ne zaman müsait olduğunu, rezervasyonları, resmi tatilleri ve personel devamsızlıklarını/çalışma sürelerini dikkate alarak kontrol eder.

  • type (gerekli): staff, resource, suite veya site
  • search, staff, site, status (isteğe bağlı): find_resources'teki gibi varlık seçimi
  • from, to, days, weeks (isteğe bağlı): tarih aralığı
  • duration + duration_unit (isteğe bağlı): gerekli müsaitlik süresi (minutes, hours veya days)

"Önümüzdeki Salı 3 saatlik bir stüdyo müsait mi?" · "Önümüzdeki iki hafta içinde 2 tam gün boş olan kim var?"

get_my_schedule

Arayan kullanıcının bir tarih aralığındaki (varsayılan: önümüzdeki 7 gün) kendi rezervasyonları.

  • from, to, days, weeks (isteğe bağlı): tarih aralığı

"Bu haftaki programımda neler var?"

get_my_tasks

Arayan kullanıcıya atanmış görevler; son tarih, öncelik ve referans ile birlikte.

  • include_done (isteğe bağlı): tamamlanmış görevleri de dahil et

"Açık görevlerim neler?"

get_open_tasks

Ekibin tüm açık görevleri, atanan kişilerle birlikte.

  • reference (isteğe bağlı): project, booking veya user

"Hangi proje görevleri hala açık?"

get_staff_projects

Bir personel üyesinin rezerve edildiği projeleri, tarih aralığı ve süre ile listeler.

  • staff_name (gerekli)

"Karl hangi projelere rezerve edildi?"

get_staff_collaborators

Bir personel üyesinin, ortak rezervasyonlara dayanarak kimlerle çalıştığını gösterir.

  • staff_name (gerekli)

"Alexander kimlerle çalıştı?"

get_staff_next_holiday

Bir personel üyesinin bir sonraki yaklaşan tatilini (başlangıç, bitiş, süre, yorum) getirir.

  • staff_name (isteğe bağlı; arayan kullanıcı için atlayın)

"Bir sonraki tatilim ne zaman?" · "Hendrikje ne zaman tatilde?"

get_staff_holiday_quota

Bir personel üyesinin bir yıllık tatil kotasını getirir: toplam, kullanılan ve kalan günler.

  • staff_name (isteğe bağlı; arayan kullanıcı için atlayın)
  • year (isteğe bağlı; varsayılan olarak mevcut yıl)

"Kaç tatil günüm kaldı?"

get_project_stats

Bir proje için rezervasyon istatistikleri: durum bazında döküm ile geçmiş ve yaklaşan rezervasyonlar.

  • project_name (gerekli)

"Proje Alpha için rezervasyon istatistiklerini göster"

get_project_team

Bir projede çalışan personel üyelerini, projedeki rezervasyon sayılarıyla birlikte listeler.

  • project_name (gerekli)

"Web sitesi yeniden tasarımında kimler çalıştı?"

get_project_tasks

Bir projenin görev durumu: projedeki ve rezervasyonlarındaki tüm görevler, açık/tamamlandı/gecikmiş özeti ile birlikte.

  • project_name (gerekli)

"Belgesel projesinde açık görevler var mı?"

get_invoices

Faturaları filtreler ve para birimi bazında toplamlarla listeler; sayfalandırılmış. Durum grupları: draft, open, overdue, paid, partially-paid, canceled, locked.

  • search (isteğe bağlı): numara, sipariş numarası, konu, alıcı adresi ile eşleşir
  • 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 (isteğe bağlı)

"Hangi faturalar gecikmiş?" · "Acme için açık faturalar"

get_offers

Teklifleri filtreler ve para birimi bazında net toplamlarla listeler; sayfalandırılmış. Durum grupları: draft, locked, open, accepted, declined.

  • search, status, number, date_min/date_max, sum_min/sum_max, sort, order, page, per_page (isteğe bağlı)

"Bu yıldan reddedilen teklifleri göster"

get_orders

Siparişleri (işler), bağlı teklifleri ve faturaları satır içi olarak listeler; sayfalandırılmış.

  • search (isteğe bağlı): sipariş numarası ve adı ile eşleşir
  • status, number, date_min/date_max, sort, order, page, per_page (isteğe bağlı)

"2026-014 siparişinde ne teklif edildi ve faturalandı?"

search_docs

freispace dokümantasyonunu arar ve en alakalı alıntıları döndürür.

  • query (gerekli)
  • limit (isteğe bağlı): maksimum alıntı sayısı, varsayılan 5

"freispace'te vardiya planlamasını nasıl kurarım?"

Hata Yönetimi

Hatalar, çağıran modele kısa, eyleme dönük mesajlar olarak döndürülür (ör. Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.). Tanılamalar stderr'e kaydedilir; stdout yalnızca MCP protokolünü taşır.

⚠️ Beta Bildirimi

freispace MCP sunucumuz şu anda beta aşamasındadır. Bu dönem boyunca tüm özellikler ücretsizdir. Platformu geliştirmeye devam ederken geri bildirimlerinizi ve sabrınızı takdir ediyoruz.

Lisans

MIT Lisansı - ayrıntılar için LICENSE dosyasına bakın.

Destek

Destek ve sorular için: