AgileHero

npx add-mcp 'https://mcp.agilehero.io/mcp'

AgileHero đi kèm một máy chủ MCP tích hợp sẵn: chỉ cần thêm một URL vào bất kỳ trợ lý AI nào hỗ trợ MCP, đăng nhập bằng tài khoản AgileHero của bạn, và nó sẽ làm việc với các dự án của bạn với đúng quyền hạn của bạn — 49 công cụ trên các bảng, backlog, epic, wiki, bảng trắng, hồi kết (retrospective) và lộ trình. Tài liệu tham khảo này được tạo ra từ chính máy chủ, vì vậy nó luôn được cập nhật.

Mới bắt đầu? Hãy xem tổng quan về AI agents, hoặc đi thẳng đến kết nối máy khách của bạn bên dưới. Văn bản rich text ở mọi nơi trên máy chủ này là AgileHero Markup (AHM) — một phương ngữ XML nghiêm ngặt, được xác thực, được thiết kế để các agent không bao giờ làm hỏng nội dung của con người. Bạn muốn viết script thay vì kết nối trợ lý? Tài liệu tham khảo REST API sử dụng cùng phương thức đăng nhập OAuth.

Kết nối máy khách AI của bạn

Kết nối bao gồm hai việc: thêm URL điểm cuối vào máy khách của bạn, sau đó đăng nhập bằng tài khoản AgileHero khi máy khách yêu cầu. Không có khóa nào để tạo hoặc dán. Sau khi kết nối, máy khách hoạt động với tư cách là bạn, với đúng quyền hạn của bạn; mọi máy khách đã kết nối đều được liệt kê trong Cài đặt → AI clients trong ứng dụng, nơi bạn có thể thu hồi quyền truy cập bất kỳ lúc nào. Người quan sát không thể sử dụng máy chủ MCP: một không gian làm việc nơi bạn là người quan sát sẽ không được liệt kê, và mọi thứ trong đó sẽ được đọc là không tìm thấy.

Điểm cuối

https://mcp.agilehero.io/mcp

Giao thức vận chuyển

Streamable HTTP (POST)

Đăng nhập

Máy khách AI của bạn mở một cửa sổ trình duyệt; phê duyệt một lần, thu hồi bất kỳ lúc nào trong Cài đặt → AI clients.

Claude Code

Chạy một lần trong terminal; Claude Code lưu trữ máy chủ trong cấu hình cấp người dùng của bạn và đăng nhập qua trình duyệt của bạn.

claude mcp add --transport http --scope user agilehero https://mcp.agilehero.io/mcp

• Tất cả các cờ phải đứng trước tên máy chủ.
• Sau đó chạy /mcp trong một phiên Claude Code và chọn Authenticate (hoặc chạy claude mcp login agilehero) và phê duyệt đăng nhập trong trình duyệt của bạn.

Xác minh: Chạy claude mcp list — agilehero sẽ hiển thị là đã kết nối. Nếu nó hiển thị "needs authentication", hãy chạy claude mcp login agilehero.

Tài liệu Claude Code · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

VS Code (GitHub Copilot)

Thêm vào .vscode/mcp.json trong một workspace, hoặc chạy "MCP: Open User Configuration" cho tất cả các workspace. Một cửa sổ trình duyệt sẽ mở ra để đăng nhập lần đầu tiên máy chủ khởi động.

.vscode/mcp.json

