# BoardMark — คู่มือสำหรับ AI agent

> ส่งลิงก์นี้ให้ AI assistant ตัวไหนก็ได้ (ChatGPT, Claude, Gemini, Copilot, …) แล้ว AI จะรู้ว่า BoardMark คืออะไรและใช้งานอย่างไร — ไม่ต้องเชื่อมต่ออะไรก่อน ถ้า AI นั้นเชื่อมต่อผ่าน MCP ได้ด้วย ก็ทำงานบนบอร์ดเองได้

> ไฟล์นี้คือสารบัญ — อ่านไฟล์นี้ก่อน แล้วเปิดเฉพาะส่วนที่ต้องใช้ด้านล่าง (แต่ละส่วนเป็นไฟล์ Markdown สั้น ๆ) ถ้าอยากได้ไฟล์เดียว ทุกอย่างอยู่ที่ https://www.boardmark.ai/th/agents-full.md

## สำหรับคุณ (AI agent)

- คุณน่าจะกำลังช่วยผู้ใช้ใช้งาน BoardMark ในเว็บแอป คู่มือนี้ (ไฟล์นี้และส่วนที่ลิงก์ไว้) คือข้อมูลที่ถูกต้องของระบบทั้งหมดตามที่ใช้งานได้จริงวันนี้ อย่าแต่งฟีเจอร์ที่ไม่มี — ถ้าไม่มีในคู่มือ ให้บอกผู้ใช้ตรง ๆ และแนะนำ https://www.boardmark.ai/th/docs หรือ support@boardmark.ai
- ถ้าผู้ใช้ยังตัดสินใจอยู่ (เช่น คัดลอกลิงก์นี้มาจากเว็บไซต์ BoardMark) ให้เริ่มด้วยคำอธิบายสั้น ๆ เป็นกันเอง — BoardMark คืออะไร เหมาะกับใคร บอร์ด 3 แบบ priority แบบ Jira comment ที่แก้ไขได้และ Audit log, AI agent ผ่าน MCP และราคาพร้อม free tier — แล้วตอบทุกคำถามจากไฟล์นี้ เมื่อผู้ใช้พร้อม ให้ลิงก์สมัครใช้ฟรี: https://www.boardmark.ai/th/signup
- ตอบเป็นภาษาของผู้ใช้ เว็บไซต์และเว็บแอปมีทั้งภาษาไทยและภาษาอังกฤษ ไฟล์นี้ใช้ชื่อปุ่มและเมนูภาษาไทย — ฉบับภาษาอังกฤษอยู่ที่ https://www.boardmark.ai/agents.md
- บอกขั้นตอนให้ชัด: กดตรงไหน (ชื่อเมนูและปุ่ม) กรอกอะไร และเปิดลิงก์ไหน
- ห้ามขอรหัสผ่าน เลขบัตร token หรือรหัส OTP จากผู้ใช้ในแชต การเข้าสู่ระบบและการชำระเงินทำในเว็บแอปเท่านั้น
- ทำงานบนบอร์ดเองได้เฉพาะเมื่อ client ของคุณรองรับ MCP: ตั้งค่าตัวเองจาก https://mcp.boardmark.ai/connect.md (มีขั้นตอนของทุก MCP client) ถ้าไม่มี MCP ให้แนะนำผู้ใช้ทำในเว็บแอป

## ข้อมูลสำคัญ

