使用说明
自由空间MCP服务器
模型上下文协议（MCP）服务器，为 调度软件freispace该服务器使AI助手（如Copilot、Gemini）能够查询freispace中的数据，如项目统计数据和规划相关信息。
概述
freispace MCP服务器将任何具有工具功能的LLM连接到 自由空间 查询分析数据。
使用freispace的媒体团队可以利用MCP服务器，使用全公司的人工智能（如Copilot）向整个公司提供规划数据，而用户不必在freispace上，甚至不必知道freispace，并帮助后期制作团队在调度和规划时做出数据驱动的决策。
我们的MCP服务器始终尊重用户权限，确保LLM只能访问每个用户级别的数据，从而确保数据安全。
示例查询可能是“过去谁和X一起工作过”或“我还有多少假期？”
先决条件
- 自由 空间 旗舰 账户
- 用于freispace的有效MCP API密钥
- 在...期间
beta，联系您的freispace支持团队以获取MCP API密钥
- 在...期间
可用工具
所有查找都是基于名称的。部分名称匹配；使用第一场比赛。
get_current_user
主叫用户是谁：姓名、电子邮件和链接的员工记录。没有争论。使用它将“I”/“me”/“my”解析为员工姓名。
“我以谁的身份登录？”
get_staffs
列出员工姓名、职务和员工编号。
status（可选）：active（默认），inactive,all
“列出所有员工”·“公司的开发人员是谁？”
find_resources
在一次通话中按姓名搜索房间/工作室（套房）、设备/许可证（资源）和员工，并按类型分组。
search（可选）：名称或部分名称；省略列出所有内容staff（可选）：internal或externalsite（可选）：仅适用于匹配地点的套房status（可选）：active（默认），inactive,all
“查找萨米”·“列出外部自由职业者”
get_availability
考虑到预订、公共假期和员工缺勤/工作时间，检查员工、套房或资源在日期窗口（默认14天，最多92天）内何时空闲。
type（必填）：staff,resource,suite或sitesearch,staff,site,status（可选）：实体选择，如find_resourcesfrom,to,days,weeks（可选）：日期窗口duration+duration_unit（可选）：所需自由长度(minutes,hours或days)
“下周二工作室有3个小时的空闲时间吗？”·“谁在接下来的两周里有2天完全空闲？”
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（必填）
“卡尔预订了哪些项目？”
get_staff_collaborators
根据共享预订显示员工曾与谁合作过。
staff_name（必填）
“亚历山大和谁一起工作过？”
get_staff_next_holiday
获取员工下一个即将到来的假期（开始、结束、长度、评论）。
staff_name（可选；对于主叫用户省略）
“我的下一个假期是什么时候？”·“Hendrikje什么时候度假？”
get_staff_holiday_quota
获取员工一年的假期配额：总天数、已用天数和剩余天数。
staff_name（可选；对于主叫用户省略）year（可选；默认为当前年份）
“我还有多少假期？”
get_project_stats
一个项目的预订统计数据：过去与即将进行的预订，按状态细分，加上项目时间跨度（第一次预订开始、最后一次预订结束以及它们之间的持续时间（以天为单位））。
project_name（必填）
“显示Project Alpha的预订统计信息”·“Project 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服务器目前处于测试阶段。在此期间，所有功能均免费。我们感谢您的反馈和耐心，因为我们将继续改进平台。
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
支持
有关支持和问题：
- 文档: freispace文档
- 问题: GitHub问题
- 联系: 自由空间支持
