freispace MCP Server

freispace MCP Sunucusu

freispace planlama yazılımı 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) freispace içindeki proje istatistikleri ve planlama ile ilgili bilgiler gibi verileri sorgulamasını sağlar.

Genel Bakış

freispace MCP Sunucusu, araç kullanma yeteneğine sahip herhangi bir LLM'yi analitik verileri sorgulamak üzere freispace platformuna 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 genelindeki yapay zeka (ör. Copilot) aracılığıyla 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 yalnızca kullanıcı bazında verilere erişebilmesini sağlayarak veri güvenliğini garanti eder.

Örnek sorgular: "Geçmişte X Kişisi ile kimler çalıştı?" veya "Kaç gün iznim 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

Çağrıyı yapan 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 boş bırakı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

Personelin, suitlerin veya kaynakların bir tarih aralığında (varsayılan 14 gün, maksimum 92) 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 aracındaki 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 boş bir stüdyo var mı?" · "Önümüzdeki iki hafta içinde 2 tam gün boş olan kim var?"

get_my_schedule

Çağrıyı yapan 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

Çağrıyı yapan 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, açıklama) getirir.

• staff_name (isteğe bağlı; çağrıyı yapan kullanıcı için boş bırakı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ı; çağrıyı yapan kullanıcı için boş bırakın)
• year (isteğe bağlı; varsayılan olarak mevcut yıl)

"Kaç gün iznim kaldı?"

get_project_stats

Bir proje için rezervasyon istatistikleri: durum bazında dağılım ile geçmiş ve yaklaşan rezervasyonlar, ayrıca proje zaman aralığı (ilk rezervasyon başlangıcı, son rezervasyon bitişi ve aralarındaki gün cinsinden süre).

• project_name (gerekli)

"Alfa Projesi için rezervasyon istatistiklerini göster" · "Alfa Projesi ne kadar sürüyor?"

get_project_team

Bir projede çalışan personel üyelerini, o 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

Filtreler ve para birimi bazında toplamlarla faturaları listeler; sayfalandırılmıştır. 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

Filtreler ve para birimi bazında net toplamlarla teklifleri listeler; sayfalandırılmıştır. 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şleri), bağlı teklifleri ve faturaları satır içi olarak listeler; sayfalandırılmıştır.

• 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ümantasyonunda arama yapar 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ğrı yapan modele kısa, uygulanabilir 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ınız için:

• Dokümantasyon: freispace dokümantasyonu
• Sorunlar: GitHub Sorunları
• İletişim: freispace Destek