{
  "servers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• "type": "http" là bắt buộc — nếu không có nó, VS Code sẽ coi URL như một lệnh để chạy.

Xác minh: Chạy "MCP: List Servers", khởi động agilehero, hoàn tất đăng nhập trong trình duyệt, và kiểm tra xem các công cụ của nó có xuất hiện trong chế độ xem Chat hay không.

Tài liệu VS Code (GitHub Copilot) · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

Codex

Thêm từ terminal, sau đó đăng nhập — cấu hình được chia sẻ bởi Codex CLI, tiện ích mở rộng IDE và ứng dụng desktop ChatGPT.

codex mcp add agilehero --url https://mcp.agilehero.io/mcp
codex mcp login agilehero

• Codex không tự động bắt đầu đăng nhập — hãy chạy codex mcp login agilehero sau khi thêm máy chủ.

Xác minh: Chạy codex mcp list — agilehero sẽ hiển thị là đã xác thực; sau đó yêu cầu Codex liệt kê các dự án AgileHero của bạn.

Tài liệu Codex · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

Zed

Thêm vào settings.json, hoặc sử dụng Cài đặt → AI → MCP Servers → Add Remote Server; Zed sẽ nhắc bạn đăng nhập.

~/.config/zed/settings.json

{
  "context_servers": {
    "agilehero": {
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• Bỏ trống phần headers — Zed chỉ bắt đầu đăng nhập khi không có tiêu đề Authorization nào được cấu hình.

Xác minh: Khởi động lại Zed, phê duyệt đăng nhập trong trình duyệt khi được yêu cầu, và yêu cầu nó liệt kê các dự án AgileHero của bạn — lệnh gọi thành công đầu tiên xác nhận kết nối.

Tài liệu Zed · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

GitHub Copilot CLI

Thêm vào ~/.copilot/mcp-config.json, hoặc .mcp.json bên trong một kho lưu trữ.

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• Cần GitHub Copilot CLI 1.0.83 trở lên (hỗ trợ Client ID Metadata Document).
• Copilot CLI mở đăng nhập khi máy chủ lần đầu yêu cầu; bạn cũng có thể chạy /mcp auth agilehero trong một phiên.

Xác minh: Chạy /mcp trong Copilot CLI — agilehero sẽ được liệt kê là đã kết nối với các công cụ của nó.

Tài liệu GitHub Copilot CLI · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

Claude (web, desktop, Cowork)

Thêm AgileHero như một trình kết nối tùy chỉnh và đăng nhập; trình kết nối có sẵn trên Claude web, Claude Desktop, Cowork và các ứng dụng di động.

Settings → Connectors → Add custom connector
Name: AgileHero
URL: https://mcp.agilehero.io/mcp
Sign in now

• Trình kết nối cũng xuất hiện trong Claude Code khi nó được đăng nhập bằng cùng tài khoản Claude.
• Gói miễn phí: một trình kết nối tùy chỉnh. Team và Enterprise: Chủ sở hữu thêm trình kết nối, và mỗi thành viên đăng nhập bằng tài khoản AgileHero của riêng họ.

Xác minh: Bắt đầu một cuộc trò chuyện mới — AgileHero được liệt kê trong các trình kết nối, và việc yêu cầu Claude liệt kê các dự án AgileHero của bạn hoạt động.

Tài liệu Claude (web, desktop, Cowork) · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

ChatGPT

Tạo một trình kết nối trong chế độ Developer và đăng nhập bằng OAuth.

Settings → Connectors → Create (Developer mode)
Name: AgileHero
MCP server URL: https://mcp.agilehero.io/mcp
Authentication: OAuth

• Có sẵn trên Plus, Pro, Business, Enterprise và Edu với chế độ Developer được bật; trong một workspace, quản trị viên hoặc chủ sở hữu xuất bản trình kết nối cho các thành viên.

Xác minh: Mở một cuộc trò chuyện mới với trình kết nối AgileHero được bật và yêu cầu ChatGPT liệt kê các dự án AgileHero của bạn.

Tài liệu ChatGPT · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

Máy khách khác

Bất kỳ máy khách MCP nào hỗ trợ OAuth với Client ID Metadata Documents: thêm điểm cuối như một máy chủ từ xa (Streamable HTTP) và phê duyệt đăng nhập trong trình duyệt của bạn.

Transport: Streamable HTTP
URL: https://mcp.agilehero.io/mcp
Authentication: OAuth (sign in when the client asks)

• Các máy khách chỉ hỗ trợ token tĩnh hoặc headers không thể kết nối — AgileHero chỉ sử dụng đăng nhập OAuth.

Xác minh: Khởi động lại máy khách, phê duyệt đăng nhập trong trình duyệt khi được yêu cầu, và yêu cầu nó liệt kê các dự án AgileHero của bạn — lệnh gọi thành công đầu tiên xác nhận kết nối.

Tài liệu máy khách khác · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

Chưa được hỗ trợ

Các máy khách này chưa thể đăng nhập vào AgileHero. Hầu hết chúng thiếu hỗ trợ cho Client ID Metadata Documents, phương thức đăng ký máy khách OAuth mà AgileHero sử dụng (khuyến nghị MCP hiện tại); chúng tôi kiểm tra lại tài liệu nhà cung cấp thường xuyên và chuyển một máy khách lên ngay khi nó đủ điều kiện.

CursorChưa hỗ trợ

Cursor chưa hỗ trợ Client ID Metadata Documents (đăng nhập OAuth của nó cần Dynamic Client Registration hoặc một máy khách đã đăng ký trước), vì vậy hiện tại nó không thể kết nối với AgileHero.

Tài liệu Cursor · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

OpenCodeChưa hỗ trợ

OpenCode chưa hỗ trợ Client ID Metadata Documents (đăng nhập OAuth của nó cần Dynamic Client Registration hoặc một máy khách đã đăng ký trước), vì vậy hiện tại nó không thể kết nối với AgileHero.

Tài liệu OpenCode · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

Gemini CLINot yet

Gemini CLI chưa hỗ trợ Client ID Metadata Documents (đăng nhập OAuth của nó cần Dynamic Client Registration hoặc một máy khách đã đăng ký trước), vì vậy hiện tại nó không thể kết nối với AgileHero.

Tài liệu Gemini CLI · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

ClineChưa hỗ trợ

Cline chưa hỗ trợ Client ID Metadata Documents (đăng nhập OAuth của nó cần Dynamic Client Registration hoặc một máy khách đã đăng ký trước), vì vậy hiện tại nó không thể kết nối với AgileHero.

Tài liệu Cline · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

Google AntigravityChưa hỗ trợ

Google Antigravity chưa hỗ trợ Client ID Metadata Documents (đăng nhập OAuth của nó cần Dynamic Client Registration hoặc một máy khách đã đăng ký trước), vì vậy hiện tại nó không thể kết nối với AgileHero.

Tài liệu Google Antigravity · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

AmpChưa hỗ trợ

Amp chưa hỗ trợ Client ID Metadata Documents (đăng nhập OAuth của nó cần Dynamic Client Registration hoặc một máy khách đã đăng ký trước), vì vậy hiện tại nó không thể kết nối với AgileHero.

Tài liệu Amp · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

Raycast AIChưa hỗ trợ

Raycast AI chưa hỗ trợ Client ID Metadata Documents (đăng nhập OAuth của nó cần Dynamic Client Registration hoặc một máy khách đã đăng ký trước), vì vậy hiện tại nó không thể kết nối với AgileHero.

Tài liệu Raycast AI · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

KiroChưa hỗ trợ

Kiro đăng nhập bằng một URL Client ID Metadata Document mà bạn cung cấp, và AgileHero chưa lưu trữ một Client ID Metadata Document cho nó.

Tài liệu Kiro · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

WarpChưa hỗ trợ

Warp chưa có đăng nhập OAuth cho các máy chủ do người dùng thêm, vì vậy hiện tại nó không thể kết nối với AgileHero.

Tài liệu Warp · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

JetBrains AI AssistantChưa hỗ trợ

JetBrains AI Assistant chưa có đăng nhập OAuth cho các máy chủ từ xa, và cầu nối mcp-remote sẽ cần một tài liệu máy khách được lưu trữ — AgileHero chưa lưu trữ một Client ID Metadata Document cho nó.

Tài liệu JetBrains AI Assistant · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

ContinueChưa hỗ trợ

Continue chưa có đăng nhập OAuth cho các máy chủ Streamable HTTP, và cầu nối mcp-remote sẽ cần một tài liệu máy khách được lưu trữ — AgileHero chưa lưu trữ một Client ID Metadata Document cho nó.

Tài liệu Continue · đã xác minh với tài liệu nhà cung cấp vào 2026-09-15

Hướng dẫn máy chủ

Mọi máy khách MCP đều nhận các quy ước này tại thời điểm khởi tạo:

Máy chủ MCP AgileHero.

Mọi tham số id và mọi id trong phản hồi là một uid ngắn — luôn sử dụng các uid được trả về bởi các công cụ list/get/search, không bao giờ tự bịa ra. Hầu hết các công cụ cần một project uid — hãy gọi list_projects trước để khám phá các workspace và dự án. Ưu tiên search (toàn văn, tất cả các loại nội dung) hơn search_cards (chuỗi con tiêu đề, một dự án).

Trên các công cụ cập nhật, ưu tiên các trường delta add_*/remove_* cho các bộ sưu tập (tăng dần, an toàn); các trường bộ sưu tập thông thường (assigned_to, labels, checklists, cards_relations, links, attachments) THAY THẾ trạng thái trước đó và không thể kết hợp với các trường delta của chúng. Các mục checklist là { description, checked }. Cập nhật các thay đổi bằng updated_since trên list_cards / list_epics.

Sử dụng move_card (không phải update_card) để thay đổi danh sách hoặc vị trí của một thẻ; một list_id trống có nghĩa là backlog.

Các công cụ wiki, bảng trắng, hồi kết và lộ trình yêu cầu workspace của dự án phải ở gói Pro hoặc dùng thử. Ghi element bảng trắng là các công cụ hàng loạt và tất cả-hoặc-không; các element uid đến từ get_whiteboard. Các mục hồi kết được quản lý bằng add_retro_items và move_retro_item (move_card từ chối các thẻ hồi kết).

Giới hạn hàng ngày: các lệnh gọi công cụ được tính phí theo người dùng trên mỗi workspace — 500/ngày trên gói Miễn phí, 5.000/ngày trên Pro hoặc dùng thử, đặt lại lúc 00:00 UTC. get_ahm_spec và list_projects không bao giờ bị tính (cũng như bất kỳ lệnh gọi nào không quy cho một workspace duy nhất, như tìm kiếm không phạm vi). Vượt quá giới hạn, các công cụ trả về lỗi giới hạn hàng ngày cho đến khi đặt lại hoặc nâng cấp.

TẤT CẢ văn bản rich text (trang wiki, mô tả thẻ/epic, bình luận) là AgileHero Markup (AHM) — XML nghiêm ngặt, KHÔNG BAO GIỜ là markdown hoặc HTML; hãy gọi get_ahm_spec một lần trước khi viết bất kỳ văn bản nào. Chỉnh sửa rich text là quy trình hai bước theo thiết kế: preview_wiki_page_update / preview_description_update (hậu quả + preview_token), sau đó là công cụ cập nhật tương ứng với token đó.

Tài liệu công cụ đầy đủ: https://agilehero.io/docs/mcp

Đặc tả AHM: https://agilehero.io/docs/mcp/agilehero-markup

Công cụ (49)

list_projectschỉ đọc

Liệt kê mọi workspace và dự án mà người dùng của token có thể truy cập, để agent có thể phân giải project uid mà hầu hết các công cụ khác yêu cầu. Hãy gọi công cụ này trước tiên bất cứ khi nào không biết project uid — không bao giờ yêu cầu người dùng dán một uid. Trả về các workspace (uid, name, plan, role của bạn) với các dự án của chúng (uid, name, url). Các công cụ trụ cột Pro (wiki, metrics) cần plan của workspace là pro hoặc dùng thử.

searchchỉ đọc

Tìm kiếm toàn văn toàn cầu của sản phẩm (OpenSearch): thẻ, epic, trang wiki và dự án, khớp tiêu đề, mô tả, bình luận, mục danh sách kiểm tra và tên tệp đính kèm, được xếp hạng theo mức độ liên quan với ưu tiên độ mới. Sử dụng công cụ này để tìm bất kỳ nội dung nào ("thẻ nơi chúng ta đã thảo luận về việc di chuyển"); chỉ dùng search_cards cho các tra cứu chuỗi con trong tiêu đề trong một dự án. Mỗi kết quả mang theo một loại, một uid sẵn sàng cho hành động (thẻ cung cấp get_card/update_card, epic cung cấp get_epic, wiki_pages cung cấp show_wiki_page, dự án cung cấp các tham số project_id), một url liên kết sâu, và các đoạn trích được đánh dấu <mark> cho thấy lý do khớp. Tùy chọn giới hạn phạm vi với project_id hoặc assigned_to_me. Phân trang với page/per_page; total_count là số lượng khớp đầy đủ.

Tham số	Loại	Bắt buộc	Mô tả
query	string	có	Truy vấn tìm kiếm văn bản tự do
project_id	string		Uid dự án tùy chọn để giới hạn phạm vi tìm kiếm
assigned_to_me	boolean		Chỉ kết quả được gán cho người dùng của token
page	integer		Số trang (mặc định 1)
per_page	integer		Số kết quả mỗi trang, 1-50 (mặc định 20)

get_cardchỉ đọc

Đọc đầy đủ một thẻ: mô tả AgileHero Markup với các id khối cộng với description_version (hai đầu vào preview_description_update / update_description nhận), vị trí danh sách, epic, nhãn, người được gán, người báo cáo, loại, ước tính, ngày đến hạn, danh sách kiểm tra, liên kết, tệp đính kèm, thẻ liên quan và bình luận theo chuỗi. Chỉ nhận uid thẻ — không có tham số project_id. Uid thẻ đến từ list_cards, search hoặc search_cards.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Định danh duy nhất của thẻ

get_epicchỉ đọc

Đọc đầy đủ một epic: mô tả AgileHero Markup với các id khối cộng với description_version (hai đầu vào preview_description_update / update_description nhận), tên, số, màu, ngày bắt đầu/kết thúc, người được gán, danh sách kiểm tra, liên kết, tệp đính kèm, mọi thẻ trên đó (uid, số, tiêu đề và danh sách của nó với danh mục — danh sách null = backlog — theo thứ tự bảng, vì vậy đây là cách để liệt kê tất cả thẻ của một epic và xem cái nào cần làm, đang tiến hành hoặc đã hoàn thành) và bình luận theo chuỗi. Chỉ nhận uid epic — không có tham số project_id. Uid epic đến từ list_epics hoặc search.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Định danh duy nhất của epic

list_wiki_pathsPro · wikichỉ đọc

Liệt kê toàn bộ cây wiki của một dự án theo thứ tự hiển thị — mọi thư mục và trang với uid, tên, loại (trang hoặc thư mục) và parent_id — để agent có thể phân giải uid trang mà show_wiki_page nhận và chọn parent_id cho create_wiki_page. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất của dự án

show_wiki_pagePro · wikichỉ đọc

Truy xuất một trang wiki dưới dạng AgileHero Markup (AHM) với document_version của nó. Nội dung là AHM, không phải markdown — các id khối, neo <discussion>, và tham chiếu <image/>/<attachment/> là một phần của tài liệu; đọc get_ahm_spec trước khi chỉnh sửa. Chỉnh sửa qua preview_wiki_page_update rồi update_wiki_page, sử dụng các id khối và document_version được trả về ở đây. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Định danh duy nhất của đường dẫn trang

get_ahm_specchỉ đọc

Đặc tả AgileHero Markup (AHM) v1.0 — định dạng văn bản phong phú DUY NHẤT mà AgileHero chấp nhận (markdown và HTML bị từ chối). Đọc cái này MỘT LẦN trước khi viết hoặc chỉnh sửa bất kỳ văn bản phong phú nào (trang wiki, mô tả thẻ/epic, bình luận): từ vựng, thuộc tính, quy tắc thoát, và một ví dụ đã làm việc. Cùng văn bản trên web: https://agilehero.io/docs/mcp/agilehero-markup

create_wiki_pagePro · wiki

Tạo một trang wiki (tùy chọn bên trong một thư mục) với nội dung AgileHero Markup (AHM). Nội dung phải được bọc trong <agile-hero-markup version="1.0"> — markdown và HTML bị từ chối; đọc get_ahm_spec trước. Trả về uid, url, document_version và nội dung của trang mới. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất (uid) của dự án
name	string	có	Tiêu đề trang
parent_id	string		Uid thư mục tùy chọn (từ list_wiki_paths)
content	string		Nội dung trang dưới dạng AHM; bỏ qua để tạo trang trống

preview_wiki_page_updatePro · wikichỉ đọc

Bước đầu tiên BẮT BUỘC của mọi cập nhật trang wiki: xác thực các thao tác và trả về các hậu quả do máy chủ tính toán (các khối được thêm/xóa/thay đổi, các tệp sẽ bị xóa vĩnh viễn, các cuộc thảo luận nhóm sẽ mất neo, cảnh báo có thể là markdown) cộng với preview_token mà update_wiki_page yêu cầu. Không có gì bị sửa đổi. Các thao tác được định địa chỉ theo khối (replace_block / insert_after / delete_block / move_block) với nội dung AHM — đọc get_ahm_spec trước, và lấy các id khối + document_version từ show_wiki_page. Xem xét các hậu quả trước khi lưu: một tệp bị xóa được liệt kê hoặc thảo luận bị mất neo chỉ chấp nhận được khi người dùng yêu cầu điều đó. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Uid đường dẫn trang
document_version	string	có	Từ show_wiki_page — chứng minh độ mới
operations	array of object	có	Được áp dụng theo thứ tự trên tài liệu đang phát triển

update_wiki_pagePro · wikiphá hủy

Áp dụng một cập nhật đã được xem trước trước đó vào một trang wiki. Yêu cầu preview_token từ preview_wiki_page_update cho CHÍNH XÁC các thao tác này và document_version này — lưu mà không xem trước là không thể theo thiết kế. Mỗi lần lưu tạo một phiên bản trang mà con người có thể hoàn tác trong ứng dụng. Trả về trang đã cập nhật (AHM + document_version mới) và các hậu quả đã áp dụng. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Uid đường dẫn trang
document_version	string	có	Phiên bản mà bản xem trước được thực hiện dựa trên
operations	array of object	có	Các thao tác chính xác đã được xem trước
preview_token	string	có	Từ preview_wiki_page_update

preview_description_updatechỉ đọc

Bước đầu tiên BẮT BUỘC của mọi chỉnh sửa mô tả thẻ hoặc epic: xác thực các thao tác khối và trả về các hậu quả do máy chủ tính toán cộng với preview_token mà update_description yêu cầu. Không có gì bị sửa đổi. Nội dung là AgileHero Markup (AHM, bề mặt mô tả: không có bảng, màu sắc, căn chỉnh, thảo luận hoặc tệp đính kèm) — đọc get_ahm_spec trước; các id khối và document_version đến từ get_card / get_epic.

Tham số	Loại	Bắt buộc	Mô tả
resource_type	enum: card | epic	có
id	string	có	Uid thẻ hoặc epic
document_version	string	có	Từ get_card / get_epic
operations	array of object	có	Được áp dụng theo thứ tự trên mô tả đang phát triển

update_descriptionphá hủy

Áp dụng một cập nhật mô tả đã được xem trước trước đó vào một thẻ hoặc epic. Yêu cầu preview_token từ preview_description_update cho CHÍNH XÁC các thao tác này và document_version này — lưu mà không xem trước là không thể theo thiết kế. Trả về mô tả đã cập nhật (AHM + document_version mới).

Tham số	Loại	Bắt buộc	Mô tả
resource_type	enum: card | epic	có
id	string	có	Uid thẻ hoặc epic
document_version	string	có	Phiên bản mà bản xem trước được thực hiện dựa trên
operations	array of object	có	Các thao tác chính xác đã được xem trước
preview_token	string	có	Từ preview_description_update

list_whiteboardsPro · whiteboardchỉ đọc

Liệt kê các whiteboard của một dự án (uid, tên, số lượng phần tử, url). Sử dụng get_whiteboard để đọc các phần tử của một bảng. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất của dự án

create_whiteboardPro · whiteboard

Tạo một whiteboard trống trên một dự án. Thêm nội dung với create_whiteboard_elements. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất của dự án
name	string	có	Tên whiteboard

get_whiteboardPro · whiteboardchỉ đọc

Đọc một whiteboard dưới dạng biểu diễn văn bản gọn: ranh giới bảng cộng với một dòng cho mỗi phần tử — "<type> <uid> tại <x>,<y> kích thước <w>x<h> [màu] [cha <frame-uid>] [liên kết <card|epic> <uid>] \"văn bản\"", các bộ nối là "bộ nối <uid> <from> -> <to>". Các uid phần tử từ đây là các tay cầm mà mọi công cụ ghi whiteboard nhận. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Định danh duy nhất của whiteboard

create_whiteboard_elementsPro · whiteboard

Tạo tối đa 100 phần tử whiteboard trong một lệnh gọi giao dịch (tất cả hoặc không có gì, một sự kiện thời gian thực). Kích thước gốc, màu sắc và vị trí văn bản được áp dụng phía máy chủ — thường chỉ cần cung cấp loại + văn bản (+ màu). Bỏ qua x/y và các phần tử được tự động sắp xếp (lưới mặc định; arrange: row|column|grid, origin_x/origin_y/gap để tinh chỉnh); cung cấp x/y để kiểm soát hoàn toàn. Khung chứa các phần tử qua parent_id (một uid khung hiện có) hoặc parent_ref (ref của một khung trước đó trong CHÍNH lệnh gọi này). Bộ nối liên kết các phần tử bằng uid (source_id/target_id) hoặc ref hàng loạt (source_ref/target_ref) — không bao giờ bằng tọa độ; các neo được tính toán bởi giao diện người dùng. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
whiteboard_id	string	có	Định danh duy nhất của whiteboard
elements	array of object	có	Được tạo theo thứ tự mảng — các ref chỉ phân giải ngược
arrange	enum: grid | row | column		Bố cục cho các phần tử không có x/y rõ ràng (mặc định grid)
origin_x	number		Tự động sắp xếp bắt đầu x (mặc định 100)
origin_y	number		Tự động sắp xếp bắt đầu y (mặc định 100)
gap	number		Khoảng cách tự động sắp xếp tính bằng px (mặc định 20)

create_whiteboard_diagramPro · whiteboard

Vẽ một sơ đồ (lưu đồ, quy trình, đồ thị phụ thuộc) trên một whiteboard từ một đồ thị ngữ nghĩa — các nút, cạnh, nhóm tùy chọn, KHÔNG có tọa độ: máy chủ thực hiện bố cục phân lớp từ trên xuống với kích thước gốc và trả về các uid phần tử đã tạo được khóa theo các id nút của bạn. Được đặt bên dưới nội dung bảng hiện có. Giao dịch (tất cả hoặc không có gì, một sự kiện thời gian thực). Tối đa 20 nút — chia các luồng lớn hơn thành hai sơ đồ. Giữ các hình dạng đơn giản (hình chữ nhật) trừ khi ngữ nghĩa yêu cầu một hình (hình thoi = quyết định, sân vận động = bắt đầu/kết thúc, hình trụ = kho dữ liệu). Chỉnh sửa kết quả với update_whiteboard_elements — bố cục không bao giờ chạy lại. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
whiteboard_id	string	có	Định danh duy nhất của whiteboard
title	string		Tiêu đề sơ đồ (tiêu đề khung, hoặc tiêu đề khi sử dụng nhóm)
nodes	array of object	có
edges	array of object
groups	array of object
origin_x	number		Tùy chọn x trên cùng bên trái; mặc định bên dưới nội dung hiện có
origin_y	number		Tùy chọn y trên cùng bên trái; mặc định bên dưới nội dung hiện có

update_whiteboard_elementsPro · whiteboard

Cập nhật tối đa 100 phần tử bảng trắng trong một lần gọi tất cả-hoặc-không: di chuyển (x/y), thay đổi kích thước, xếp lại tầng (z_index), đổi văn bản, đổi màu, đổi cha (parent_id — uid của khung, hoặc "" để tách ra), và mũi tên/đường dẫn/nhãn của connector. Uid của phần tử đến từ get_whiteboard; loại phần tử không thể thay đổi. Chỉ các trường được cung cấp mới thay đổi — các thuộc tính không liên quan được giữ nguyên. Yêu cầu gói Pro hoặc workspace dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
whiteboard_id	string	có	Định danh duy nhất của bảng trắng
updates	array of object	có

delete_whiteboard_elementsPro · whiteboarddestructive

Xóa tối đa 100 phần tử bảng trắng trong một lần gọi giao dịch. Xóa một khung hoặc nút mind-map sẽ giải phóng các phần tử con của nó lên bảng (chúng KHÔNG bị xóa — hãy bao gồm uid của chúng một cách tường minh để xóa chúng luôn). Các connector gắn với phần tử bị xóa không bị gỡ và sẽ treo lơ lửng. Uid của phần tử đến từ get_whiteboard. Yêu cầu gói Pro hoặc workspace dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
whiteboard_id	string	có	Định danh duy nhất của bảng trắng
ids	array of string	có	Uid của phần tử cần xóa

review_whiteboardPro · whiteboardchỉ-đọc

Chạy các kiểm tra chất lượng xác định trên bảng trắng: văn bản có khả năng tràn ra ngoài phần tử của nó, các phần tử chồng lấn nhìn thấy được, connector có điểm cuối không liên kết hoặc treo lơ lửng, màu sắc nằm ngoài bảng màu UI, vị trí lệch lưới, và các phần tử có cha đã bị xóa. Chỉ mang tính tư vấn — các phát hiện là gợi ý, không phải lỗi, và một bảng có phát hiện có thể chính xác là điều người dùng muốn. Sử dụng sau khi vẽ để kiểm tra hợp lý, sửa tối đa một lần, và không lặp lại để đuổi theo một báo cáo trống. Yêu cầu gói Pro hoặc workspace dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Định danh duy nhất của bảng trắng

convert_whiteboard_elementPro · whiteboard

Chuyển đổi một phần tử bảng trắng thành một mục tồn đọng: một ghi chú dán thành một thẻ hoặc một epic, hoặc một khung thành một epic (các ghi chú dán con của khung trở thành thẻ trên epic đó; các phần tử con đã được chuyển đổi sẽ được gán lại, không bị nhân đôi). Phần tử vẫn ở trên bảng, được liên kết với những gì nó đã trở thành — get_whiteboard hiển thị liên kết. Một phần tử chỉ có thể được chuyển đổi một lần. Văn bản của ghi chú/khung trở thành tiêu đề trừ khi bạn truyền một tiêu đề khác. Yêu cầu gói Pro hoặc workspace dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Uid của phần tử (một sticky_note hoặc frame, từ get_whiteboard)
to	enum: card | epic	có	Nội dung cần tạo
title	string		Tiêu đề thẻ / tên epic; mặc định là văn bản của phần tử
list_id	string		Chỉ dành cho thẻ: uid danh sách đích; bỏ qua để vào tồn đọng
color	string		Chỉ dành cho epic: màu hex; mặc định là màu của phần tử

convert_mind_mapPro · whiteboard

Chuyển đổi một mind map thành các mục tồn đọng với ánh xạ theo từng nút: nút gốc có thể trở thành một epic mới (vai trò "epic") hoặc gắn vào một epic hiện có (vai trò "existing_epic" + target_epic_id); các nút khác trở thành thẻ trên epic đó (vai trò "card") hoặc nhãn dự án (vai trò "label" — các nút nhãn nằm trên một nút thẻ trong cây được áp dụng cho thẻ đó); vai trò "skip" bỏ qua một nút. Truyền uid của nút GỐC làm id và mọi nút bạn muốn chuyển đổi trong nodes (các nút không được liệt kê sẽ bị bỏ qua). Mỗi nút chỉ chuyển đổi một lần: các nút đã được chuyển đổi sẽ bị từ chối ngay từ đầu — hãy gửi lại mà không có chúng. Yêu cầu gói Pro hoặc workspace dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Uid của nút mind-map GỐC (từ get_whiteboard)
nodes	array of object	có
target_epic_id	string		Uid của epic, bắt buộc với vai trò "existing_epic" trên nút gốc

list_retrospectivesPro · retrospectiveschỉ-đọc

Liệt kê các buổi retrospective của một dự án: các retrospective mô hình mới và health check nơi workspace có chúng, các bảng retrospective cổ điển trong trường hợp khác. Một mục mô hình mới có uid, tên, loại (retro | health_check), trạng thái (open | live | closed), ngày (starts_on; closes_on đối với health check), giai đoạn hiện tại, mẫu, uid người điều phối, số lượng hành động nó đã tạo, và url; phản hồi thêm open_actions_count của dự án. Sử dụng get_retrospective để có bức tranh đầy đủ. Yêu cầu gói Pro hoặc workspace dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất của dự án

create_retrospectivePro · retrospectives

Tạo một retrospective: một retrospective mô hình mới nơi workspace có chúng, một bảng retrospective cổ điển trong trường hợp khác; phản hồi là retrospective như get_retrospective trả về (các cột với uid của chúng), vì vậy add_retro_items có thể theo sau ngay lập tức. Một retrospective mô hình mới đến từ một mẫu (mặc định went_well), mở cho ghi chú ngay lập tức và có bạn là người điều phối; tùy chọn: trọng tâm, ẩn danh (mặc định: của mẫu), participant_ids (một retrospective Selected-members; bỏ qua để mọi thành viên dự án có quyền ghi tham gia), các loại câu hỏi check_in và feedback, và số phiếu bầu. Người điều phối bắt đầu nó và chạy các giai đoạn của nó trong ứng dụng. Các bảng cổ điển chỉ nhận name, date và previous_retrospective_id và từ chối các đối số mô hình mới. Yêu cầu gói Pro hoặc workspace dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất của dự án
name	string	có	Tên retrospective
template	enum: went_well | start_stop_continue | four_ls | mad_sad_glad | kalm | daki | starfish | plus_delta | sailboat | rose_thorn_bud | wrap | hot_air_balloon | three_pigs | project_retro | postmortem | kudos_lessons		Khóa mẫu; mặc định went_well
starts_on	string		Ngày, ISO-8601 (YYYY-MM-DD); mặc định là hôm nay
starts_at	string		Bí danh không dùng nữa của starts_on
focus	string		Retrospective này về điều gì, hiển thị dưới tên của nó
anonymity	enum: anonymous | optional | named		Ai được hiển thị trên ghi chú: ẩn danh, tùy chọn (tác giả có thể thêm tên của họ) hoặc có tên
participant_ids	array of string		Uid người dùng của những người tham gia (list_project_users); bạn luôn là một trong số đó
check_in	enum: safety | mood | esvp | one_word		Câu hỏi check-in (mặc định safety)
feedback	enum: roti | pulse | one_word		Câu hỏi phản hồi kết thúc (mặc định roti)
votes	object		Cài đặt phiếu bầu: budget (auto | fixed | unlimited), per_person (1-20), max_per_topic (1-10)
previous_retrospective_id	string		Chỉ dành cho bảng cổ điển: uid của một retrospective trước đó có cột Actions hiển thị dưới dạng "Past actions"

get_retrospectivePro · retrospectiveschỉ-đọc

Đọc một retrospective như bạn có thể thấy nó: một retrospective mô hình mới hoặc health check nơi workspace có chúng, một bảng retrospective cổ điển trong trường hợp khác. Một retrospective mô hình mới trả về thiết lập, các giai đoạn (giai đoạn hiện tại, bộ đếm thời gian, tiến trình), các cột (với uid) chứa các chủ đề (nhóm ghi chú, với uid), tổng số check-in và feedback, số phiếu bầu còn lại của bạn, hàng đợi Discuss và các chủ đề được gác lại, đề xuất, hành động (những hành động nó đã tạo cộng với các hành động đang mở của dự án) và, khi đã đóng, bản tóm tắt. Quyền riêng tư tuân theo phòng: trước khi tiết lộ, bạn chỉ nhận được ghi chú của riêng mình (mỗi cột đếm của mọi người), tác giả chỉ trên các ghi chú có tên, tổng số phiếu bầu chỉ khi các phiếu bầu được tiết lộ. Một health check trả về các khía cạnh và sự tham gia của nó, xếp hạng của riêng bạn khi đang mở, và các tổng hợp theo khía cạnh khi đã đóng. Yêu cầu gói Pro hoặc workspace dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Uid của retrospective (từ list_retrospectives)

add_retro_itemsPro · retrospectives

Thêm các mục vào một retrospective với tư cách chính bạn, nhiều mục cùng lúc: ghi chú trên một retrospective mô hình mới nơi workspace có chúng, thẻ trên một bảng retrospective cổ điển trong trường hợp khác. Mỗi mục là { column, text, recipient_id? }: column là tiêu đề cột (không phân biệt hoa thường) hoặc uid từ get_retrospective; text dài tối đa 1000 ký tự (255 trên bảng cổ điển); recipient_id, uid người dùng của đồng đội được cảm ơn, bắt buộc trong cột kudos mô hình mới và bị từ chối trên bảng cổ điển. Một ghi chú mô hình mới bắt đầu chủ đề của riêng nó và những người khác thấy nó khi các ghi chú được tiết lộ; ghi chú chỉ được thực hiện khi retrospective đang mở cho ghi chú hoặc trong giai đoạn Write, nếu không lệnh gọi bị từ chối với mã wrong_stage và giai đoạn hiện tại. LỖI MỘT PHẦN: các mục hợp lệ được thêm, các mục không hợp lệ được báo cáo theo chỉ mục — hãy kiểm tra mảng "failed". Yêu cầu gói Pro hoặc workspace dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
retrospective_id	string	có	Uid của retrospective
items	array of object	có

move_retro_itemPro · retrospectives

Di chuyển một mục retrospective: nhóm lại một ghi chú trên một retrospective mô hình mới nơi workspace có chúng, di chuyển một thẻ đến một cột khác của bảng retrospective cổ điển trong trường hợp khác. Mô hình mới, chỉ giai đoạn Group: topic_id đặt ghi chú vào chủ đề đó (nhóm ghi chú); column (tiêu đề hoặc uid) làm cho nó thành một chủ đề riêng ở đó, tại vị trí giữa các chủ đề của cột (bỏ qua để đặt cuối). Truyền expected_updated_at, updated_at của chủ đề ghi chú từ get_retrospective, để bị từ chối với mã stale khi ai đó đã nhóm lại nó trong lúc đó. Ngoài giai đoạn Group, lệnh gọi bị từ chối với mã wrong_stage và giai đoạn hiện tại; kudos và các ghi chú khác không bao giờ trộn lẫn. Các bảng cổ điển chỉ nhận column và position (position bỏ qua = đầu bảng). Yêu cầu gói Pro hoặc workspace dùng thử.

Tham số	Loại	Bắt buộc	Mô tả
id	string	có	Uid của ghi chú (bảng cổ điển: uid của mục) từ get_retrospective
topic_id	string		Uid chủ đề đích; bỏ column ra
column	string		Tiêu đề hoặc uid cột đích
position	integer		Chỉ mục trong cột đích (0 = đầu tiên)
expected_updated_at	string		updated_at của chủ đề ghi chú như lần đọc cuối (kiểm tra xung đột)

list_project_userschỉ-đọc

Liệt kê các thành viên của một dự án — mọi thành viên workspace đối với dự án tiêu chuẩn; người tạo, chủ sở hữu và quản trị viên workspace, và bất kỳ ai được thêm tường minh đối với dự án riêng tư — để agent có thể phân giải uid người được giao thay vì đoán tên. Trả về uid của mỗi thành viên, tên đầy đủ, email và vai trò workspace (owner, admin, member hoặc observer). Các uid đó là những gì assigned_to nhận trên create_card, update_card, create_epic, update_epic và create_roadmap_slot.

Tham số	Loại	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất của dự án

list_board_listschỉ-đọc

Liệt kê các danh sách của bảng kanban của một dự án để agent có thể phân giải một đích move_card hợp lệ. Trả về mỗi danh sách đang hoạt động theo thứ tự hiển thị với uid của nó (có thể dùng làm đích move_card) và tên hiển thị. Tồn đọng được bao gồm như một mục có thể chọn với id chuỗi rỗng.

Tham số	Loại	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất (uid) của dự án

list_epicschỉ-đọc

Liệt kê các epic của một dự án để agent có thể phân giải uid epic cho get_epic và gán thẻ. Trả về mỗi epic theo thứ tự hiển thị (vị trí tăng dần) với uid, số, tên, mô tả (Markdown), màu, ngày bắt đầu/kết thúc và số lượng thẻ.

Tham số	Loại	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất (uid) của dự án
updated_since	string		Chỉ các epic có bản ghi thay đổi tại hoặc sau ngày hoặc datetime ISO-8601 này. Lưu ý: các chỉnh sửa bộ sưu tập (danh sách kiểm tra, liên kết) có thể không làm tăng thời gian thay đổi của epic; các chỉnh sửa tên/ngày/mô tả luôn làm điều đó.

list_labelschỉ-đọc

Liệt kê các nhãn của một dự án để agent có thể tái sử dụng phân loại hiện có thay vì tạo các bản sao gần giống khi ghi thẻ. Trả về mỗi nhãn theo thứ tự hiển thị (vị trí tăng dần) với uid, tên và vị trí của nó.

Tham số	Kiểu	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất (uid) của dự án

list_cardschỉ đọc

Liệt kê các thẻ của một danh sách kanban, hoặc của backlog dự án khi list_id được bỏ qua hoặc để trống, theo thứ tự hiển thị trên bảng (đầu cột trước, tức là vị trí sắp xếp giảm dần — cùng thứ tự mà giao diện sản phẩm hiển thị). Các bộ lọc kết hợp với AND: epic_id, label_id, assigned_user_id và reporter_id nhận uid (uid không xác định không khớp gì); due_date giữ các thẻ đến hạn vào hoặc trước ngày đã cho. Trả về các tóm tắt thẻ đủ cho hành động (uid, tiêu đề, danh sách + vị trí, epic, nhãn, người được giao, người báo cáo, ngày đến hạn), sẵn sàng cho get_card / move_card / update_card, được phân trang với limit (mặc định 50, tối đa 100) và offset; total_count là tổng số đã lọc.

Tham số	Kiểu	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất (uid) của dự án
list_id	string		Uid danh sách để đọc; bỏ qua hoặc truyền chuỗi rỗng cho backlog
epic_id	string		Chỉ các thẻ trong epic này (uid epic) trong danh sách hoặc backlog đã chọn; để liệt kê mọi thẻ của một epic trên tất cả danh sách, dùng get_epic
label_id	string		Chỉ các thẻ mang nhãn này (uid nhãn)
assigned_user_id	string		Chỉ các thẻ được giao cho người dùng này (uid người dùng)
reporter_id	string		Chỉ các thẻ được báo cáo (tạo) bởi người dùng này (uid người dùng)
due_date	string		Chỉ các thẻ đến hạn vào hoặc trước ngày này (ISO-8601, ví dụ 2026-06-10)
updated_since	string		Chỉ các thẻ có bản ghi thay đổi vào hoặc sau ngày hoặc datetime ISO-8601 này — bộ lọc "những gì đã thay đổi kể từ lần chạy trước". Lưu ý: chỉnh sửa các bộ sưu tập đính kèm (nhãn, danh sách kiểm tra, liên kết) có thể không làm tăng thời gian thay đổi của thẻ; chỉnh sửa tiêu đề/mô tả/vô hướng luôn làm điều đó.
limit	integer		Kích thước trang, 1-100 (mặc định 50)
offset	integer		Số thẻ để bỏ qua (mặc định 0)

search_cardschỉ đọc

Tìm kiếm thẻ theo chuỗi con trong tiêu đề trong một dự án (bảng kanban và backlog), khớp chính xác với tìm kiếm thẻ trực tiếp trong dự án của sản phẩm (chuỗi con không phân biệt hoa thường trên cơ sở dữ liệu chỉ trong tiêu đề thẻ — mô tả và bình luận không được tìm kiếm; dùng công cụ tìm kiếm để tìm toàn văn trên tất cả loại nội dung), sắp xếp theo thẻ mới tạo trước. Trả về các tóm tắt thẻ đủ cho hành động (uid, tiêu đề, vị trí danh sách + vị trí, epic, nhãn, người được giao, người báo cáo, ngày đến hạn); truy vấn không có kết quả trả về mảng thẻ rỗng, không phải lỗi. Phân trang với limit (mặc định 50, tối đa 100) và offset; total_count là tổng số khớp.

Tham số	Kiểu	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất (uid) của dự án
query	string	có	Văn bản để khớp với tiêu đề thẻ (chuỗi con không phân biệt hoa thường)
limit	integer		Kích thước trang, 1-100 (mặc định 50)
offset	integer		Số thẻ khớp để bỏ qua (mặc định 0)

list_attention_cardsPro · metricschỉ đọc

Liệt kê các thẻ cần chú ý trên bảng kanban của dự án — cùng các danh sách như trang Metrics của sản phẩm. Các loại: stuck (nằm trong một cột, không phải backlog/Done, không di chuyển trong hơn 7 ngày; thẻ kẹt lâu nhất trước), blocking (các thẻ chưa hoàn thành mà các thẻ khác đang bị chặn bởi), overdue (đến hạn trong 7 ngày tới hoặc đã quá hạn; sớm nhất trước). kind chọn một danh sách hoặc 'all' (mặc định). Tùy chọn lọc theo uid người được giao hoặc chuỗi ký tự 'unassigned'. Mỗi phần được yêu cầu trả về các tóm tắt thẻ sẵn sàng cho get_card / move_card / update_card, giới hạn ở limit với total_count đầy đủ. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Kiểu	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất (uid) của dự án
kind	enum: stuck | blocking | overdue | all		Danh sách chú ý nào để trả về (mặc định 'all' = mọi danh sách như phần riêng của nó)
assignee_id	string		Chỉ các thẻ được giao cho uid người dùng này, hoặc 'unassigned' cho các thẻ không có người được giao
limit	integer		Tối đa thẻ mỗi phần, 1-100 (mặc định 50)

get_metrics_summaryPro · metricschỉ đọc

Đếm một lần gọi các thẻ cần chú ý trên bảng kanban của dự án: overdue_cards_count, blocking_cards_count và stuck_cards_count — cùng định nghĩa như list_attention_cards, trả về các thẻ đằng sau mỗi số đếm. Rẻ; gọi cái này trước để quyết định xem xét sâu hơn có đáng không. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Kiểu	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất (uid) của dự án

list_roadmap_slotsPro · roadmapchỉ đọc

Liệt kê các vị trí roadmap của dự án chồng lấp với một cửa sổ ngày (mặc định: tháng này đến năm tháng sau). Một vị trí lên lịch một epic giữa hai ngày và có thể mang người được giao; một epic có thể giữ nhiều vị trí, bao gồm cả chồng lấp — đó là theo thiết kế. Trả về tối đa 200 vị trí — thu hẹp cửa sổ nếu bị giới hạn. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Kiểu	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất của dự án
start_date	string		Bắt đầu cửa sổ, ISO-8601 (YYYY-MM-DD); mặc định: đầu tháng này
end_date	string		Kết thúc cửa sổ, ISO-8601; mặc định: start_date + 6 tháng

create_roadmap_slotPro · roadmap

Lên lịch một epic trên roadmap dự án: một vị trí từ start_date đến end_date, tùy chọn với người được giao. Một epic có thể giữ nhiều vị trí và chồng lấp được phép theo thiết kế — kiểm tra list_roadmap_slots trước nếu bạn định mở rộng một vị trí hiện có thay vì thêm một vị trí mới. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Kiểu	Bắt buộc	Mô tả
project_id	string	có	Định danh duy nhất của dự án
epic_id	string	có	Uid epic (từ list_epics); phải thuộc dự án này
start_date	string	có	ISO-8601 (YYYY-MM-DD)
end_date	string	có	ISO-8601; cùng ngày với start_date được phép
assigned_to	mảng string		Uid người dùng để giao (thành viên dự án — xem list_project_users)

update_roadmap_slotPro · roadmap

Cập nhật một vị trí roadmap: lên lịch lại hoặc thay đổi kích thước (start_date/end_date), di chuyển nó đến một epic khác của cùng dự án (epic_id), hoặc đặt người được giao của nó. Chỉ các trường được cung cấp thay đổi, NGOẠI TRỪ assigned_to thay thế TOÀN BỘ tập người được giao — đọc vị trí trước và gửi mọi người nên giữ lại. Uid vị trí đến từ list_roadmap_slots. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Kiểu	Bắt buộc	Mô tả
id	string	có	Uid vị trí roadmap
epic_id	string		Uid epic mới (cùng dự án)
start_date	string		ISO-8601 (YYYY-MM-DD)
end_date	string		ISO-8601
assigned_to	mảng string		THAY THẾ tất cả người được giao (uid người dùng, thành viên dự án); [] xóa

delete_roadmap_slotPro · roadmapphá hủy

Xóa VĨNH VIỄN một vị trí roadmap (và các liên kết người được giao của nó). Điều này không thể hoàn tác — không có thùng rác cho các vị trí roadmap. Bản thân epic không bị ảnh hưởng; để lên lịch lại, ưu tiên update_roadmap_slot. Yêu cầu không gian làm việc Pro hoặc dùng thử.

Tham số	Kiểu	Bắt buộc	Mô tả
id	string	có	Uid vị trí roadmap (từ list_roadmap_slots)

create_label

Tạo một nhãn mới trên một dự án theo tên. Nếu một nhãn có cùng tên đã tồn tại (không phân biệt hoa thường), nhãn hiện có được trả về không thay đổi thay vì tạo một bản gần trùng lặp. Nhãn mới được thêm vào cuối thứ tự hiển thị.

Tham số	Kiểu	Bắt buộc	Mô tả
project_id	string	có	Uid dự án mà nhãn thuộc về
name	string	có

create_card

Tạo một thẻ trên bảng kanban của dự án. Chỉ project_id và title là bắt buộc. Bỏ qua list_id để đặt thẻ trong backlog; bỏ qua position để tham gia cuối hàng đợi (move_card ghi lại hợp đồng vị trí). description là AgileHero Markup — không bao giờ markdown hoặc HTML; đọc get_ahm_spec trước. epic_id và uid người được giao phải đã tồn tại (list_epics, list_project_users), trong khi tên nhãn chưa tồn tại được tạo trên dự án. estimation là độ phức tạp Fibonacci (0/1/2/3/5/8/13), không phải ước tính thời gian. Danh sách kiểm tra, liên kết, tệp đính kèm và quan hệ thẻ đều có thể được cung cấp trong cùng một lần gọi này.

Tham số	Kiểu	Bắt buộc	Mô tả
project_id	string	có	Uid dự án mà thẻ thuộc về (thẻ được tạo trên bảng kanban của dự án)
list_id	string		Uid danh sách; bỏ qua để đặt trong backlog
position	integer
type	enum: story | bug | chore | research
title	string	có
description	string		AgileHero Markup (AHM) — không bao giờ markdown hoặc HTML; đọc get_ahm_spec trước. Bề mặt mô tả: không có bảng, màu sắc, căn chỉnh hoặc thảo luận.
epic_id	string		Uid epic; phải đã tồn tại trên dự án
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Ước tính độ phức tạp trong điểm câu chuyện (thang Fibonacci), không phải ước tính thời gian
due_date	string		Ngày ISO-8601
assigned_to	mảng string		Uid người dùng được giao, có thể khám phá qua list_project_users
labels	mảng string		Tên nhãn; tên không xác định được tạo trên dự án
checklists	mảng đối tượng		Mỗi { name, items: [{ description, checked }] }; items giữ thứ tự được cung cấp
cards_relations	mảng đối tượng		Mỗi { type, target_card_id (uid thẻ trên cùng bảng) }
links	mảng đối tượng		Mỗi { url, description }
attachments	mảng đối tượng		Mỗi { url, name }; tệp được tải từ url

update_cardphá hủy

Cập nhật một thẻ hiện có theo uid của nó. Đối với các bộ sưu tập, ưu tiên các trường delta add_*/remove_* (chỉnh sửa tăng dần an toàn: add_labels, remove_assignees, add_checklist_items, check_items, …); các trường bộ sưu tập thông thường (labels, assigned_to, checklists, cards_relations, links, attachments) THAY THẾ trạng thái trước đó một cách phá hủy và không thể kết hợp với các delta của chúng. Dùng move_card để thay đổi danh sách hoặc vị trí, và preview_description_update / update_description để chỉnh sửa mô tả.

Tham số	Kiểu	Bắt buộc	Mô tả
id	string	có	UID của thẻ
type	enum: story | bug | chore | research
title	string
epic_id	string
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Ước tính độ phức tạp theo điểm câu chuyện (thang Fibonacci), không phải ước tính thời gian
due_date	string		Ngày theo chuẩn ISO-8601
assigned_to	array of string		UID của người được gán, có thể tìm qua list_project_users; thay thế danh sách người được gán của thẻ
labels	array of string		Tên nhãn; tên không xác định sẽ được tạo mới trong dự án; thay thế danh sách nhãn của thẻ
checklists	array of object		Mỗi phần tử { name, items: [{ description, checked }] }; các mục giữ nguyên thứ tự được cung cấp; thay thế danh sách kiểm tra của thẻ
cards_relations	array of object		Mỗi phần tử { type, target_card_id (uid của thẻ trên cùng bảng) }; thay thế các quan hệ của thẻ
links	array of object		Mỗi phần tử { url, description }; thay thế các liên kết của thẻ
attachments	array of object		Mỗi phần tử { url, name }; tệp được tải từ url; thay thế các tệp đính kèm của thẻ
add_labels	array of string		Thêm nhãn theo tên (tên không xác định sẽ được tạo mới); giữ nguyên các nhãn hiện có
remove_labels	array of string		Xóa nhãn theo tên (không phân biệt hoa thường); tên không tồn tại sẽ không có tác dụng
add_assignees	array of string		Thêm người được gán theo uid người dùng; giữ nguyên người được gán hiện có
remove_assignees	array of string		Xóa người được gán theo uid người dùng; uid không tồn tại sẽ không có tác dụng
add_checklist_items	array of object		Thêm mục: mỗi phần tử { checklist, description, checked? } — danh sách kiểm tra được đặt tên sẽ được tạo nếu chưa tồn tại
check_items	array of object		Đánh dấu mục đã hoàn thành, khớp theo mô tả chính xác trong danh sách kiểm tra được đặt tên
uncheck_items	array of object		Đánh dấu mục chưa hoàn thành (khớp tương tự như check_items)
remove_checklist_items	array of object		Xóa mục; mục không tồn tại sẽ không có tác dụng
add_relations	array of object		Thêm quan hệ; giữ nguyên các quan hệ hiện có
remove_relations	array of object		Xóa các quan hệ khớp; quan hệ không tồn tại sẽ không có tác dụng
add_links	array of object		Thêm liên kết: mỗi phần tử { url, description? }; giữ nguyên các liên kết hiện có
remove_links	array of string		Xóa liên kết theo url chính xác; url không tồn tại sẽ không có tác dụng

delete_carddestructive

Xóa mềm một thẻ theo uid của nó: thẻ rời khỏi bảng và mọi danh sách, các quan hệ với thẻ khác bị xóa, mọi phiên ước tính trên thẻ bị vô hiệu hóa, và các phần tử bảng trắng liên kết với thẻ bị hủy liên kết. Epic mà thẻ thuộc về không bị xóa. Không có chức năng khôi phục qua MCP.

Tham số	Kiểu	Bắt buộc	Mô tả
id	string	có	UID của thẻ

move_card

Di chuyển một thẻ đến danh sách khác (hoặc thay đổi vị trí của nó trong cùng danh sách). Chỉ các thẻ trên bảng kanban mới có thể di chuyển; thẻ trên bảng retrospective sẽ bị từ chối. Truyền chuỗi rỗng cho list_id để di chuyển thẻ vào backlog kanban. Một danh sách được hiển thị từ trên xuống theo vị trí cao nhất, vì vậy vị trí 0 là ĐÁY của danh sách. Bỏ qua position để tham gia vào cuối hàng đợi (đáy, vị trí 0) trong backlog và trong các danh sách to_do và in_progress, hoặc đầu danh sách done.

Tham số	Kiểu	Bắt buộc	Mô tả
id	string	có	UID của thẻ
list_id	string	có	UID danh sách đích; chuỗi rỗng di chuyển đến backlog (chỉ kanban)
position	integer		Vị trí trong danh sách đích: 0 là đáy và vị trí cao nhất là đầu. Phải nằm trong khoảng từ 0 đến số thẻ khác đã có trong danh sách đích. Bỏ qua để tham gia vào cuối hàng đợi (vị trí 0) trong backlog và trong các danh sách to_do và in_progress, hoặc đầu danh sách done.

create_epic

Tạo một epic trong dự án. Chỉ cần project_id và name. description là AgileHero Markup — không bao giờ dùng markdown hoặc HTML; hãy đọc get_ahm_spec trước. UID người được gán đến từ list_project_users. Checklists, links và attachments có thể được cung cấp trong cùng lời gọi này. Trả về uid epic mới — giá trị mà create_card / update_card nhận làm epic_id, và create_roadmap_slot lên lịch.

Tham số	Kiểu	Bắt buộc	Mô tả
project_id	string	có	UID dự án mà epic thuộc về
name	string	có
description	string		AgileHero Markup (AHM) — không bao giờ dùng markdown hoặc HTML; hãy đọc get_ahm_spec trước. Bề mặt mô tả: không có bảng, màu sắc, căn chỉnh hoặc thảo luận.
color	string		Màu hex như #0060F0
start_date	string		Ngày theo chuẩn ISO-8601
end_date	string		Ngày theo chuẩn ISO-8601
assigned_to	array of string		UID của người được gán, có thể tìm qua list_project_users
checklists	array of object		Mỗi phần tử { name, items: [{ description, checked }] }; các mục giữ nguyên thứ tự được cung cấp
links	array of object		Mỗi phần tử { url, description }
attachments	array of object		Mỗi phần tử { url, name }; tệp được tải từ url

update_epicdestructive

Cập nhật một epic hiện có theo uid của nó; chỉ các trường được cung cấp mới thay đổi. Đối với các bộ sưu tập, hãy ưu tiên các trường delta add_*/remove_* (chỉnh sửa tăng dần an toàn); các trường bộ sưu tập thông thường (assigned_to, checklists, links, attachments) THAY THẾ trạng thái trước đó một cách phá hủy và không thể kết hợp với các delta của chúng. Sử dụng preview_description_update / update_description để chỉnh sửa mô tả.

Tham số	Kiểu	Bắt buộc	Mô tả
id	string	có	UID của epic
name	string
color	string		Màu hex như #0060F0
start_date	string		Ngày theo chuẩn ISO-8601
end_date	string		Ngày theo chuẩn ISO-8601
assigned_to	array of string		UID của người được gán, có thể tìm qua list_project_users; thay thế danh sách người được gán của epic
checklists	array of object		Mỗi phần tử { name, items: [{ description, checked }] }; thay thế danh sách kiểm tra của epic
links	array of object		Mỗi phần tử { url, description }; thay thế các liên kết của epic
attachments	array of object		Mỗi phần tử { url, name }; tệp được tải từ url; thay thế các tệp đính kèm của epic
add_assignees	array of string		Thêm người được gán theo uid người dùng; giữ nguyên người được gán hiện có
remove_assignees	array of string		Xóa người được gán theo uid người dùng; uid không tồn tại sẽ không có tác dụng
add_checklist_items	array of object		Thêm mục: mỗi phần tử { checklist, description, checked? } — danh sách kiểm tra được đặt tên sẽ được tạo nếu chưa tồn tại
check_items	array of object		Đánh dấu mục đã hoàn thành, khớp theo mô tả chính xác trong danh sách kiểm tra được đặt tên
uncheck_items	array of object		Đánh dấu mục chưa hoàn thành (khớp tương tự như check_items)
remove_checklist_items	array of object		Xóa mục; mục không tồn tại sẽ không có tác dụng
add_links	array of object		Thêm liên kết: mỗi phần tử { url, description? }; giữ nguyên các liên kết hiện có
remove_links	array of string		Xóa liên kết theo url chính xác; url không tồn tại sẽ không có tác dụng

delete_epicdestructive

Xóa mềm một epic theo uid của nó. Các thẻ của epic KHÔNG bị xóa — chúng vẫn ở trên bảng, tách khỏi epic. Các vị trí roadmap của epic BỊ xóa vĩnh viễn (một vị trí lên lịch cho một epic, vì vậy nó vô nghĩa nếu không có epic), và các phần tử bảng trắng liên kết với epic bị hủy liên kết.

Tham số	Kiểu	Bắt buộc	Mô tả
id	string	có	UID của epic

create_comment

Thêm bình luận vào một thẻ hoặc một epic. Cung cấp chính xác một trong card_id hoặc epic_id. Nội dung là AgileHero Markup (AHM, bề mặt bình luận: không có bảng, phương tiện, màu sắc, căn chỉnh hoặc thảo luận) — không bao giờ dùng markdown hoặc HTML; hãy đọc get_ahm_spec trước. Bình luận được gán cho người dùng đã đăng nhập mà máy khách này thay mặt và xuất hiện trong các phản hồi get_card / get_epic sau đó. Bình luận không thể chỉnh sửa qua MCP; delete_comment xóa bình luận của chính bạn (sửa lỗi bằng cách xóa + đăng lại). Truyền parent_comment_id để trả lời một bình luận hiện có. Chuỗi chỉ sâu một cấp: trả lời một câu trả lời sẽ gắn bình luận mới vào gốc chuỗi của câu trả lời đó, vì vậy đừng cố lồng các câu trả lời. Bình luận cha phải là bình luận trên cùng thẻ hoặc epic — uid từ bất kỳ nơi nào khác sẽ bị từ chối.

Tham số	Kiểu	Bắt buộc	Mô tả
card_id	string		UID thẻ để bình luận (loại trừ lẫn nhau với epic_id)
epic_id	string		UID epic để bình luận (loại trừ lẫn nhau với card_id)
content	string	có	Nội dung bình luận dưới dạng AgileHero Markup (AHM)
parent_comment_id	string		UID tùy chọn của một bình luận trên CÙNG thẻ hoặc epic để trả lời. Bỏ qua cho bình luận cấp cao nhất. Trả lời một câu trả lời sẽ chuẩn hóa về gốc chuỗi của câu trả lời đó (chuỗi chỉ sâu một cấp).

delete_commentdestructive

Xóa một bình luận BẠN đã đăng (bình luận được gán cho người dùng đã đăng nhập mà máy khách này thay mặt — bình luận của người khác không thể xóa). Mẫu sửa lỗi là xóa + đăng lại bình luận đã sửa bằng create_comment. Một bình luận đã xóa có câu trả lời vẫn hiển thị như một bia mộ trong chuỗi của nó. UID bình luận đến từ get_card / get_epic.

Tham số	Kiểu	Bắt buộc	Mô tả
id	string	có	UID của bình luận