กลับหน้าแรก
    คู่มือ MCP Connection

    เชื่อมต่อ ChatGPT กับ VertexHR อย่างปลอดภัย

    ทำตามทีละขั้นเพื่อให้ ChatGPT หรือ MCP client ที่รองรับ อ่านข้อมูล HR ตามบทบาทและสิทธิ์ของคุณ โดย VertexHR MCP Phase 1 ไม่สามารถแก้ไขข้อมูลได้

    Read-only ประมาณ 5 นาที ใช้สิทธิ์บัญชีเดิม

    ภาพรวมการเชื่อมต่อ

    ChatGPT / MCP client

    ส่งคำขอผ่าน MCP

    VertexHR OAuth

    ลงชื่อเข้าใช้และอนุมัติ

    Role + Permission + RLS

    ตรวจสิทธิ์ทุกครั้งก่อนอ่าน

    เริ่มจากภาพรวม

    VertexHR MCP คืออะไร

    MCP (Model Context Protocol) เป็นมาตรฐานที่ช่วยให้ AI client เรียกใช้เครื่องมือจากระบบภายนอกได้อย่างมีโครงสร้าง สำหรับ VertexHR การเชื่อมต่อนี้ทำให้ AI อ่านข้อมูลที่ได้รับอนุญาตเพื่อช่วยค้นหาและสรุปผล โดยไม่เปิดสิทธิ์แก้ไขข้อมูล

    ถามด้วยภาษาธรรมชาติ

    เช่น “สรุปภาพรวมการลาสัปดาห์นี้”

    สิทธิ์ตามผู้ใช้งานจริง

    ใช้บริษัท Active บทบาท Permission และ RLS เดิม

    ไม่ส่งข้อมูลเกินจำเป็น

    ไม่เปิดเผยข้อมูลส่วนตัวหรือค่าตอบแทนรายบุคคล

    ก่อนเริ่ม

    สิ่งที่ต้องมี ก่อนเริ่มเชื่อมต่อ

    1. 1บัญชี VertexHR ที่ยังใช้งานได้ และเลือกบริษัทที่ต้องการเป็น Active company แล้ว
    2. 2บัญชีหรือ Workspace ChatGPT ที่รองรับ custom MCP apps บนเว็บ และได้รับสิทธิ์ Developer mode จากผู้ดูแล (เมนูนี้ไม่มีในทุกบัญชี)
    3. 3สิทธิ์ Manager หรือ Admin หากต้องการข้อมูลภาพรวมระดับองค์กร (Employee จะเห็นเฉพาะเครื่องมือที่อนุญาต)

    ทำตามทีละขั้น

    ขั้นตอนการเชื่อมต่อ

    ชื่อเมนู ChatGPT อาจเปลี่ยนเล็กน้อยตามเวอร์ชัน ภาษา และนโยบายของ Workspace แต่ลำดับการเชื่อมต่อยังคงเหมือนกัน

    STEP 01

    เปิดคู่มือจากหน้าแรก VertexHR

    กด “ดูขั้นตอนการเชื่อมต่อ” ในส่วน ChatGPT + VertexHR MCP แล้วเตรียม MCP endpoint ด้านล่างไว้สำหรับเพิ่มการเชื่อมต่อ

    ส่วนแนะนำการเชื่อมต่อ ChatGPT กับ VertexHR บนหน้าแรก พร้อมปุ่มดูขั้นตอนการเชื่อมต่อ
    ส่วนเชื่อมต่อ MCP บนหน้าแรก — กด “ดูขั้นตอนการเชื่อมต่อ” เพื่อเปิดคู่มือนี้
    หน้าแรกของคู่มือเชื่อมต่อ ChatGPT กับ VertexHR แสดงหัวข้อและสถานะ Read-only
    หน้าเริ่มต้นของคู่มือ MCP พร้อมสรุปขอบเขต Read-only

    STEP 02

    ตรวจสอบสิทธิ์และเปิด Developer mode

    เมื่อบัญชีได้รับอนุญาตแล้ว ให้ไปที่ User Settings → Apps → Advanced Settings → Developer mode เมนูนี้ไม่ได้แสดงสำหรับทุกบัญชี และผู้ดูแล Business, Enterprise หรือ Edu Workspace อาจต้องเปิดสิทธิ์ developer/custom MCP จาก Workspace Settings ก่อน

    STEP 03

    เริ่มสร้าง VertexHR custom app

    ใน ChatGPT web ไปที่ Settings → Apps → Create หรือ Workspace Settings → Apps → Create ตามสิทธิ์ของบัญชี แล้วตั้งชื่อ custom app ว่า VertexHR

    ภาพประกอบขั้นตอนสร้าง VertexHR custom app ตั้งแต่ Apps จนถึง Scan Tools และ VertexHR OAuth
    ภาพประกอบ / Illustration — ไม่ใช่ภาพหน้าจอทางการของ ChatGPT หน้าตาเมนูอาจต่างกันตามบัญชีและ Workspace

    STEP 04

    ใส่ endpoint และ Scan Tools

    ใส่ VertexHR MCP endpoint แบบ HTTPS เลือกหรือกำหนดวิธี Authentication ตามที่หน้าจอรองรับ แล้วกด Scan Tools เพื่อเริ่มค้นหาเครื่องมือและขั้นตอน OAuth

    STEP 05

    เข้าสู่ระบบ VertexHR

    เมื่อ ChatGPT เปิดหน้าลงชื่อเข้าใช้ ให้ใช้บัญชี VertexHR ของคุณ ระบบจะรักษาคำขอเชื่อมต่อไว้และพากลับไปยังขั้นตอนอนุมัติ

    STEP 06

    ตรวจสอบและอนุมัติสิทธิ์ Read-only

    อ่านชื่อแอป ปลายทาง และขอบเขตสิทธิ์บนหน้า VertexHR จากนั้นกด “Allow read-only access” เฉพาะเมื่อข้อมูลถูกต้อง หรือกด Deny เพื่อยกเลิก

    หน้าขออนุมัติ VertexHR แสดงข้อความ Read-only ปุ่ม Allow read-only access และปุ่ม Deny
    ตัวอย่างหน้าขออนุมัติ VertexHR แบบ Read-only ที่ผ่านการทำข้อมูลให้ปลอดภัยแล้ว

    STEP 07

    รอ Tool discovery แล้วสร้าง app

    กลับไปที่ ChatGPT รอให้ระบบค้นหา Tools จนเสร็จ แล้วกด Create จากนั้น VertexHR จะปรากฏที่ Settings → Apps → Enabled Apps หรือ Workspace Settings → Apps → Drafts ตามบทบาทและประเภท Workspace

    STEP 08

    เริ่มบทสนทนาและเลือก VertexHR

    เปิดบทสนทนาใหม่ เลือก VertexHR จากเมนู Apps/Tools แล้วถามข้อมูลที่บทบาทของคุณมีสิทธิ์ดู เช่น สรุปการลงเวลาหรือภาพรวมการลา

    หลังเชื่อมต่อ

    เมื่อเชื่อมต่อแล้ว ทำอะไรได้บ้าง

    ข้อมูลบริษัทปัจจุบัน

    ทุกบทบาท

    ดูชื่อบริษัท สถานะ และบทบาทปัจจุบันของคุณ

    ค้นหารายชื่อพนักงาน

    Manager ขึ้นไป

    ดูรหัส ชื่อ ตำแหน่ง แผนก และสถานะการทำงาน

    สรุปเวลาและการลา

    Manager ขึ้นไป

    ดูยอดรวมการลงเวลาและการลาโดยไม่เปิดเผยเหตุผลหรือข้อมูลอ่อนไหว

    สรุปเงินเดือนแบบรวม

    Admin ขึ้นไป

    ดูยอดรวมจากรอบเงินเดือนล่าสุด ไม่มีข้อมูลเงินเดือนรายบุคคล

    ขอบเขตสำคัญ: Phase 1 ไม่รองรับการเพิ่ม แก้ไข อนุมัติ หรือลบข้อมูลใด ๆ และการแสดงผลแต่ละเครื่องมือขึ้นอยู่กับบทบาทและ Permission ของผู้ใช้

    มั่นใจได้มากขึ้น

    ความปลอดภัยและสิทธิ์การเข้าถึง

    ตรวจสิทธิ์ทุกคำขอ

    Client ไม่สามารถเลือก company_id เองได้ VertexHR จะใช้บริษัท Active ของบัญชีที่ลงชื่อเข้าใช้ แล้วตรวจบทบาท Permission และ RLS ก่อนอ่านข้อมูล พร้อมบันทึก Audit event ของการเรียกใช้เครื่องมือ

    ข้อมูลที่ MCP Phase 1 ไม่เปิดเผย

    • เลขบัตรประชาชนและเลขผู้เสียภาษี
    • บัญชีธนาคาร ที่อยู่ และข้อมูลติดต่อ
    • เงินเดือนหรือรายการหักรายบุคคล
    • เหตุผลการลา เอกสารแนบ หรือข้อมูลสุขภาพ
    • พิกัดการลงเวลา
    • ข้อมูลพนักงานข้ามบริษัท

    แก้ปัญหาเบื้องต้น

    ปัญหาที่พบบ่อย

    ไม่เห็น Developer mode หรือปุ่ม Create ใน Apps

    เมนูนี้ไม่ได้แสดงสำหรับทุกบัญชี ผู้ดูแล Business, Enterprise หรือ Edu Workspace อาจต้องเปิด developer/custom MCP access ใน Workspace Settings และอนุญาตบัญชีของคุณก่อน

    Scan Tools ไม่พบเครื่องมือหรือเชื่อมต่อ endpoint ไม่ได้

    ตรวจสอบว่าใช้ URL แบบ HTTPS ครบถ้วน ไม่มีช่องว่าง และลงท้ายด้วย /functions/v1/vertexhr-mcp ตรวจสอบ Authentication ที่เลือก แล้วลอง Scan Tools หรือสร้าง custom app ใหม่

    เข้าสู่ระบบแล้วกลับมาหน้าเดิม หรือกดยกเลิกไป

    ปิดหน้าต่างที่ค้าง เริ่มการเชื่อมต่อใหม่ และลงชื่อเข้าใช้ด้วยบัญชี VertexHR ที่ยังใช้งานอยู่ หากไม่ต้องการอนุมัติ ให้กด Deny ได้อย่างปลอดภัย

    เชื่อมต่อแล้ว แต่บางคำถามไม่มีข้อมูล

    VertexHR ใช้บริษัทที่กำลัง Active บทบาท และ Permission ปัจจุบันของคุณ หากไม่มีสิทธิ์ดูโมดูลนั้น ระบบจะปฏิเสธหรือไม่แสดงข้อมูลตามปกติ

    สั่งให้เพิ่มหรือแก้ไขข้อมูลไม่ได้

    นี่คือพฤติกรรมที่ถูกต้องของ MCP Phase 1 ซึ่งรองรับเฉพาะการอ่านข้อมูล ระบบไม่สามารถแก้ไขพนักงาน เวลา การลา เงินเดือน ผู้ใช้ หรือสิทธิ์ได้

    ยังติดปัญหาอยู่?

    ต้องการความช่วยเหลือเพิ่มเติม

    ทีม VertexHR พร้อมช่วยตรวจสอบการเชื่อมต่อ

    แจ้งข้อความ Error ประเภทบัญชีหรือ Workspace ที่ใช้ และขั้นตอนที่พบปัญหา โดยไม่ส่งรหัสผ่าน Token หรือข้อมูลส่วนบุคคลของพนักงาน

    อัปเดตตาม VertexHR MCP Phase 1 · Read-only