freispace MCP Server

resmi

Kueri freispace untuk data penjadwalan sumber daya dan perencanaan proyek

GitHub
1

Apa yang bisa Anda lakukan dengan Freispace MCP?

  • Periksa jadwal Anda sendiri — Tanyakan pemesanan yang Anda miliki minggu ini atau dalam rentang tanggal tertentu menggunakan get_my_schedule.
  • Temukan orang atau ruangan yang tersedia — Gunakan get_availability untuk melihat siapa atau studio mana yang kosong untuk durasi tertentu dalam jangka waktu tertentu.
  • Cari statistik pemesanan proyek — Ambil rincian pemesanan masa lalu vs. mendatang serta total rentang waktu proyek dengan get_project_stats.
  • Lihat siapa yang bekerja dengan rekan kerja — Cari kolaborator sebelumnya berdasarkan pemesanan bersama melalui get_staff_collaborators.
  • Tinjau saldo cuti Anda — Dapatkan total hari libur yang diambil dan tersisa untuk tahun berjalan dengan get_staff_holiday_quota.
  • Cari faktur berdasarkan status — Daftarkan faktur yang jatuh tempo, terbuka, atau lunas serta lihat total per mata uang menggunakan get_invoices.

Dokumentasi

Server MCP freispace

Server Model Context Protocol (MCP) yang menyediakan analitik dan wawasan untuk perangkat lunak penjadwalan freispace. Server ini memungkinkan asisten AI (misalnya Copilot, Gemini) untuk menanyakan data di dalam freispace, seperti statistik proyek dan informasi terkait perencanaan.

Gambaran Umum

Server MCP freispace menghubungkan LLM apa pun yang memiliki kemampuan alat ke freispace untuk menanyakan data analitis.

Tim media yang menggunakan freispace dapat memanfaatkan server MCP untuk menyediakan data perencanaan bagi seluruh perusahaan menggunakan AI perusahaan (misalnya Copilot), tanpa pengguna harus berada di freispace atau bahkan mengetahui tentang freispace, serta membantu tim pasca-produksi membuat keputusan berbasis data saat menjadwalkan dan merencanakan.

Server MCP kami selalu menghormati izin pengguna, memastikan bahwa LLM hanya akan dapat mengakses data pada tingkat per pengguna, menjamin keamanan data.

Contoh kueri mungkin seperti "Dengan siapa Orang X pernah bekerja sebelumnya" atau "Berapa sisa hari cuti saya?"

Prasyarat

  1. Akun freispace Flagship
  2. Kunci API MCP yang valid untuk freispace
    • Selama beta, hubungi tim dukungan freispace Anda untuk mendapatkan kunci API MCP

Alat yang Tersedia

Semua pencarian berbasis nama. Nama parsial cocok; kecocokan pertama yang digunakan.

get_current_user

Siapa pengguna yang memanggil: nama, email, dan catatan staf tertaut. Tanpa argumen. Gunakan untuk menyelesaikan "saya"/"aku"/"milik saya" menjadi nama staf.

"Saya masuk sebagai siapa?"

get_staffs

Daftar anggota staf dengan nama, jabatan, dan nomor staf.

  • status (opsional): active (default), inactive, all

"Daftar semua anggota staf" · "Siapa saja pengembang di perusahaan?"

find_resources

Cari ruangan/studio (suite), peralatan/lisensi (sumber daya), dan staf berdasarkan nama dalam satu panggilan, dikelompokkan berdasarkan jenis.

  • search (opsional): nama atau nama parsial; kosongkan untuk mendaftar semuanya
  • staff (opsional): internal atau external
  • site (opsional): hanya suite di lokasi yang cocok
  • status (opsional): active (default), inactive, all

"Cari Sammy" · "Daftar pekerja lepas eksternal"

get_availability

Periksa kapan staf, suite, atau sumber daya bebas dalam jendela tanggal (default 14 hari, maks 92), dengan mempertimbangkan pemesanan, hari libur nasional, dan ketidakhadiran/waktu kerja staf.

  • type (wajib): staff, resource, suite, atau site
  • search, staff, site, status (opsional): pemilihan entitas seperti di find_resources
  • from, to, days, weeks (opsional): jendela tanggal
  • duration + duration_unit (opsional): durasi bebas yang diperlukan (minutes, hours, atau days)

"Apakah ada studio yang bebas Selasa depan selama 3 jam?" · "Siapa yang memiliki 2 hari penuh bebas dalam dua minggu ke depan?"

