AI agent · MCP

เชื่อม AI agent กับ BoardMark อย่างไร?

เพิ่ม BoardMark เป็น MCP server แล้วเข้าสู่ระบบผ่านเบราว์เซอร์ — ไม่ต้องคัดลอก token หรือใช้ personal access token สำหรับ CI และเครื่องที่ไม่มีเบราว์เซอร์ agent ทำงานด้วยสิทธิ์เท่าคุณ — เห็นเฉพาะ project ที่คุณเห็น และไม่มีวันได้สิทธิ์ admin

สิทธิ์เท่าผู้ใช้ ไม่เคยได้สิทธิ์ admin

เพิ่ม BoardMark เป็น MCP server
ใน Claude Code รันคำสั่งนี้ (Streamable HTTP) ไม่ต้องใส่ token:
Claude Code
```
claude mcp add --transport http boardmark https://mcp.boardmark.ai/mcp
```
เข้าสู่ระบบและเลือกบริษัท
Claude Code เปิดเบราว์เซอร์ให้คุณเข้าสู่ระบบ BoardMark แล้วเลือกบริษัทที่จะให้ agent ใช้ (ถ้าเบราว์เซอร์ไม่เปิดเอง ให้รัน /mcp ใน Claude Code แล้วเลือก server นี้เพื่อเข้าสู่ระบบ) สิทธิ์นี้ใช้ได้กับบริษัทเดียว
ดูและยกเลิกได้ทุกเมื่อ
แอปที่เข้าสู่ระบบไว้แสดงในหน้า “สิทธิ์เข้าถึงของเอเจนต์และ MCP” ของเว็บแอป กดออกจากระบบแล้วแอปนั้นเสียสิทธิ์ทันที
เปิดเว็บแอป

วิธีที่ 2 · personal access token (สำหรับ CI)

สร้าง token ในแอป
ในหน้า “สิทธิ์เข้าถึงของเอเจนต์และ MCP” สร้างโทเคนใหม่ ตั้งชื่อ และเลือกอายุ 30, 90, 180 หรือ 365 วัน token ขึ้นต้นด้วย board_pat_ และแสดงเพียงครั้งเดียว — เก็บไว้ในที่ปลอดภัย เพิกถอนได้ทุกเมื่อ
เก็บ token ไว้ในตัวแปรสภาพแวดล้อม
อย่าใส่ token ลงในไฟล์ที่ commit เข้า git
shell
```
export BOARD_PAT="board_pat_…"
```

เพิ่ม MCP server พร้อม header

สำหรับ Claude Code:

Claude Code

claude mcp add --transport http boardmark https://mcp.boardmark.ai/mcp --header "Authorization: Bearer $BOARD_PAT"

หรือใส่ใน .mcp.json ของ project (Claude Code ขยาย ${BOARD_PAT} จากตัวแปรสภาพแวดล้อมให้):

.mcp.json

{
  "mcpServers": {
    "boardmark": {
      "type": "http",
      "url": "https://mcp.boardmark.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${BOARD_PAT}"
      }
    }
  }
}

Agent ต้องทำงานตามกติกาอะไร?

ต้องส่ง version ทุกครั้งที่เขียน — เรียก get_issue ก่อน update_issue เสมอ ถ้ามีคนแก้ก่อนจะได้ 409 version_conflict แทนการเขียนทับ
รู้จักบอร์ดทั้ง 3 แบบ — Scrum มี sprint (อาจทำงานพร้อมกันหลาย sprint), Kanban และ Delivery pipeline ไม่มี sprint และ status ของ pipeline เป็นไปตาม environment ใน project.md
ทุก write ถูกบันทึก — commit ของงานที่มาจาก MCP ระบุ agent token ที่ใช้ ในแอปการ์ด comment และไฟล์แนบจาก agent มีป้ายกำกับ
จำกัด 600 requests/นาที ต่อ token — ค่าเริ่มต้น
Agent ไม่นับเป็น seat — ใช้สิทธิ์ของผู้ใช้ที่เชื่อมต่อ ไม่มีค่าใช้จ่ายเพิ่ม