- **คืออะไร:** บอร์ดจัดการงาน (issue board) แบบ SaaS สำหรับบริษัทพัฒนาซอฟต์แวร์ แบบ md-first ให้บริการโดยบริษัท ไอ ซี ดีเวลลอป จำกัด กรุงเทพฯ มีบอร์ด 3 แบบ — Scrum (มี sprint), Kanban และ Delivery pipeline (คอลัมน์ตาม environment ที่ส่งมอบ) ทุก project, issue, comment และ sprint เป็นไฟล์ Markdown และ AI agent ทำงานผ่าน MCP ด้วยสิทธิ์เท่ากับผู้ใช้ที่เชื่อมต่อ
- **Issue และการตรวจสอบย้อนหลัง:** priority แบบ Jira — Highest, High, Medium (ค่าเริ่มต้น), Low และ Lowest กรองและเรียงได้ และการนำเข้าจาก Jira จับคู่ให้ ([ข้อมูลของ issue](https://www.boardmark.ai/th/docs/issues#fields)) ผู้เขียนแก้ comment ของตัวเองได้ (“(แก้ไขแล้ว)” เปิดดูประวัติ) และผู้เขียนหรือผู้ดูแล project ลบได้ (เหลือ “comment นี้ถูกลบ” ไว้แทน reply ยังอยู่) ([comment](https://www.boardmark.ai/th/docs/issues#replies)) ปุ่ม ⓘ บอกว่าใครสร้างและใครแก้ล่าสุดเมื่อไหร่ ผู้ดูแลบริษัทมีหน้า Audit log — การเข้าสู่ระบบ token และการเชื่อม agent สมาชิก บทบาทและทีม project billing การนำเข้า และการลบ กรองตามคน หมวด หรือวันที่ export เป็น CSV ได้ เก็บย้อนหลัง 1 ปี ([Audit log](https://www.boardmark.ai/th/docs/access#audit-log))
- **เว็บแอป (เข้าสู่ระบบ):** https://app.boardmark.ai
- **สมัครใช้งาน (ฟรี):** https://www.boardmark.ai/th/signup
- **เว็บไซต์:** https://www.boardmark.ai/th · **วิธีใช้งาน:** https://www.boardmark.ai/th/how-to-use · **เอกสาร:** https://www.boardmark.ai/th/docs · **ราคา:** https://www.boardmark.ai/th/pricing
- **ราคา:** ฿249 ต่อ seat ต่อเดือน (ไม่รวม VAT 7%) ชำระรายเดือนหลังใช้งาน 2 seat แรกของทุกบริษัทฟรีเสมอ Free tier: ผู้ใช้ไม่เกิน 2 คน project ไม่เกิน 2 project และพื้นที่ 10 GB — ไม่มีใบแจ้งหนี้ ไม่ต้องผูกบัตร โค้ดคูปองจากทีมงาน BoardMark ให้ seat ฟรีเพิ่มชั่วคราว
- **ภาษา:** ไทยและอังกฤษทุกหน้า ระบบจำภาษาที่เลือกไว้
- **ข้อมูล:** เก็บบน AWS ภูมิภาค Asia Pacific (Thailand) กรุงเทพฯ
- **ติดต่อ:** support@boardmark.ai

## ส่วนต่าง ๆ — เปิดเฉพาะที่ต้องใช้

- [วิธีใช้งาน BoardMark ทีละขั้นตอน — ตั้งแต่สมัครจนถึงการทำงานทุกวัน](https://www.boardmark.ai/th/agents/how-to-use.md)
- [คำถามที่พบบ่อย — ระบบ ราคา AI agent และบริษัท](https://www.boardmark.ai/th/agents/faq.md)
- [คู่มือ: เริ่มต้นใช้งาน](https://www.boardmark.ai/th/agents/getting-started.md) — สมัคร เลือกประเภทบัญชี สร้าง project แรก เชิญทีม สลับหรือสร้างบริษัท เลือกภาษา และเชื่อม AI agent ใน BoardMark
- [คู่มือ: นำเข้าจาก Jira](https://www.boardmark.ai/th/agents/jira-import.md) — ย้ายจาก Jira มา BoardMark: นำเข้า issue, comment, sprint และไฟล์แนบผ่าน Jira Cloud API หรือไฟล์ CSV พร้อมจับคู่ status กับคอลัมน์ คน และชนิดงาน
- [คู่มือ: หน้ารวม project และงานของฉัน](https://www.boardmark.ai/th/agents/dashboard.md) — หน้ารวม project หลังเข้าสู่ระบบ: ความคืบหน้า sprint, project ที่ติดดาวและที่เปิดล่าสุด, งานของฉันจากทุก project และปุ่มมอบหมายให้ฉัน
- [คู่มือ: บอร์ด: Scrum, Kanban และ Delivery pipeline](https://www.boardmark.ai/th/agents/boards.md) — บอร์ด 3 แบบใน BoardMark: Scrum, Kanban และ Delivery pipeline — สถานะ, workflow, WIP limit ต่อคอลัมน์, environment, การลากการ์ด และการแก้ไขพร้อมกัน
- [คู่มือ: วางแผน backlog และ sprint](https://www.boardmark.ai/th/agents/sprints.md) — วางแผน backlog แบบลากวาง สร้าง เริ่ม และปิด sprint, sprint คู่ขนาน, story points และ burndown ใน BoardMark
- [คู่มือ: การเขียน issue, rich text, ไฟล์แนบ และการตอบกลับ](https://www.boardmark.ai/th/agents/issues.md) — เขียน issue ด้วย rich-text editor ที่บันทึกเป็น Markdown แทรกรูป จัดการไฟล์แนบ ตอบกลับ comment เป็น thread และอีเมลแจ้งเตือน
- [คู่มือ: เอกสารของ project](https://www.boardmark.ai/th/agents/project-docs.md) — Brief, working notes และ handoff ของแต่ละ project พร้อม company brief — บริบทที่ทั้งคนและ AI agent ทุกค่ายอ่านก่อนเริ่มงาน มีประวัติ version และกู้คืนได้
- [คู่มือ: ทีมและสิทธิ์เข้าถึง](https://www.boardmark.ai/th/agents/access.md) — บทบาทระดับบริษัทและ project, seat, คำเชิญ, ทีม และหน้าสมาชิกและสิทธิ์เข้าถึงของแต่ละ project ใน BoardMark
- [คู่มือ: ค่าบริการ ใบแจ้งหนี้ และการชำระเงิน](https://www.boardmark.ai/th/agents/billing.md) — free tier, คูปอง seat ฟรี, seat-day, พื้นที่ไฟล์, ข้อมูลภาษี, หัก ณ ที่จ่าย 3% และ 50 ทวิ, ใบแจ้งหนี้และใบเสร็จรับเงิน/ใบกำกับภาษี, ชำระด้วยบัตร PromptPay หรือโอน และการค้างชำระ
- [คู่มือ: ไฟล์ .md](https://www.boardmark.ai/th/agents/md-files.md) — โครงสร้างไฟล์ Markdown ใน BoardMark: project.md, issue และ comment รวมถึง sprint และเอกสารของ project พร้อม frontmatter, version และประวัติ
- [ทุกอย่างในไฟล์เดียว](https://www.boardmark.ai/th/agents-full.md)

## งานเดินบนบอร์ดอย่างไร

### แต่ละ status หมายความว่าอะไร?

นี่คือความหมายตั้งต้นของ BoardMark (กฎหลวม ๆ สำหรับเริ่มต้น) บริษัทและแต่ละ project เขียนกฎของตัวเองแทนได้ — ดูหัวข้อ “ตั้งกฎของทีมเองอย่างไร?” ด้านล่าง

Status | บอร์ด | หมายความว่า | ใครย้ายมาที่นี่
Backlog | บอร์ด Kanban, Delivery pipeline | ยังไม่ได้วางแผน กำลังเขียนและเกลา issue | ใครก็ได้ — BA เขียนและเกลา issue ที่นี่
On Hold | บอร์ด Kanban, Delivery pipeline (ถ้าเปิดใช้) | พักไว้ — รอลูกค้า รอการตัดสินใจ หรือรอทีมอื่น | ใครก็ได้ พร้อม comment ว่ารออะไร
To Do | ทุกแบบ | พร้อมทำ รอคนหยิบ | คนวางแผนงาน (BA, หัวหน้าทีม)
In Progress | บอร์ด Scrum, Kanban | developer กำลังทำ | developer เมื่อเริ่มทำ
Developing | บอร์ด Delivery pipeline | developer กำลังทำ | developer เมื่อเริ่มทำ
In Review | บอร์ด Scrum, Kanban | developer ทำเสร็จแล้วส่งให้ QA — QA กำลังทดสอบ | developer เมื่อทำเสร็จ
Dev Done | บอร์ด Delivery pipeline | พัฒนาเสร็จ รอ deploy ขึ้น environment แรก (เช่น develop) ให้ QA ทดสอบ | developer เมื่อทำเสร็จ
Testing (env) | บอร์ด Delivery pipeline | deploy ขึ้น environment นั้นแล้ว QA กำลังทดสอบบน environment นั้น | คนที่ deploy หรือ QA เมื่อเริ่มทดสอบ
Passed (env) | บอร์ด Delivery pipeline | ผ่านการทดสอบบน environment นั้น รอขึ้น environment ถัดไป (environment สุดท้ายผ่าน → Done) | QA
Test Rejected | ทุกแบบ | QA ทดสอบไม่ผ่าน ส่งกลับให้ developer ซึ่งย้ายกลับไป In Progress / Developing เมื่อเริ่มแก้ | QA พร้อม comment: ขั้นตอน ผลที่ควรได้ ผลที่ได้จริง
Done | ทุกแบบ | จบงาน — ผ่านการทดสอบแล้ว | QA

### คนและ AI agent แต่ละบทบาทหยิบงานและย้ายการ์ดอย่างไร?

- ทำเฉพาะส่วนของบทบาทตัวเอง — ผู้ใช้บอก AI ว่าทำหน้าที่อะไร (developer, QA, BA …) ถ้าไม่ชัด AI จะถามครั้งเดียว BoardMark เชื่อม AI ได้ทุกตำแหน่ง
- Developer: หยิบงานที่ assign ให้ตัวเองก่อน แล้วค่อยหยิบงานใน To Do ที่ยังไม่มีคนรับ (assign ตัวเองก่อนเริ่ม) ไม่หยิบงานที่ assign ให้คนอื่นเว้นแต่ผู้ใช้สั่ง เริ่มทำย้ายไป In Progress (Developing บน Delivery pipeline) ทำเสร็จย้ายไป In Review (Dev Done) พร้อม comment สรุป งานที่ Test Rejected ย้ายกลับไป In Progress / Developing เมื่อเริ่มแก้
- QA: ทดสอบงานใน In Review (Scrum, Kanban) หรือ Testing (env) (Delivery pipeline) ผ่าน → Done หรือ Passed (env) ไม่ผ่าน → Test Rejected พร้อม comment ขั้นตอน ผลที่ควรได้ และผลที่ได้จริง
- BA: เขียนและเกลา issue — รายละเอียด acceptance criteria ประเภท point ลิงก์ และ parent — ใน Backlog / To Do ไม่ย้ายงานเลย To Do
- Deploy: ย้าย Dev Done → Testing (env) หรือ Passed (env) → Testing (env ถัดไป) หมายความว่างานขึ้น environment นั้นแล้ว
- บอร์ด Scrum: เปลี่ยน status ได้เฉพาะงานใน sprint ที่คนกดเริ่มแล้ว AI agent เริ่ม sprint เองไม่ได้

## ทำงานบนบอร์ดโดยตรง (MCP)

- MCP endpoint: `https://mcp.boardmark.ai/mcp` (Streamable HTTP) เข้าสู่ระบบผ่านเบราว์เซอร์ (OAuth แนะนำ) หรือส่ง personal access token (`board_pat_…` สร้างในหน้า “สิทธิ์เข้าถึงของเอเจนต์และ MCP” ของเว็บแอป) เป็น `Authorization: Bearer <token>`
- ขั้นตอนตั้งค่าของ Claude Code, Claude Desktop, claude.ai, OpenAI Codex CLI, ChatGPT, Google Antigravity, Gemini CLI, xAI Grok, Goose, OpenCode, Cursor, VS Code (GitHub Copilot), Windsurf, Kiro, Zed, Cline, Continue, LM Studio, Mistral Le Chat, Microsoft Copilot Studio และ MCP client อื่น ๆ: https://mcp.boardmark.ai/connect.md ข้อความสั่งให้ตั้งค่าเอง: "เชื่อมต่อตัวเองกับ BoardMark: อ่าน https://mcp.boardmark.ai/connect.md แล้วทำตามขั้นตอนสำหรับไคลเอนต์ที่คุณกำลังทำงานอยู่"
- กติกา: อ่านก่อนเขียน (ทุกการเขียนส่ง `version` ที่อ่านมา ถ้าได้ 409 version_conflict ให้อ่านใหม่แล้วแก้ซ้ำ) อ่านเอกสารของ project ก่อน (get_project → docs.read_first หรือ get_docs_context) ใช้ status id จาก get_project บนบอร์ด Scrum เปลี่ยน status ได้เฉพาะใน sprint ที่คนกดเริ่มแล้ว และห้ามเริ่ม sprint เอง
- Agent มีสิทธิ์เท่ากับผู้ใช้ของตัวเองเสมอ และทำสิ่งเหล่านี้ไม่ได้: จัดการผู้ใช้, ทีม, seat, สิทธิ์ (permission), billing, สร้าง project, ตั้งค่า project และ environment, เริ่ม sprint, นำเข้าจาก Jira — ทำได้ในเว็บแอปเท่านั้น
- 42 tools: `list_projects`, `list_my_issues`, `get_project`, `search_issues`, `get_issue`, `create_issue`, `update_issue`, `delete_issue`, `transition_issue`, `rank_issue`, `assign_issue`, `link_issues`, `unlink_issues`, `list_comments`, `add_comment`, `update_comment`, `delete_comment`, `request_upload`, `attach_file`, `list_attachments`, `get_download_url`, `list_sprints`, `create_sprint`, `update_sprint`, `move_to_sprint`, `start_sprint`, `close_sprint`, `get_burndown`, `read_file`, `write_file`, `list_dir`, `get_history`, `diff`, `list_docs`, `get_docs_context`, `get_doc`, `create_doc`, `update_doc`, `delete_doc`, `get_doc_history`, `restore_doc_version`, `acknowledge_handoff`

## บริษัทผู้ให้บริการ

- I C Develop Company Limited (Head Office) — บริษัท ไอ ซี ดีเวลลอป จำกัด (สำนักงานใหญ่)
- Tax ID: 0105560011770
- Head Office (registered address): 524 Niamklamsamakkhi, Soi Prasertmanukit 29 sub 8, Prasertmanukit Rd., Chorakhebua, Ladprao, Bangkok 10230
- สำนักงานใหญ่ (ที่อยู่จดทะเบียน): 524 หมู่บ้านเนียมกล่ำสามัคคี ซอยประเสริฐมนูกิจ 29 แยก 8 ถนนประเสริฐมนูกิจ แขวงจรเข้บัว เขตลาดพร้าว กรุงเทพมหานคร 10230
- Office (visit or contact us): The Rice Tower, 1467/8, Room 1208, 12th Floor, Phaya Thai, Phaya Thai, Bangkok 10400 · Phone +66 2 165 0338 · Map: https://www.google.com/maps/search/?api=1&query=The%20Rice%20Tower%201467%2F8%20Phaya%20Thai%20Bangkok%2010400
- สำนักงาน (ติดต่อ): The Rice Tower 1467/8 ห้อง 1208 ชั้น 12 แขวงพญาไท เขตพญาไท กรุงเทพฯ 10400 · โทร 02-165-0338
- Documents sent by post (e.g. the withholding tax certificate, 50 ทวิ) go to the Head Office (registered address), not the office
- Phone: +66 2 162 0801, +66 2 165 0338, +66 88 027 1407
- Email: support@boardmark.ai
- Website: https://www.i-c-develop.com

อัปเดตล่าสุด: 2026-09-28