get_my_schedule

Pemesanan pengguna yang memanggil sendiri dalam jendela tanggal (default: 7 hari ke depan).

  • from, to, days, weeks (opsional): jendela tanggal

"Apa jadwal saya minggu ini?"

get_my_tasks

Tugas yang ditugaskan kepada pengguna yang memanggil, dengan tanggal jatuh tempo, prioritas, dan referensi.

  • include_done (opsional): juga sertakan tugas yang sudah selesai

"Apa tugas terbuka saya?"

get_open_tasks

Semua tugas terbuka tim, dengan penerima tugas.

  • reference (opsional): project, booking, atau user

"Tugas proyek mana yang masih terbuka?"

get_staff_projects

Daftar proyek tempat seorang anggota staf dipesan, dengan rentang tanggal dan durasi.

  • staff_name (wajib)

"Di proyek apa Karl dipesan?"

get_staff_collaborators

Tunjukkan dengan siapa seorang anggota staf pernah bekerja, berdasarkan pemesanan bersama.

  • staff_name (wajib)

"Dengan siapa Alexander pernah bekerja?"

get_staff_next_holiday

Dapatkan liburan berikutnya yang akan datang dari seorang anggota staf (mulai, selesai, durasi, komentar).

  • staff_name (opsional; kosongkan untuk pengguna yang memanggil)

"Kapan liburan saya berikutnya?" · "Kapan Hendrikje liburan?"

get_staff_holiday_quota

Dapatkan kuota liburan seorang anggota staf untuk satu tahun: total, diambil, dan sisa hari.

  • staff_name (opsional; kosongkan untuk pengguna yang memanggil)
  • year (opsional; default ke tahun berjalan)

"Berapa sisa hari cuti saya?"

get_project_stats

Statistik pemesanan untuk satu proyek: pemesanan masa lalu vs yang akan datang dengan rincian per status, plus rentang waktu proyek (mulai pemesanan pertama, akhir pemesanan terakhir, dan durasi dalam hari di antaranya).

  • project_name (wajib)

"Tampilkan statistik pemesanan untuk Proyek Alpha" · "Berapa lama Proyek Alpha berjalan?"

get_project_team

Daftar anggota staf yang mengerjakan suatu proyek, dengan jumlah pemesanan mereka di dalamnya.

  • project_name (wajib)

"Siapa yang mengerjakan desain ulang situs web?"

get_project_tasks

Status tugas satu proyek: semua tugas pada proyek dan pemesanannya, dengan ringkasan terbuka/selesai/terlambat.

  • project_name (wajib)

"Apakah ada tugas terbuka pada proyek dokumenter?"

get_invoices

Daftar faktur dengan filter dan total per mata uang; dipaginasi. Kelompok status: draft, open, overdue, paid, partially-paid, canceled, locked.

  • search (opsional): cocok dengan nomor, nomor pesanan, subjek, alamat penerima
  • 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 (opsional)

"Faktur mana yang terlambat?" · "Faktur terbuka untuk Acme"

get_offers

Daftar penawaran (kutipan) dengan filter dan total bersih per mata uang; dipaginasi. Kelompok status: draft, locked, open, accepted, declined.

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

"Tampilkan penawaran yang ditolak dari tahun ini"

get_orders

Daftar pesanan (pekerjaan) dengan penawaran dan faktur terkait secara inline; dipaginasi.

  • search (opsional): cocok dengan nomor pesanan dan nama
  • status, number, date_min/date_max, sort, order, page, per_page (opsional)

"Apa yang dikutip dan ditagih pada pesanan 2026-014?"

search_docs

Cari dokumentasi freispace dan kembalikan kutipan yang paling relevan.

  • query (wajib)
  • limit (opsional): maks kutipan, default 5

"Bagaimana cara mengatur perencanaan shift di freispace?"

Penanganan Kesalahan

Kesalahan dikembalikan ke model pemanggil sebagai pesan singkat yang dapat ditindaklanjuti (misalnya Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.). Diagnostik dicatat ke stderr; stdout hanya membawa protokol MCP.

⚠️ Pemberitahuan Beta

Server MCP freispace kami saat ini dalam versi beta. Semua fitur gratis selama periode ini. Kami menghargai masukan dan kesabaran Anda saat kami terus meningkatkan platform.

Lisensi

Lisensi MIT - lihat file LICENSE untuk detailnya.

Dukungan

Untuk dukungan dan pertanyaan: