freispace MCP Server

官方

查詢 freispace 以獲取資源排程與專案規劃資料

GitHub
1

你可以用 Freispace MCP 做什麼？

  • Check your own schedule and tasks — ask for your upcoming bookings with get_my_schedule or open tasks with get_my_tasks.
  • Find available people or rooms — use get_availability to see who or what is free in a given date window.
  • Look up a project’s team and stats — query get_project_team for contributors or get_project_stats for booking breakdowns.
  • See who a colleague has worked with — call get_staff_collaborators to surface shared booking history.
  • Review holiday balances and next holiday — check remaining vacation days via get_staff_holiday_quota or the next upcoming holiday with get_staff_next_holiday.
  • Search invoices, offers, or orders — filter financial records by status, date, or amount using get_invoices, get_offers, or get_orders.

文件

freispace MCP Server

一個模型上下文協定 (MCP) 伺服器，為排程軟體 freispace 提供分析與洞察。此伺服器讓 AI 助理（例如 Copilot、Gemini）能夠查詢 freispace 內的資料，例如專案統計資料和規劃相關資訊。

概觀

freispace MCP Server 可將任何具備工具能力的 LLM 連接到 freispace，以查詢分析資料。

使用 freispace 的媒體團隊可以運用 MCP 伺服器，透過公司內部的 AI（例如 Copilot）將規劃資料提供給全公司使用，使用者無需登入 freispace 甚至不需要知道 freispace，同時也能協助後製團隊在排程和規劃時做出資料驅動的決策。

我們的 MCP Server 始終尊重使用者權限，確保 LLM 只能以每位使用者為基礎存取資料，保障資料安全。

範例查詢可能像是「誰過去曾與 Person X 共事過」或「我還剩多少天休假？」

先決條件

  1. freispace Flagship 帳戶
  2. 有效的 freispace MCP API 金鑰
    • 在 beta 期間，請聯絡您的 freispace 支援團隊以取得 MCP API 金鑰

可用工具

所有查詢均以名稱為基礎。支援部分名稱比對；將使用第一個符合的結果。

get_current_user

查詢呼叫端使用者的身分：姓名、電子郵件和連結的員工記錄。無需引數。用於將「我」解析為員工姓名。

「我目前是以誰的身分登入？」

get_staffs

列出員工成員，包含姓名、職稱和員工編號。

  • status（選用）：active（預設）、inactive、all

「列出所有員工成員」·「公司裡的開發人員有哪些？」

find_resources

在單一呼叫中依名稱搜尋房間/工作室（套房）、設備/授權（資源）和員工，並按類型分組。

  • search（選用）：名稱或部分名稱；省略則列出全部
  • staff（選用）：internal 或 external
  • site（選用）：僅限符合指定地點的套房
  • status（選用）：active（預設）、inactive、all

「尋找 Sammy」·「列出外部自由工作者」

get_availability

檢查員工、套房或資源在指定日期範圍內（預設 14 天，最長 92 天）何時有空，考量預訂、國定假日和員工休假/工作時間。

  • type（必要）：staff、resource、suite 或 site
  • search、staff、site、status（選用）：如同 find_resources 中的實體選取
  • from、to、days、weeks（選用）：日期範圍
  • duration + duration_unit（選用）：所需的空閒時長（minutes、hours 或 days）

「下週二有工作室可以空出 3 小時嗎？」·「未來兩週內誰有整整兩天的空檔？」

get_my_schedule

查詢呼叫端使用者在指定日期範圍內（預設：未來 7 天）的自身預訂。

  • from、to、days、weeks（選用）：日期範圍

「我這週的行程是什麼？」

get_my_tasks

指派給呼叫端使用者的任務，包含到期日、優先順序和參考。

  • include_done（選用）：也包含已完成的任務

「我有哪些待辦任務？」

get_open_tasks

團隊的所有待辦任務，包含指派對象。

  • reference（選用）：project、booking 或 user

「哪些專案任務仍未完成？」

get_staff_projects

列出某位員工成員被預訂參與的專案，包含日期範圍和時長。

  • staff_name（必要）

「Karl 被預訂參與哪些專案？」

get_staff_collaborators

根據共同的預訂記錄，顯示某位員工成員曾與誰共事過。

  • staff_name（必要）

「Alexander 曾與誰共事過？」

get_staff_next_holiday

取得某位員工成員下一個即將到來的假期（開始、結束、時長、備註）。

  • staff_name（選用；省略則查詢呼叫端使用者）

「我的下一個假期是什麼時候？」·「Hendrikje 什麼時候休假？」

get_staff_holiday_quota

取得某位員工成員某一年的假期配額：總天數、已使用天數和剩餘天數。

  • staff_name（選用；省略則查詢呼叫端使用者）
  • year（選用；預設為今年）

「我還剩多少天休假？」

get_project_stats

單一專案的預訂統計資料：過去與即將到來的預訂，以及依狀態的明細。

  • project_name（必要）

「顯示 Alpha 專案的預訂統計資料」

get_project_team

列出曾參與某專案的員工成員，以及他們在該專案上的預訂數量。

  • project_name（必要）

「誰曾參與網站重新設計？」

get_project_tasks

單一專案的任務狀態：該專案及其預訂上的所有任務，包含待辦/完成/逾期摘要。

  • project_name（必要）

「紀錄片專案上有待辦任務嗎？」

get_invoices

列出發票，可篩選並顯示每種貨幣的總計；分頁顯示。狀態分類：draft、open、overdue、paid、partially-paid、canceled、locked。

  • search（選用）：比對編號、訂單編號、主旨、收件人地址
  • 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（選用）

「哪些發票已逾期？」·「Acme 的未付發票」

get_offers

列出報價單，可篩選並顯示每種貨幣的淨總計；分頁顯示。狀態分類：draft、locked、open、accepted、declined。

  • search、status、number、date_min/date_max、sum_min/sum_max、sort、order、page、per_page（選用）

「顯示今年已拒絕的報價單」

get_orders

列出訂單（工作），並內嵌顯示其關聯的報價單和發票；分頁顯示。

  • search（選用）：比對訂單編號和名稱
  • status、number、date_min/date_max、sort、order、page、per_page（選用）

「訂單 2026-014 的報價和帳單內容是什麼？」

search_docs

搜尋 freispace 文件並傳回最相關的摘錄。

  • query（必要）
  • limit（選用）：最大摘錄數，預設為 5

「如何在 freispace 中設定輪班規劃？」

錯誤處理

錯誤會以簡短、可採取行動的訊息（例如 Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.）傳回給呼叫端模型。診斷資訊會記錄到 stderr；stdout 僅攜帶 MCP 協定內容。

⚠️ Beta 版通知

我們的 freispace MCP 伺服器目前處於 Beta 階段。在此期間所有功能皆為免費。我們感謝您的回饋與耐心，我們將持續改進平台。

授權

MIT 授權 - 詳情請參閱 LICENSE 檔案。

支援

如需支援和疑問：