ข้ามไปยังเนื้อหา
← กลับไป worktray.me

คู่มือตั้งค่า

เชื่อม 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” ให้ใช้วิธีนี้ การเข้าสู่ระบบและการอนุญาตเกิดขึ้นในเบราว์เซอร์ ไคลเอนต์ลงทะเบียนตัวเอง และไม่มีโทเคนให้ต้องเก็บไว้ที่ไหน

  1. เปิดหน้าตั้งค่า connector ของไคลเอนต์ ใน Claude Desktop คือ Settings → Connectors → Add custom connector

  2. วาง URL ของ Worktray MCP ด้านล่างลงในช่อง URL

  3. เว้นช่อง OAuth ทั้งสอง — client ID และ client secret — ให้ว่างไว้ ไคลเอนต์จะลงทะเบียนตัวเอง การกรอกสองช่องนี้คือสาเหตุที่พบบ่อยที่สุดที่ทำให้เชื่อมไม่สำเร็จ

  4. บันทึก เบราว์เซอร์จะเปิดหน้าเข้าสู่ระบบ Worktray และถามยืนยันการเชื่อมต่อ กดอนุญาต แล้วไคลเอนต์จะแสดงว่าเชื่อมต่อ Worktray แล้ว

MCP URL
https://www.worktray.me/api/mcp

ใช้ที่อยู่แบบมี www ตามที่เขียนไว้เป๊ะ ๆ โดเมนเปล่าจะ redirect และ redirect ทำให้การเชื่อมต่อ MCP ล้มตั้งแต่ยังไม่เริ่ม

ตรวจว่าใช้ได้จริง

ลองถามสิ่งที่ตอบได้เฉพาะจากบอร์ดของคุณ เช่น “มีงานอะไรเลยกำหนดบ้าง” ถ้าได้คำตอบที่ระบุชื่อการ์ดจริงของคุณ แปลว่าเชื่อมต่อสำเร็จแล้ว

Cursor, n8n, สคริปต์ — ไคลเอนต์ที่ส่งเฮดเดอร์เอง

ไคลเอนต์ที่ตั้งค่าผ่านไฟล์แทนการทำ OAuth จะยืนยันตัวตนด้วย personal access token ที่ส่งเป็น bearer header

  1. ไปที่ ตั้งค่า → การเชื่อมต่อ AI แล้วสร้างโทเคน ตั้งชื่อตามสิ่งที่จะเชื่อม จะได้รู้ว่ากำลังเพิกถอนอะไรในภายหลัง

  2. คัดลอกทันที เพราะจะแสดงให้เห็นครั้งเดียวเท่านั้น

  3. ใส่ URL และเฮดเดอร์ด้านล่างให้ไคลเอนต์ หรือวาง JSON ลงในไฟล์ตั้งค่า MCP ได้เลย

เฮดเดอร์
Authorization: Bearer wtr_…
ไฟล์ตั้งค่า MCP
{
  "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 ได้จากหน้าตั้งค่าของคุณ ใช้เวลาประมาณหนึ่งนาที