มี tool อะไรบ้าง? (31 tools)

ทุก tool map 1:1 กับ public API และตรวจสิทธิ์เหมือนหน้าเว็บ

Project และงานของฉัน

Tool	ทำอะไร
`list_projects`	project ที่คุณเข้าถึงได้ พร้อมภาพรวม (issue ที่เปิดอยู่ sprint ที่กำลังทำงานและความคืบหน้า) ในครั้งเดียว
`list_my_issues`	issue ที่มอบหมายให้คุณจากทุก project ในครั้งเดียว
`get_project`	project.md: ประเภทบอร์ด สถานะ workflow environment และบทบาทของคุณ

Issue

Tool	ทำอะไร
`search_issues`	ค้นหาตาม status, assignee, sprint, type, label, ข้อความ, parent (แบ่งหน้า)
`get_issue`	อ่าน issue พร้อม version ล่าสุด
`create_issue`	สร้าง issue ใหม่ (1 issue = 1 ไฟล์ .md)
`update_issue`	แก้หลาย field ในครั้งเดียว — ต้องส่ง version
`delete_issue`	ลบ issue — ต้องส่ง version
`transition_issue`	เปลี่ยน status ตาม workflow (รวมสถานะของแต่ละ environment บนบอร์ด Delivery pipeline)
`rank_issue`	จัดลำดับ issue (วางก่อน/หลัง issue อื่น)
`assign_issue`	มอบหมายผู้รับผิดชอบ
`link_issues`	เชื่อม issue (blocks, relates, duplicates, clones)
`unlink_issues`	ยกเลิกการเชื่อม issue

Comment และไฟล์แนบ

Tool	ทำอะไร
`list_comments`	comment ของ issue พร้อมการตอบกลับเป็น thread
`add_comment`	เพิ่ม comment (Markdown) หรือตอบกลับ comment เดิม
`request_upload`	ขอ presigned URL สำหรับอัปโหลด
`attach_file`	แนบไฟล์ที่อัปโหลดแล้วเข้ากับ issue
`list_attachments`	ไฟล์แนบของ issue: ชื่อ ขนาด วันที่ และผู้อัปโหลด
`get_download_url`	presigned URL สำหรับดาวน์โหลดไฟล์แนบ

Sprint

Tool	ทำอะไร
`list_sprints`	sprint ของ project (อาจมีหลาย sprint ที่กำลังทำงาน)
`create_sprint*`	สร้าง sprint
`update_sprint*`	แก้ชื่อ วันที่ หรือเป้าหมายของ sprint
`move_to_sprint`	ย้าย issue เข้า/ออก sprint
`start_sprint*`	เริ่ม sprint
`close_sprint*`	ปิด sprint และย้ายงานที่ค้าง
`get_burndown`	burndown ของ sprint (Scrum)

ไฟล์ .md โดยตรง

Tool	ทำอะไร
`read_file`	อ่านไฟล์ .md
`write_file`	เขียนไฟล์ .md ผ่าน validator เดียวกับ UI
`list_dir`	รายการไฟล์ใน md tree
`get_history`	ประวัติ commit: ใครแก้ และผ่าน agent token ใด
`diff`	เปรียบเทียบสองเวอร์ชัน

MCP resources

board://{project_key}/project.md
board://{project_key}/issues/{key}

* ต้องเป็น project_admin

Agent ทำอะไรไม่ได้?

MCP ไม่มี tool สำหรับงาน admin หรือ billing เลย เรื่องเหล่านี้ทำได้เฉพาะในเว็บแอปตามบทบาทของคุณ:

จัดการผู้ใช้ทีมseatสิทธิ์ (permission)billingสร้าง projectตั้งค่า project และ environment

คำถามเรื่อง MCP