freispace MCP Server

Máy chủ MCP freispace

Máy chủ Giao thức Ngữ cảnh Mô hình (MCP) cung cấp phân tích và thông tin chi tiết cho phần mềm lập lịch freispace. Máy chủ này cho phép các trợ lý AI (ví dụ: Copilot, Gemini) truy vấn dữ liệu trong freispace, chẳng hạn như thống kê dự án và thông tin liên quan đến lập kế hoạch.

Tổng quan

Máy chủ MCP freispace kết nối bất kỳ LLM nào có khả năng công cụ với freispace để truy vấn dữ liệu phân tích.

Các nhóm truyền thông sử dụng freispace có thể tận dụng máy chủ MCP để cung cấp dữ liệu lập kế hoạch cho toàn bộ công ty bằng AI toàn công ty (ví dụ: Copilot), mà người dùng không cần phải có mặt trên freispace hoặc thậm chí biết về freispace, cũng như giúp các nhóm hậu kỳ đưa ra quyết định dựa trên dữ liệu trong khi lập lịch và lập kế hoạch.

Máy chủ MCP của chúng tôi luôn tôn trọng quyền của người dùng, đảm bảo rằng LLM sẽ chỉ có thể truy cập dữ liệu ở cấp độ từng người dùng, đảm bảo an toàn dữ liệu.

Các truy vấn ví dụ có thể là "Ai đã từng làm việc với Người X" hoặc "Tôi còn bao nhiêu ngày nghỉ phép?"

Điều kiện tiên quyết

1. Tài khoản freispace Flagship
2. Khóa API MCP hợp lệ cho freispace
   • Trong thời gian beta, hãy liên hệ với nhóm hỗ trợ freispace của bạn để nhận khóa API MCP

Công cụ có sẵn

Tất cả tra cứu đều dựa trên tên. Tên một phần khớp; kết quả khớp đầu tiên được sử dụng.

get_current_user

Người dùng đang gọi là ai: tên, email và hồ sơ nhân viên được liên kết. Không có đối số. Sử dụng nó để phân giải "tôi"/"của tôi" thành tên nhân viên.

"Tôi đang đăng nhập với tư cách ai?"

get_staffs

Liệt kê các thành viên nhân viên với tên, chức danh và mã số nhân viên.

• status (tùy chọn): active (mặc định), inactive, all

"Liệt kê tất cả nhân viên" · "Ai là nhà phát triển trong công ty?"

find_resources

Tìm kiếm phòng/studio (dãy phòng), thiết bị/giấy phép (tài nguyên) và nhân viên theo tên trong một lần gọi, được nhóm theo loại.

• search (tùy chọn): tên hoặc một phần tên; bỏ qua để liệt kê mọi thứ
• staff (tùy chọn): internal hoặc external
• site (tùy chọn): chỉ các dãy phòng tại các địa điểm phù hợp
• status (tùy chọn): active (mặc định), inactive, all

"Tìm Sammy" · "Liệt kê freelancer bên ngoài"

get_availability

Kiểm tra khi nào nhân viên, dãy phòng hoặc tài nguyên rảnh trong một khoảng thời gian (mặc định 14 ngày, tối đa 92), xem xét các đặt chỗ, ngày lễ và thời gian vắng mặt/làm việc của nhân viên.

• type (bắt buộc): staff, resource, suite hoặc site
• search, staff, site, status (tùy chọn): lựa chọn thực thể như trong find_resources
• from, to, days, weeks (tùy chọn): khoảng thời gian
• duration + duration_unit (tùy chọn): độ dài rảnh yêu cầu (minutes, hours hoặc days)

"Có studio nào rảnh vào thứ Ba tới trong 3 giờ không?" · "Ai có 2 ngày hoàn toàn rảnh trong hai tuần tới?"

get_my_schedule

Các đặt chỗ của chính người dùng đang gọi trong một khoảng thời gian (mặc định: 7 ngày tới).

• from, to, days, weeks (tùy chọn): khoảng thời gian

"Lịch trình của tôi tuần này có gì?"

get_my_tasks

Các nhiệm vụ được giao cho người dùng đang gọi, với ngày đến hạn, mức độ ưu tiên và tham chiếu.

• include_done (tùy chọn): cũng bao gồm các nhiệm vụ đã hoàn thành

"Các nhiệm vụ đang mở của tôi là gì?"

get_open_tasks

Tất cả các nhiệm vụ đang mở của nhóm, với người được giao.

• reference (tùy chọn): project, booking hoặc user

"Những nhiệm vụ dự án nào vẫn đang mở?"

get_staff_projects

