ควบคุมบอร์ดจาก API หรือจากผู้ช่วย AI

บอร์ดสามารถควบคุมได้อย่างสมบูรณ์จากภายนอกแดชบอร์ด สองเส้นทาง โมเดลสิทธิ์เดียว และการทำงานแบบเดียวกับบนหน้าจอ — เพราะเรียกใช้โค้ดชุดเดียวกัน

The REST API

ทุกการดำเนินการอยู่ในข้อกำหนด OpenAPI สาธารณะของเรา พร้อมไคลเอ็นต์ที่สร้างขึ้นสำหรับ TypeScript, Python, PHP และ Go อีกทั้ง CLI ก็สร้างมาจากข้อกำหนดเดียวกันนี้ ทั้งบอร์ด คอลัมน์ การ์ด ความคิดเห็น คำถาม เลเบล สมาชิก และลิงก์สำหรับแชร์ ได้รับการครอบคลุมทั้งหมด

เอนด์พอยต์ที่คุณจะได้ใช้งานบ่อยที่สุด:

• GET /v1/agency/boards — บอร์ดของคุณ
• GET /v1/agency/boards/{id} — บอร์ดหนึ่งรายการพร้อมคอลัมน์และการ์ดที่เกี่ยวข้อง
• POST /v1/agency/boards/{id}/cards — เพิ่มงาน
• POST /v1/agency/boards/{id}/cards/{id}/move — ย้ายงาน
• POST /v1/agency/boards/{id}/invites — สร้างลิงก์สำหรับแชร์

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

เซิร์ฟเวอร์ MCP

หากคุณใช้ผู้ช่วย AI ที่รองรับ MCP ให้เชื่อมต่อผู้ช่วยดังกล่าว แล้วผู้ช่วยจะได้รับเครื่องมือจัดการบอร์ดโดยตรง: แสดงรายการบอร์ด อ่านข้อมูลบอร์ดแบบเต็ม สร้างบอร์ด เพิ่มการ์ด ย้ายการ์ด แสดงความคิดเห็น สร้างลิงก์สำหรับแชร์ และเพิกถอนลิงก์ ซึ่งจะเปลี่ยนคำสั่งอย่าง "สรุปข้อมูลสัปดาห์นี้แล้วส่งลิงก์ให้ Acme" ให้กลายเป็นคำสั่งเดียว แทนที่จะต้องสลับใช้งานระหว่างสองระบบพร้อมทั้งคัดลอกและวาง

สองสิ่งที่คุณควรทราบเกี่ยวกับเครื่องมือเหล่านี้:

• การ์ดใหม่จะเป็นการ์ดภายในเสมอเว้นแต่คุณจะระบุเป็นอย่างอื่น ผู้ช่วยที่ทำหน้าที่สรุปงานภายในของคุณจะต้องไม่เผยแพร่บทสรุปดังกล่าวไปยังลูกค้าของคุณเพียงเพราะไม่มีใครสั่งห้าม ดังนั้นค่า visibility จึงมีค่าเริ่มต้นเป็นแบบภายใน และต้องได้รับการตั้งค่าเป็น client โดยเจตนา
• การเพิกถอนลิงก์จะถามเพื่อยืนยันเสมอ เนื่องจากจะเป็นการนำทุกคนที่เข้าร่วมผ่านลิงก์นั้นออกด้วย — และเครื่องมือจะแจ้งให้คุณทราบว่ามีผู้ใช้จำนวนกี่คนที่ได้รับผลกระทบ แทนที่จะรายงานเพียงผลสำเร็จเรียบร้อยเท่านั้น

สิ่งที่จำเป็นต้องมี

สิทธิ์เข้าถึง API และ MCP รวมอยู่ใน Boards Business และใน ทุกแพ็กเกจโฮสติ้งของ Agency บนแพ็กเกจ Boards Free และ Boards Pro นั้น เอนด์พอยต์ของบอร์ดจะตอบกลับด้วยข้อความที่แจ้งให้ทราบถึงเงื่อนไขนี้

คีย์ API หรือการเชื่อมต่อ MCP สามารถทำได้เฉพาะสิ่งที่บุคคลผู้สร้างสามารถทำได้ ภายในองค์กรที่บุคคลดังกล่าวมีสิทธิ์เท่านั้น ลิงก์สำหรับแชร์ที่ผู้ช่วยสร้างขึ้นจะถูกจำกัดขอบเขตในลักษณะเดียวกัน: ไม่สามารถให้สิทธิ์ในบทบาทที่บุคคลผู้อนุมัติไม่ได้ถือครองอยู่เองได้