คู่มือตั้งค่า
เชื่อม AI เข้ากับบอร์ดของคุณ
Worktray เปิดบอร์ดให้เข้าถึงผ่าน MCP (Model Context Protocol) ซึ่งเป็นมาตรฐานที่ไคลเอนต์ AI ใช้เชื่อมต่อกับเครื่องมือภายนอก หน้านี้อธิบายวิธีเชื่อมต่อทั้งสองแบบ รายการเครื่องมือทุกตัวที่ AI ได้รับ และขอบเขตที่ระบุไว้ชัดเจน
จริง ๆ แล้วมันทำอะไร
เมื่อเชื่อมต่อแล้ว ไคลเอนต์ AI ของคุณจะอ่านบอร์ดที่คุณเปิดดูได้อยู่แล้ว และแก้ไขได้ในแบบเดียวกับที่คุณทำเองได้ เช่น สร้างการ์ด ย้ายการ์ด ตั้งกำหนดส่ง มอบหมายให้เพื่อนร่วมงาน ปิดการ์ด หรือคอมเมนต์ คำตอบมาจากเนื้อหาจริงบนบอร์ด ไม่ใช่จากสิ่งที่โมเดลเคยเรียนมา
การเชื่อมต่อนี้เป็นส่วนขยายของบัญชีคุณเอง ไม่ใช่บอตที่ถือกุญแจของตัวเอง ทุกคำขอถูกตรวจด้วย row-level security ใน Postgres ชุดเดียวกับที่เบราว์เซอร์ของคุณผ่าน AI จึงเปิดบอร์ดที่คุณเปิดไม่ได้ไม่ได้เช่นกัน และทุกการเปลี่ยนแปลงถูกบันทึกในประวัติของบอร์ดพร้อมชื่อคุณ ควบคู่กับชื่อไคลเอนต์ที่เป็นคนสั่ง
ก่อนเริ่ม
คุณต้องมีบัญชี Worktray ทุกอย่างด้านล่างทำได้ในหน้าตั้งค่าของคุณเอง ไม่ต้องให้ผู้ดูแลระบบเปิดให้ และไม่ต้องซื้อแพ็กเกจเพิ่ม
เลือกพื้นที่ทำงานที่ AI จะทำงานอยู่
การเชื่อมต่อ AI ทำงานในพื้นที่เดียวต่อครั้ง จะเป็นองค์กรใดองค์กรหนึ่งของคุณ หรือพื้นที่ส่วนตัวของคุณก็ได้ เปิด ตั้งค่า → การเชื่อมต่อ AI แล้วเลือกที่ต้องการ ถ้าคุณทำงานอยู่ที่เดียวอยู่แล้ว ค่าเริ่มต้นก็ถูกต้องอยู่แล้ว
เปิดหน้าตั้งค่าการเชื่อมต่อ AI
personal access token จะล็อกพื้นที่ทำงานไว้ตั้งแต่ตอนสร้าง ถ้าต้องการทำงานในองค์กรที่สอง ให้สร้างโทเคนใบที่สอง ส่วน connector จะอิงตามที่เลือกไว้ในหน้านี้ เปลี่ยนที่นั่นแล้วสิ่งที่ AI เห็นก็เปลี่ยนตาม
Claude, ChatGPT และไคลเอนต์ที่รองรับ connector
ถ้าไคลเอนต์ของคุณมีปุ่ม “Add custom connector” ให้ใช้วิธีนี้ การเข้าสู่ระบบและการอนุญาตเกิดขึ้นในเบราว์เซอร์ ไคลเอนต์ลงทะเบียนตัวเอง และไม่มีโทเคนให้ต้องเก็บไว้ที่ไหน
เปิดหน้าตั้งค่า connector ของไคลเอนต์ ใน Claude Desktop คือ Settings → Connectors → Add custom connector
วาง URL ของ Worktray MCP ด้านล่างลงในช่อง URL
เว้นช่อง OAuth ทั้งสอง — client ID และ client secret — ให้ว่างไว้ ไคลเอนต์จะลงทะเบียนตัวเอง การกรอกสองช่องนี้คือสาเหตุที่พบบ่อยที่สุดที่ทำให้เชื่อมไม่สำเร็จ
บันทึก เบราว์เซอร์จะเปิดหน้าเข้าสู่ระบบ Worktray และถามยืนยันการเชื่อมต่อ กดอนุญาต แล้วไคลเอนต์จะแสดงว่าเชื่อมต่อ Worktray แล้ว
https://www.worktray.me/api/mcpใช้ที่อยู่แบบมี www ตามที่เขียนไว้เป๊ะ ๆ โดเมนเปล่าจะ redirect และ redirect ทำให้การเชื่อมต่อ MCP ล้มตั้งแต่ยังไม่เริ่ม
ตรวจว่าใช้ได้จริง
ลองถามสิ่งที่ตอบได้เฉพาะจากบอร์ดของคุณ เช่น “มีงานอะไรเลยกำหนดบ้าง” ถ้าได้คำตอบที่ระบุชื่อการ์ดจริงของคุณ แปลว่าเชื่อมต่อสำเร็จแล้ว
Cursor, n8n, สคริปต์ — ไคลเอนต์ที่ส่งเฮดเดอร์เอง
ไคลเอนต์ที่ตั้งค่าผ่านไฟล์แทนการทำ OAuth จะยืนยันตัวตนด้วย personal access token ที่ส่งเป็น bearer header
ไปที่ ตั้งค่า → การเชื่อมต่อ AI แล้วสร้างโทเคน ตั้งชื่อตามสิ่งที่จะเชื่อม จะได้รู้ว่ากำลังเพิกถอนอะไรในภายหลัง
คัดลอกทันที เพราะจะแสดงให้เห็นครั้งเดียวเท่านั้น
ใส่ URL และเฮดเดอร์ด้านล่างให้ไคลเอนต์ หรือวาง JSON ลงในไฟล์ตั้งค่า MCP ได้เลย
Authorization: Bearer wtr_…{
"mcpServers": {
"worktray": {
"url": "https://www.worktray.me/api/mcp",
"headers": {
"Authorization": "Bearer wtr_your_token_here"
}
}
}
}เปลี่ยนโทเคนเป็นของคุณเอง และเก็บไฟล์นี้เหมือนไฟล์รหัสผ่าน
ทดสอบด้วยมือ
MCP Inspector เป็นวิธีที่เร็วที่สุดในการดูรายการเครื่องมือและลองเรียกใช้โดยตรง รันขึ้นมา ชี้ไปที่ URL ด้านบน แล้วใส่เฮดเดอร์ Authorization เดียวกัน
npx @modelcontextprotocol/inspectorเพิกถอนโทเคนได้ทุกเมื่อจากหน้าตั้งค่าเดียวกัน ไคลเอนต์จะใช้ไม่ได้ตั้งแต่การเรียกครั้งถัดไป และโทเคนมีวันหมดอายุกำกับอยู่ด้วย
AI ทำอะไรได้บ้าง
มี 23 เครื่องมือ และไม่มีมากกว่านั้น สิบตัวทางซ้ายอ่านอย่างเดียว สิบสามตัวทางขวาเขียนได้ ไม่มีเครื่องมือสำหรับลบการ์ด บอร์ด หรือลูกค้า ไม่มีสำหรับเปลี่ยนสิทธิ์การเข้าถึงบอร์ด และไม่มีสำหรับทำงานด้วยสิทธิ์ผู้ดูแลระบบ ทั้งหมดนี้ไม่อยู่ในรายการโดยตั้งใจ จะได้ไม่มีสวิตช์ให้เผลอเปิดค้างไว้
อ่าน
- whats_pending
- งานค้างของคุณจากทุกบอร์ด จัดกลุ่มตามความเร่งด่วน ปกติเป็นเครื่องมือแรกที่ AI เรียก
- list_boards
- บอร์ดทั้งหมดที่คุณเห็น พร้อมรายการคอลัมน์
- search_cards
- ค้นการ์ดที่ระบุชื่อ ด้วยข้อความ บอร์ด ผู้รับผิดชอบ กำหนดส่ง หรือจำนวนวันที่เลยกำหนด
- get_card
- การ์ดหนึ่งใบแบบเต็ม ทั้งรายละเอียด งานย่อย เพื่อนร่วมงาน งบประมาณ ลิงก์ และไฟล์แนบ
- get_card_activity
- ประวัติการแก้ไขของการ์ดหนึ่งใบ ว่าใครแก้อะไร เมื่อไหร่
- get_board_snapshot
- จำนวนการ์ดและจำนวนที่เลยกำหนดรายคอลัมน์ของบอร์ด เป็นภาพรวมมากกว่าตัวเนื้อหา
- get_budget
- งบประมาณประเมินรวม (บาท) ของการ์ดที่ยังเปิดอยู่ ตลอดทั้งช่วง พร้อมรายละเอียดรายการ์ด
- list_people
- ใครอยู่บนบอร์ดบ้าง พร้อมรหัสที่ต้องใช้ในการมอบหมายงาน
- list_customers
- รายชื่อลูกค้าทั้งหมด พร้อมรหัสที่ต้องใช้กับเครื่องมืออื่น ๆ เกี่ยวกับลูกค้ารายนั้น
- get_customer
- ลูกค้าหนึ่งรายแบบเต็ม พร้อมผู้ติดต่อของลูกค้ารายนั้น
เขียน
- create_card
- เพิ่มการ์ดลงบอร์ด พร้อมชื่อ รายละเอียด วันที่ และระดับความสำคัญ
- update_card
- แก้ไขฟิลด์ของการ์ดที่มีอยู่ แตะเฉพาะฟิลด์ที่ส่งเข้าไปเท่านั้น
- set_due
- ตั้งหรือล้างกำหนดส่งของการ์ด
- move_card
- ย้ายการ์ดไปคอลัมน์อื่นในบอร์ดเดียวกัน ซึ่งคือวิธีเปลี่ยนสถานะของการ์ด
- assign_task
- เพิ่มเพื่อนร่วมงานเข้าการ์ด หรือกำหนดให้เป็นเจ้าของงานย่อยหนึ่งรายการ
- add_subtasks
- เพิ่มรายการงานย่อย แต่ละรายการมีเจ้าของและกำหนดส่งของตัวเอง
- close_card
- ปิดการ์ดเป็นเสร็จแล้ว เก็บเข้าคลัง หรือยกเลิก เป็นวิธีเดียวที่จะเอาการ์ดออกจากบอร์ด และการ์ดยังอ่านได้อยู่
- add_comment
- โพสต์ในแชตของการ์ดในนามคุณ ถ้าการ์ดเชื่อมกับกลุ่ม LINE ไว้ ข้อความจะถูกส่งไปที่นั่นด้วย
- create_customer
- เพิ่มลูกค้าลงในรายชื่อ ใช้ได้ตั้งแต่แพ็กเกจ Standard ขึ้นไป
- update_customer
- แก้ไขฟิลด์ของลูกค้าที่มีอยู่ แตะเฉพาะฟิลด์ที่ส่งเข้าไปเท่านั้น
- add_contact
- เพิ่มผู้ติดต่อให้กับลูกค้ารายหนึ่ง
- update_contact
- แก้ไขฟิลด์ของผู้ติดต่อที่มีอยู่
- set_card_customer
- เชื่อมการ์ดกับลูกค้าและผู้ติดต่อของลูกค้า หรือยกเลิกการเชื่อม
วันที่ทั้งอ่านและเขียนอิงเขตเวลา Asia/Bangkok การเปิดการ์ดที่ปิดไปแล้วกลับมาต้องทำในแอป ไม่สามารถทำจากที่นี่ ไม่มีเครื่องมือสำหรับเก็บเข้าคลังหรือลบลูกค้า
ขอบเขตและความปลอดภัย
- เข้าถึงได้เท่าที่คุณเข้าถึงได้
- ทั้งสองวิธียืนยันตัวตนล้วนชี้กลับมาที่ตัวคุณเอง และทุกคำสั่งค้นทำงานภายใต้ row-level security ใน Postgres ซึ่งบังคับที่ฐานข้อมูล ไม่ใช่ที่หน้าจอ บั๊กในเครื่องมือตัวใดตัวหนึ่งจึงขยายสิทธิ์ไม่ได้
- ไม่มีคำสั่งทำลายให้ใช้
- ไม่มีเครื่องมือลบ ไม่มีเครื่องมือเปลี่ยนสิทธิ์ และไม่มีการจัดการบอร์ดหรือคอลัมน์ สิ่งที่แรงที่สุดที่ AI ทำได้คือปิดการ์ด ซึ่งการ์ดที่ปิดแล้วก็ยังอ่านได้
- ไม่เคยพกสิทธิ์ผู้ดูแลระบบไปด้วย
- ผู้ดูแลระบบของอินสแตนซ์อ่านได้ทุกบอร์ดรวมถึงบอร์ดส่วนตัว สิทธิ์นั้นถูกตั้งใจไม่ให้ติดไปกับการเชื่อมต่อ AI ถึงข้อมูลรับรองหลุด ก็ยังเข้าถึงได้แค่งานของคนคนเดียว
- หนึ่งข้อมูลรับรอง ต่อหนึ่งพื้นที่ทำงาน
- โทเคนผูกกับพื้นที่ทำงานที่สร้างมันขึ้นมา ส่วน connector อิงตามที่เลือกไว้ในหน้าตั้งค่า ทั้งคู่ข้ามไปองค์กรอื่นไม่ได้ และข้อมูลรับรองขององค์กรก็เปิดพื้นที่ส่วนตัวของคุณไม่ได้
- ทุกอย่างถูกบันทึกไว้
- การเรียกเครื่องมือทุกครั้งถูกบันทึกไว้ตรวจสอบย้อนหลัง และทุกการเปลี่ยนแปลงลงในประวัติของบอร์ดพร้อมชื่อคุณและชื่อไคลเอนต์ นอกจากนี้ยังมีการจำกัดอัตราการเรียก ไคลเอนต์ที่วนลูปค้างจึงถูกหยุด ไม่ปล่อยให้รันต่อ
ถ้าเชื่อมต่อไม่ได้
- ไคลเอนต์ไม่รับ URL หรือเชื่อมค้างไม่สำเร็จ
- ตรวจว่ามี www หรือยัง โดเมนเปล่าจะ redirect และไคลเอนต์ MCP ไม่ตาม redirect
- เข้าสู่ระบบวนซ้ำ หรือขึ้น 401 โดยไม่บอกสาเหตุ
- ตรวจว่าเว้นช่อง OAuth ทั้งสองไว้ว่างแล้วหรือยัง การพิมพ์ client ID หรือ secret เองจะทำให้ไคลเอนต์ลงทะเบียนตัวเองไม่ได้
- เชื่อมต่อได้แต่ไม่เห็นบอร์ด
- น่าจะกำลังทำงานอยู่ผิดพื้นที่ ลองตรวจตัวเลือกที่ ตั้งค่า → การเชื่อมต่อ AI หรือดูว่าโทเคนถูกสร้างในองค์กรไหน
- เคยใช้ได้แล้วอยู่ ๆ ใช้ไม่ได้
- ตรวจว่าโทเคนถูกเพิกถอนหรือหมดอายุแล้วหรือยัง ทั้งสองอย่างแสดงอยู่ในหน้าตั้งค่า
พร้อมเชื่อมต่อแล้วหรือยัง
สร้างโทเคนหรือตั้งค่า connector ได้จากหน้าตั้งค่าของคุณ ใช้เวลาประมาณหนึ่งนาที