Liệt kê các dự án mà một nhân viên được đặt lịch, với phạm vi ngày và thời lượng.

• staff_name (bắt buộc)

"Karl được đặt lịch cho những dự án nào?"

get_staff_collaborators

Hiển thị những người mà một nhân viên đã làm việc cùng, dựa trên các đặt chỗ chung.

• staff_name (bắt buộc)

"Alexander đã làm việc với ai?"

get_staff_next_holiday

Lấy kỳ nghỉ sắp tới tiếp theo của một nhân viên (bắt đầu, kết thúc, độ dài, nhận xét).

• staff_name (tùy chọn; bỏ qua cho người dùng đang gọi)

"Kỳ nghỉ tiếp theo của tôi là khi nào?" · "Khi nào Hendrikje đi nghỉ?"

get_staff_holiday_quota

Lấy hạn ngạch nghỉ phép của một nhân viên trong một năm: tổng số, đã sử dụng và số ngày còn lại.

• staff_name (tùy chọn; bỏ qua cho người dùng đang gọi)
• year (tùy chọn; mặc định là năm hiện tại)

"Tôi còn bao nhiêu ngày nghỉ phép?"

get_project_stats

Thống kê đặt chỗ cho một dự án: các đặt chỗ trong quá khứ so với sắp tới với phân tích theo trạng thái, cộng với khoảng thời gian dự án (bắt đầu đặt chỗ đầu tiên, kết thúc đặt chỗ cuối cùng và thời lượng tính bằng ngày giữa chúng).

• project_name (bắt buộc)

"Hiển thị thống kê đặt chỗ cho Dự án Alpha" · "Dự án Alpha kéo dài bao lâu?"

get_project_team

Liệt kê các nhân viên đã làm việc trong một dự án, với số lượng đặt chỗ của họ trên đó.

• project_name (bắt buộc)

"Ai đã làm việc trong thiết kế lại trang web?"

get_project_tasks

Trạng thái nhiệm vụ của một dự án: tất cả các nhiệm vụ trên dự án và các đặt chỗ của nó, với tóm tắt mở/hoàn thành/quá hạn.

• project_name (bắt buộc)

"Có nhiệm vụ nào đang mở trong dự án phim tài liệu không?"

get_invoices

Liệt kê hóa đơn với các bộ lọc và tổng theo từng loại tiền tệ; được phân trang. Các nhóm trạng thái: draft, open, overdue, paid, partially-paid, canceled, locked.

• search (tùy chọn): khớp số, số đơn hàng, chủ đề, địa chỉ người nhận
• 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 (tùy chọn)

"Hóa đơn nào quá hạn?" · "Hóa đơn đang mở cho Acme"

get_offers

Liệt kê báo giá với các bộ lọc và tổng ròng theo từng loại tiền tệ; được phân trang. Các nhóm trạng thái: draft, locked, open, accepted, declined.

• search, status, number, date_min/date_max, sum_min/sum_max, sort, order, page, per_page (tùy chọn)

"Hiển thị báo giá bị từ chối từ năm nay"

get_orders

Liệt kê đơn hàng (công việc) với các báo giá và hóa đơn được kết nối nội tuyến; được phân trang.

• search (tùy chọn): khớp số đơn hàng và tên
• status, number, date_min/date_max, sort, order, page, per_page (tùy chọn)

"Những gì đã được báo giá và lập hóa đơn trên đơn hàng 2026-014?"

search_docs

Tìm kiếm tài liệu freispace và trả về các đoạn trích có liên quan nhất.

• query (bắt buộc)
• limit (tùy chọn): đoạn trích tối đa, mặc định 5

"Làm cách nào để thiết lập lập kế hoạch ca làm việc trong freispace?"

Xử lý lỗi

Lỗi được trả về cho mô hình gọi dưới dạng các thông báo ngắn gọn, có thể hành động (ví dụ: Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.). Chẩn đoán được ghi vào stderr; stdout chỉ mang giao thức MCP.

⚠️ Thông báo Beta

Máy chủ MCP freispace của chúng tôi hiện đang trong giai đoạn beta. Tất cả các tính năng đều miễn phí trong giai đoạn này. Chúng tôi đánh giá cao phản hồi và sự kiên nhẫn của bạn khi chúng tôi tiếp tục cải thiện nền tảng.

Giấy phép

Giấy phép MIT - xem tệp LICENSE để biết chi tiết.

Hỗ trợ

Để được hỗ trợ và giải đáp thắc mắc:

• Tài liệu: tài liệu freispace
• Vấn đề: GitHub Issues
• Liên hệ: Hỗ trợ freispace