freispace MCP Server

官方

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

GitHub
1
試用此 MCP贊助

你可以用 Freispace MCP 做什麼？

  • 檢查自己的行程 — 使用 get_my_schedule 查詢本週或特定日期範圍內的預約。
  • 尋找可用的人員或空間 — 使用 get_availability 查看在指定日期範圍內，誰或哪個工作室在特定時長內有空。
  • 查詢專案預約統計 — 使用 get_project_stats 取得過去與未來預約的明細比較，以及專案總時間跨度。
  • 查看與同事的合作記錄 — 透過 get_staff_collaborators 查詢基於共同預約的過去合作對象。
  • 檢視假期餘額 — 使用 get_staff_holiday_quota 取得當年度總假期天數、已休天數及剩餘天數。
  • 依狀態搜尋發票 — 使用 get_invoices 列出逾期、未結或已付款的發票，並查看各幣別的總金額。

文件

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 的預訂統計資料」·「專案 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 檔案。

支援

如需支援與疑問：