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 ของเราเคารพสิทธิ์ผู้ใช้เสมอ เพื่อให้แน่ใจว่า 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"

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