freispace MCP Server

freispace MCP Server

เซิร์ฟเวอร์ Model Context Protocol (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. คีย์ MCP API ที่ถูกต้องสำหรับ freispace
   • ระหว่าง 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 ชั่วโมงไหม" · "ใครมีวันว่างเต็ม 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 (จำเป็น)

"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 (จำเป็น)

"แสดงสถิติการจองสำหรับ 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 เท่านั้น

⚠️ ประกาศเวอร์ชันเบต้า

เซิร์ฟเวอร์ freispace MCP ของเราอยู่ในเวอร์ชันเบต้าในขณะนี้ ฟีเจอร์ทั้งหมดให้บริการฟรีในช่วงเวลานี้ เราขอขอบคุณสำหรับความคิดเห็นและความอดทนของคุณในขณะที่เราพัฒนาแพลตฟอร์มต่อไป

ใบอนุญาต

ใบอนุญาต MIT - ดูรายละเอียดในไฟล์ LICENSE

การสนับสนุน

สำหรับการสนับสนุนและคำถาม:

• เอกสารประกอบ: เอกสารประกอบ freispace
• ปัญหา: GitHub Issues
• ติดต่อ: ฝ่ายสนับสนุน freispace