AgileHero

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

AgileHero mengirimkan server MCP bawaan: tambahkan satu URL ke asisten AI yang mendukung MCP, masuk dengan akun AgileHero Anda, dan server tersebut mengerjakan proyek Anda dengan izin yang persis sama dengan Anda — 49 alat di seluruh papan, backlog, epik, wiki, papan tulis, retrospektif, dan peta jalan. Referensi ini dibuat dari server itu sendiri, sehingga selalu terkini.

Baru di sini? Mulailah dengan ringkasan agen AI, atau langsung lompat ke menghubungkan klien Anda di bawah. Teks kaya di mana pun di server ini adalah AgileHero Markup (AHM) — dialek XML yang ketat dan tervalidasi yang dirancang agar agen tidak pernah merusak konten manusia. Menulis skrip alih-alih menghubungkan asisten? Referensi REST API menggunakan masuk OAuth yang sama.

Hubungkan klien AI Anda

Menghubungkan berarti dua hal: tambahkan URL endpoint ke klien Anda, lalu masuk dengan akun AgileHero Anda saat klien memintanya. Tidak ada kunci yang perlu dibuat atau ditempel. Setelah terhubung, klien bertindak sebagai Anda, dengan izin yang persis sama; setiap klien yang terhubung tercantum di bawah Pengaturan → Klien AI di aplikasi, tempat Anda dapat mencabutnya kapan saja. Pengamat tidak dapat menggunakan server MCP: ruang kerja tempat Anda menjadi pengamat tidak tercantum, dan semua yang ada di dalamnya terbaca sebagai tidak ditemukan.

Endpoint

https://mcp.agilehero.io/mcp

Transport

Streamable HTTP (POST)

Masuk

Klien AI Anda membuka jendela browser; setujui sekali, cabut kapan saja di Pengaturan → Klien AI.

Claude Code

Jalankan sekali di terminal; Claude Code menyimpan server di konfigurasi tingkat pengguna Anda dan masuk melalui browser Anda.

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

• Semua flag harus ditempatkan sebelum nama server.
• Lalu jalankan /mcp di dalam sesi Claude Code dan pilih Authenticate (atau jalankan claude mcp login agilehero) dan setujui masuk di browser Anda.

Verifikasi: Jalankan claude mcp list — agilehero akan muncul sebagai terhubung. Jika muncul "needs authentication", jalankan claude mcp login agilehero.

Dokumentasi Claude Code · diverifikasi terhadap dokumen vendor pada 2026-09-15

VS Code (GitHub Copilot)

Tambahkan ke .vscode/mcp.json di ruang kerja, atau jalankan "MCP: Open User Configuration" untuk semua ruang kerja. Jendela browser terbuka untuk masuk saat pertama kali server dimulai.

.vscode/mcp.json

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

• "type": "http" wajib — tanpanya VS Code memperlakukan URL sebagai perintah untuk dijalankan.

Verifikasi: Jalankan "MCP: List Servers", mulai agilehero, selesaikan masuk di browser, dan periksa bahwa alat-alatnya muncul di tampilan Chat.

Dokumentasi VS Code (GitHub Copilot) · diverifikasi terhadap dokumen vendor pada 2026-09-15

Codex

Tambahkan dari terminal, lalu masuk — konfigurasi dibagikan oleh Codex CLI, ekstensi IDE, dan aplikasi desktop ChatGPT.

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

• Codex tidak memulai masuk dengan sendirinya — jalankan codex mcp login agilehero setelah menambahkan server.

Verifikasi: Jalankan codex mcp list — agilehero akan muncul sebagai terautentikasi; lalu minta Codex untuk mencantumkan proyek AgileHero Anda.

Dokumentasi Codex · diverifikasi terhadap dokumen vendor pada 2026-09-15

Zed

Tambahkan ke settings.json, atau gunakan Pengaturan → AI → MCP Servers → Add Remote Server; Zed meminta Anda untuk masuk.

~/.config/zed/settings.json

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

• Biarkan header kosong — Zed memulai masuk hanya jika tidak ada header Authorization yang dikonfigurasi.

Verifikasi: Mulai ulang Zed, setujui masuk di browser Anda saat diminta, dan minta untuk mencantumkan proyek AgileHero Anda — panggilan pertama yang berhasil mengonfirmasi koneksi.

Dokumentasi Zed · diverifikasi terhadap dokumen vendor pada 2026-09-15

GitHub Copilot CLI

Tambahkan ke ~/.copilot/mcp-config.json, atau .mcp.json di dalam repositori.

~/.copilot/mcp-config.json

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

• Membutuhkan GitHub Copilot CLI 1.0.83 atau lebih baru (dukungan Client ID Metadata Document).
• Copilot CLI membuka masuk saat server pertama kali memintanya; Anda juga dapat menjalankan /mcp auth agilehero di dalam sesi.

Verifikasi: Jalankan /mcp di dalam Copilot CLI — agilehero akan tercantum sebagai terhubung dengan alat-alatnya.

Dokumentasi GitHub Copilot CLI · diverifikasi terhadap dokumen vendor pada 2026-09-15

Claude (web, desktop, Cowork)

Tambahkan AgileHero sebagai konektor kustom dan masuk; konektor tersedia di Claude di web, Claude Desktop, Cowork, dan aplikasi seluler.

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

• Konektor juga muncul di Claude Code saat masuk dengan akun Claude yang sama.
• Paket gratis: satu konektor kustom. Tim dan Enterprise: Pemilik menambahkan konektor, dan setiap anggota masuk dengan akun AgileHero mereka sendiri.

Verifikasi: Mulai obrolan baru — AgileHero tercantum di bawah konektor, dan meminta Claude untuk mencantumkan proyek AgileHero Anda berhasil.

Dokumentasi Claude (web, desktop, Cowork) · diverifikasi terhadap dokumen vendor pada 2026-09-15

ChatGPT

Buat konektor dalam mode Developer dan masuk dengan OAuth.

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

• Tersedia di Plus, Pro, Business, Enterprise dan Edu dengan mode Developer diaktifkan; di ruang kerja, admin atau pemilik menerbitkan konektor untuk anggota.

Verifikasi: Buka obrolan baru dengan konektor AgileHero diaktifkan dan minta ChatGPT untuk mencantumkan proyek AgileHero Anda.

Dokumentasi ChatGPT · diverifikasi terhadap dokumen vendor pada 2026-09-15

Klien lain

Klien MCP apa pun yang mendukung OAuth dengan Client ID Metadata Documents: tambahkan endpoint sebagai server jarak jauh (Streamable HTTP) dan setujui masuk di browser Anda.

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

• Klien yang hanya mendukung token statis atau header tidak dapat terhubung — AgileHero hanya menggunakan masuk OAuth.

Verifikasi: Mulai ulang klien, setujui masuk di browser Anda saat diminta, dan minta untuk mencantumkan proyek AgileHero Anda — panggilan pertama yang berhasil mengonfirmasi koneksi.

Dokumentasi klien lain · diverifikasi terhadap dokumen vendor pada 2026-09-15

Belum didukung

Klien-klien ini belum dapat masuk ke AgileHero. Sebagian besar tidak mendukung Client ID Metadata Documents, metode pendaftaran klien OAuth yang digunakan AgileHero (rekomendasi MCP saat ini); kami memeriksa ulang dokumentasi vendor secara berkala dan memindahkan klien ke atas segera setelah memenuhi syarat.

CursorBelum

Cursor belum mendukung Client ID Metadata Documents (masuk OAuth-nya memerlukan Dynamic Client Registration atau klien yang terdaftar sebelumnya), sehingga belum dapat terhubung ke AgileHero untuk saat ini.

Dokumentasi Cursor · diverifikasi terhadap dokumen vendor pada 2026-09-15

OpenCodeBelum

OpenCode belum mendukung Client ID Metadata Documents (masuk OAuth-nya memerlukan Dynamic Client Registration atau klien yang terdaftar sebelumnya), sehingga belum dapat terhubung ke AgileHero untuk saat ini.

Dokumentasi OpenCode · diverifikasi terhadap dokumen vendor pada 2026-09-15

Gemini CLIBelum

Gemini CLI belum mendukung Client ID Metadata Documents (masuk OAuth-nya memerlukan Dynamic Client Registration atau klien yang terdaftar sebelumnya), sehingga belum dapat terhubung ke AgileHero untuk saat ini.

Dokumentasi Gemini CLI · diverifikasi terhadap dokumen vendor pada 2026-09-15

ClineBelum

Cline belum mendukung Client ID Metadata Documents (masuk OAuth-nya memerlukan Dynamic Client Registration atau klien yang terdaftar sebelumnya), sehingga belum dapat terhubung ke AgileHero untuk saat ini.

Dokumentasi Cline · diverifikasi terhadap dokumen vendor pada 2026-09-15

Google AntigravityBelum

Google Antigravity belum mendukung Client ID Metadata Documents (masuk OAuth-nya memerlukan Dynamic Client Registration atau klien yang terdaftar sebelumnya), sehingga belum dapat terhubung ke AgileHero untuk saat ini.

Dokumentasi Google Antigravity · diverifikasi terhadap dokumen vendor pada 2026-09-15

AmpBelum

Amp belum mendukung Client ID Metadata Documents (masuk OAuth-nya memerlukan Dynamic Client Registration atau klien yang terdaftar sebelumnya), sehingga belum dapat terhubung ke AgileHero untuk saat ini.

Dokumentasi Amp · diverifikasi terhadap dokumen vendor pada 2026-09-15

Raycast AIBelum

Raycast AI belum mendukung Client ID Metadata Documents (masuk OAuth-nya memerlukan Dynamic Client Registration atau klien yang terdaftar sebelumnya), sehingga belum dapat terhubung ke AgileHero untuk saat ini.

Dokumentasi Raycast AI · diverifikasi terhadap dokumen vendor pada 2026-09-15

KiroBelum

Kiro masuk dengan URL Client ID Metadata Document yang Anda berikan, dan AgileHero belum menghosting Client ID Metadata Document untuk itu.

Dokumentasi Kiro · diverifikasi terhadap dokumen vendor pada 2026-09-15

WarpBelum

Warp belum memiliki masuk OAuth untuk server yang ditambahkan pengguna, sehingga belum dapat terhubung ke AgileHero untuk saat ini.

Dokumentasi Warp · diverifikasi terhadap dokumen vendor pada 2026-09-15

JetBrains AI AssistantBelum

JetBrains AI Assistant belum memiliki masuk OAuth untuk server jarak jauh, dan jembatan mcp-remote akan memerlukan dokumen klien yang dihosting — AgileHero belum menghosting Client ID Metadata Document untuk itu.

Dokumentasi JetBrains AI Assistant · diverifikasi terhadap dokumen vendor pada 2026-09-15

ContinueBelum

Continue belum memiliki masuk OAuth untuk server Streamable HTTP, dan jembatan mcp-remote akan memerlukan dokumen klien yang dihosting — AgileHero belum menghosting Client ID Metadata Document untuk itu.

Dokumentasi Continue · diverifikasi terhadap dokumen vendor pada 2026-09-15

Instruksi server

Setiap klien MCP menerima konvensi ini pada waktu inisialisasi:

Server MCP AgileHero.

Setiap parameter id dan setiap id dalam respons adalah uid pendek — selalu gunakan uid yang dikembalikan oleh alat list/get/search, jangan pernah membuat sendiri. Sebagian besar alat memerlukan uid proyek — panggil list_projects terlebih dahulu untuk menemukan ruang kerja dan proyek. Lebih suka search (teks lengkap, semua jenis konten) daripada search_cards (substring judul, satu proyek).

Pada alat pembaruan, lebih suka bidang delta add_*/remove_* untuk koleksi (inkremental, aman); bidang koleksi biasa (assigned_to, labels, checklists, cards_relations, links, attachments) MENGGANTI status sebelumnya dan tidak dapat digabungkan dengan delta-nya. Item checklist adalah { description, checked }. Kejar perubahan dengan updated_since pada list_cards / list_epics.

Gunakan move_card (bukan update_card) untuk mengubah daftar atau posisi kartu; list_id kosong berarti backlog.

Alat wiki, papan tulis, retrospektif, dan peta jalan memerlukan ruang kerja proyek pada paket Pro atau uji coba. Penulisan elemen papan tulis adalah alat batch dan semua-atau-tidak sama sekali; uid elemen berasal dari get_whiteboard. Item retrospektif dikelola dengan add_retro_items dan move_retro_item (move_card menolak kartu retrospektif).

Batas harian: panggilan alat diukur per pengguna per ruang kerja — 500/hari pada paket Gratis, 5.000/hari pada Pro atau uji coba, diatur ulang pada 00:00 UTC. get_ahm_spec dan list_projects tidak pernah dihitung (juga tidak ada panggilan yang tidak dapat diatribusikan ke satu ruang kerja, seperti pencarian tanpa cakupan). Melebihi batas, alat mengembalikan kesalahan batas harian hingga pengaturan ulang atau peningkatan paket.

SEMUA teks kaya (halaman wiki, deskripsi kartu/epik, komentar) adalah AgileHero Markup (AHM) — XML ketat, JANGAN PERNAH markdown atau HTML; panggil get_ahm_spec sekali sebelum menulis apa pun. Pengeditan teks kaya adalah dua langkah secara desain: preview_wiki_page_update / preview_description_update (konsekuensi + preview_token), lalu alat pembaruan yang cocok dengan token tersebut.

Dokumentasi alat lengkap: https://agilehero.io/docs/mcp

Spesifikasi AHM: https://agilehero.io/docs/mcp/agilehero-markup

Alat (49)

list_projectsread-only

Cantumkan setiap ruang kerja dan proyek yang dapat diakses oleh pengguna token, sehingga agen dapat menyelesaikan uid proyek yang diperlukan oleh sebagian besar alat lainnya. Panggil ini terlebih dahulu setiap kali uid proyek tidak diketahui — jangan pernah meminta pengguna untuk menempelkan satu. Mengembalikan ruang kerja (uid, nama, paket, peran Anda) dengan proyek-proyeknya (uid, nama, url). Alat pilar Pro (wiki, metrik) memerlukan paket ruang kerja menjadi pro atau uji coba.

searchread-only

Pencarian teks lengkap global produk (OpenSearch): kartu, epik, halaman wiki, dan proyek, yang cocok dengan judul, deskripsi, komentar, item daftar periksa, dan nama file lampiran, diurutkan berdasarkan relevansi dengan penambah bobot kebaruan. Gunakan ini untuk menemukan apa pun berdasarkan konten ("kartu tempat kita membahas migrasi"); gunakan search_cards hanya untuk pencarian substring judul di dalam satu proyek. Setiap hasil membawa tipe, uid yang siap untuk tindakan (kartu memberi get_card/update_card, epik memberi get_epic, wiki_pages memberi show_wiki_page, proyek memberi parameter project_id), url tautan dalam, dan cuplikan yang disorot <mark> yang menunjukkan mengapa hasil tersebut cocok. Secara opsional, batasi dengan project_id atau assigned_to_me. Lakukan paginasi dengan page/per_page; total_count adalah jumlah kecocokan penuh.

Parameter	Tipe	Wajib	Deskripsi
query	string	ya	Kueri pencarian teks bebas
project_id	string		Uid proyek opsional untuk membatasi pencarian
assigned_to_me	boolean		Hanya hasil yang ditugaskan ke pengguna token
page	integer		Nomor halaman (default 1)
per_page	integer		Hasil per halaman, 1-50 (default 20)

get_cardhanya-baca

Baca satu kartu secara lengkap: deskripsi AgileHero Markup dengan id blok plus description_version (dua input yang diterima preview_description_update / update_description), penempatan daftar, epik, label, penugasan, pelapor, tipe, estimasi, tanggal jatuh tempo, daftar periksa, tautan, lampiran, kartu terkait, dan komentar berutas. Hanya menerima uid kartu — tidak ada parameter project_id. Uid kartu berasal dari list_cards, search, atau search_cards.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Pengidentifikasi unik kartu

get_epichanya-baca

Baca satu epik secara lengkap: deskripsi AgileHero Markup dengan id blok plus description_version (dua input yang diterima preview_description_update / update_description), nama, nomor, warna, tanggal mulai/selesai, penugasan, daftar periksa, tautan, lampiran, setiap kartu di dalamnya (uid, nomor, judul, dan daftarnya dengan kategori — daftar null = backlog — dalam urutan papan, jadi ini adalah cara untuk mencantumkan semua kartu dari sebuah epik dan melihat mana yang harus dikerjakan, sedang berlangsung, atau selesai) dan komentar berutas. Hanya menerima uid epik — tidak ada parameter project_id. Uid epik berasal dari list_epics atau search.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Pengidentifikasi unik epik

list_wiki_pathsPro · wikihanya-baca

Cantumkan seluruh pohon wiki proyek dalam urutan tampilan — setiap folder dan halaman dengan uid, nama, tipe (halaman atau folder), dan parent_id — sehingga agen dapat menyelesaikan uid halaman yang diterima show_wiki_page dan memilih parent_id untuk create_wiki_page. Membutuhkan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik proyek

show_wiki_pagePro · wikihanya-baca

Ambil halaman wiki sebagai AgileHero Markup (AHM) dengan document_version-nya. Konten adalah AHM, bukan markdown — id blok, jangkar <discussion>, dan referensi <image/>/<attachment/> adalah bagian dari dokumen; baca get_ahm_spec sebelum mengedit. Edit melalui preview_wiki_page_update lalu update_wiki_page, menggunakan id blok dan document_version yang dikembalikan di sini. Membutuhkan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Pengidentifikasi unik jalur halaman

get_ahm_spechanya-baca

Spesifikasi AgileHero Markup (AHM) v1.0 — SATU-SATUNYA format teks kaya yang diterima AgileHero (markdown dan HTML ditolak). Baca ini SEKALI sebelum menulis atau mengedit teks kaya apa pun (halaman wiki, deskripsi kartu/epik, komentar): kosakata, atribut, aturan pelolosan, dan contoh yang dikerjakan. Teks yang sama di web: https://agilehero.io/docs/mcp/agilehero-markup

create_wiki_pagePro · wiki

Buat halaman wiki (opsional di dalam folder) dengan konten AgileHero Markup (AHM). Konten harus dibungkus dalam <agile-hero-markup version="1.0"> — markdown dan HTML ditolak; baca get_ahm_spec terlebih dahulu. Mengembalikan uid, url, document_version, dan konten halaman baru. Membutuhkan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik (uid) proyek
name	string	ya	Judul halaman
parent_id	string		Uid folder opsional (dari list_wiki_paths)
content	string		Isi halaman sebagai AHM; abaikan untuk halaman kosong

preview_wiki_page_updatePro · wikihanya-baca

Langkah pertama yang WAJIB untuk setiap pembaruan halaman wiki: memvalidasi operasi dan mengembalikan konsekuensi yang dihitung server (blok yang ditambahkan/dihapus/diubah, file yang akan dihapus permanen, diskusi tim yang akan kehilangan jangkarnya, peringatan kemungkinan-markdown) plus preview_token yang dibutuhkan update_wiki_page. Tidak ada yang dimodifikasi. Operasi dialamatkan per blok (replace_block / insert_after / delete_block / move_block) dengan konten AHM — baca get_ahm_spec terlebih dahulu, dan dapatkan id blok + document_version dari show_wiki_page. Tinjau konsekuensi sebelum menyimpan: penghapusan file yang terdaftar atau pelepasan jangkar diskusi hanya dapat diterima jika pengguna memintanya. Membutuhkan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Uid jalur halaman
document_version	string	ya	Dari show_wiki_page — membuktikan kesegaran
operations	array of object	ya	Diterapkan secara berurutan terhadap dokumen yang berkembang

update_wiki_pagePro · wikimerusak

Terapkan pembaruan yang telah dipratinjau sebelumnya ke halaman wiki. Membutuhkan preview_token dari preview_wiki_page_update untuk PERSIS operasi ini dan document_version ini — menyimpan tanpa pratinjau tidak mungkin secara desain. Setiap penyimpanan membuat versi halaman yang dapat dikembalikan manusia di aplikasi. Mengembalikan halaman yang diperbarui (AHM + document_version baru) dan konsekuensi yang diterapkan. Membutuhkan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Uid jalur halaman
document_version	string	ya	Versi tempat pratinjau diambil
operations	array of object	ya	Operasi persis yang dipratinjau
preview_token	string	ya	Dari preview_wiki_page_update

preview_description_updatehanya-baca

Langkah pertama yang WAJIB untuk setiap pengeditan deskripsi kartu atau epik: memvalidasi operasi blok dan mengembalikan konsekuensi yang dihitung server plus preview_token yang dibutuhkan update_description. Tidak ada yang dimodifikasi. Konten adalah AgileHero Markup (AHM, permukaan deskripsi: tanpa tabel, warna, perataan, diskusi, atau lampiran file) — baca get_ahm_spec terlebih dahulu; id blok dan document_version berasal dari get_card / get_epic.

Parameter	Tipe	Wajib	Deskripsi
resource_type	enum: card | epic	ya
id	string	ya	Uid kartu atau epik
document_version	string	ya	Dari get_card / get_epic
operations	array of object	ya	Diterapkan secara berurutan terhadap deskripsi yang berkembang

update_descriptionmerusak

Terapkan pembaruan deskripsi yang telah dipratinjau sebelumnya ke kartu atau epik. Membutuhkan preview_token dari preview_description_update untuk PERSIS operasi ini dan document_version ini — menyimpan tanpa pratinjau tidak mungkin secara desain. Mengembalikan deskripsi yang diperbarui (AHM + document_version baru).

Parameter	Tipe	Wajib	Deskripsi
resource_type	enum: card | epic	ya
id	string	ya	Uid kartu atau epik
document_version	string	ya	Versi tempat pratinjau diambil
operations	array of object	ya	Operasi persis yang dipratinjau
preview_token	string	ya	Dari preview_description_update

list_whiteboardsPro · whiteboardhanya-baca

Cantumkan papan tulis dari sebuah proyek (uid, nama, jumlah elemen, url). Gunakan get_whiteboard untuk membaca elemen papan. Membutuhkan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik proyek

create_whiteboardPro · whiteboard

Buat papan tulis kosong di sebuah proyek. Tambahkan konten dengan create_whiteboard_elements. Membutuhkan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik proyek
name	string	ya	Nama papan tulis

get_whiteboardPro · whiteboardhanya-baca

Baca papan tulis sebagai representasi teks ringkas: batas papan plus satu baris per elemen — "<type> <uid> di <x>,<y> ukuran <w>x<h> [warna] [induk <frame-uid>] [tertaut <card|epic> <uid>] \"teks\"", konektor sebagai "konektor <uid> <from> -> <to>". Uid elemen dari sini adalah pegangan yang diambil setiap alat tulis papan tulis. Membutuhkan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Pengidentifikasi unik papan tulis

create_whiteboard_elementsPro · whiteboard

Buat hingga 100 elemen papan tulis dalam satu panggilan transaksional (semua-atau-tidak sama sekali, satu peristiwa realtime). Ukuran asli, warna, dan penempatan teks diterapkan di sisi server — biasanya berikan hanya tipe + teks (+ warna). Abaikan x/y dan elemen akan diatur otomatis (kisi secara default; atur: baris|kolom|kisi, origin_x/origin_y/gap untuk menyesuaikan); berikan x/y untuk kontrol penuh. Bingkai berisi elemen melalui parent_id (uid bingkai yang ada) atau parent_ref (ref bingkai yang lebih awal dalam PANGGILAN ini). Konektor mengikat elemen dengan uid (source_id/target_id) atau ref batch (source_ref/target_ref) — tidak pernah koordinat; jangkar dihitung oleh UI. Membutuhkan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
whiteboard_id	string	ya	Pengidentifikasi unik papan tulis
elements	array of object	ya	Dibuat dalam urutan array — ref hanya menyelesaikan ke belakang
arrange	enum: grid | row | column		Tata letak untuk elemen tanpa x/y eksplisit (kisi default)
origin_x	number		Mulai x pengaturan otomatis (default 100)
origin_y	number		Mulai y pengaturan otomatis (default 100)
gap	number		Jarak pengaturan otomatis dalam px (default 20)

create_whiteboard_diagramPro · whiteboard

Gambar diagram (diagram alir, proses, grafik ketergantungan) di papan tulis dari grafik semantik — node, tepi, grup opsional, TANPA koordinat: server melakukan tata letak berlapis dari atas ke bawah dengan ukuran asli dan mengembalikan uid elemen yang dibuat dengan kunci id node Anda. Ditempatkan di bawah konten papan yang ada. Transaksional (semua-atau-tidak sama sekali, satu peristiwa realtime). Maks 20 node — bagi alur yang lebih besar menjadi dua diagram. Pertahankan bentuk polos (persegi panjang) kecuali semantik menuntutnya (belah ketupat = keputusan, stadion = mulai/selesai, silinder = penyimpanan data). Edit hasilnya dengan update_whiteboard_elements — tata letak tidak pernah dijalankan lagi. Membutuhkan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
whiteboard_id	string	ya	Pengidentifikasi unik papan tulis
title	string		Judul diagram (judul bingkai, atau judul saat grup digunakan)
nodes	array of object	ya
edges	array of object
groups	array of object
origin_x	number		Opsional kiri-atas x; default di bawah konten yang ada
origin_y	number		Opsional kiri-atas y; default di bawah konten yang ada

update_whiteboard_elementsPro · whiteboard

Perbarui hingga 100 elemen papan tulis dalam satu panggilan all-or-nothing: pindahkan (x/y), ubah ukuran, susun ulang (z_index), ubah teks, ubah warna, ubah induk (parent_id — uid bingkai, atau "" untuk melepas), dan panah/jalur/label konektor. Uid elemen berasal dari get_whiteboard; tipe elemen tidak dapat diubah. Hanya kolom yang disediakan yang berubah — properti yang tidak terkait dipertahankan. Memerlukan workspace Pro atau trial.

Parameter	Tipe	Wajib	Deskripsi
whiteboard_id	string	ya	Pengidentifikasi unik papan tulis
updates	array of object	ya

delete_whiteboard_elementsPro · whiteboarddestructive

Hapus hingga 100 elemen papan tulis dalam satu panggilan transaksional. Menghapus bingkai atau simpul peta pikiran melepaskan anak-anaknya ke papan (mereka TIDAK dihapus — sertakan uid mereka secara eksplisit untuk menghapusnya juga). Konektor yang terpasang pada elemen yang dihapus tidak dihapus dan akan menggantung. Uid elemen berasal dari get_whiteboard. Memerlukan workspace Pro atau trial.

Parameter	Tipe	Wajib	Deskripsi
whiteboard_id	string	ya	Pengidentifikasi unik papan tulis
ids	array of string	ya	Uid elemen yang akan dihapus

review_whiteboardPro · whiteboardread-only

Jalankan pemeriksaan kualitas deterministik pada papan tulis: teks yang kemungkinan meluap dari elemennya, elemen yang tumpang tindih secara terlihat, konektor dengan titik akhir yang tidak terikat atau menggantung, warna di luar palet UI, posisi di luar grid, dan elemen yang induknya telah dihapus. Bersifat advisori — temuan adalah saran, bukan kesalahan, dan papan dengan temuan mungkin persis seperti yang diinginkan pengguna. Gunakan setelah menggambar untuk pemeriksaan kewarasan, perbaiki paling banyak sekali, dan jangan berulang mengejar laporan kosong. Memerlukan workspace Pro atau trial.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Pengidentifikasi unik papan tulis

convert_whiteboard_elementPro · whiteboard

Ubah elemen papan tulis menjadi item backlog: catatan tempel menjadi kartu atau epik, atau bingkai menjadi epik (anak-anak catatan tempel bingkai menjadi kartu pada epik tersebut; anak yang sudah dikonversi ditetapkan ulang, tidak diduplikasi). Elemen tetap di papan, tertaut dengan apa yang dihasilkannya — get_whiteboard menampilkan tautan tersebut. Elemen hanya dapat dikonversi sekali. Teks catatan/bingkai menjadi judul kecuali Anda memberikan satu. Memerlukan workspace Pro atau trial.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Uid elemen (sticky_note atau frame, dari get_whiteboard)
to	enum: card | epic	ya	Apa yang akan dibuat
title	string		Judul kartu / nama epik; default ke teks elemen
list_id	string		Hanya kartu: uid daftar target; abaikan untuk backlog
color	string		Hanya epik: warna hex; default ke warna elemen

convert_mind_mapPro · whiteboard

Ubah peta pikiran menjadi item backlog dengan pemetaan per simpul: akar dapat menjadi epik baru (peran "epic") atau menempel ke epik yang ada (peran "existing_epic" + target_epic_id); simpul lain menjadi kartu pada epik tersebut (peran "card") atau label proyek (peran "label" — simpul label di atas simpul kartu di pohon diterapkan ke kartu tersebut); peran "skip" mengabaikan simpul. Berikan uid elemen ROOT sebagai id dan setiap simpul yang ingin Anda konversi di nodes (simpul yang tidak terdaftar diabaikan). Satu konversi per simpul: simpul yang sudah dikonversi ditolak di awal — kirim ulang tanpa simpul tersebut. Memerlukan workspace Pro atau trial.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Uid simpul ROOT peta pikiran (dari get_whiteboard)
nodes	array of object	ya
target_epic_id	string		Uid epik, wajib dengan peran "existing_epic" pada akar

list_retrospectivesPro · retrospectivesread-only

Daftarkan retrospektif proyek: retrospektif model baru dan pemeriksaan kesehatan jika workspace memilikinya, papan retrospektif klasik jika tidak. Entri model baru memiliki uid, name, kind (retro | health_check), status (open | live | closed), date (starts_on; closes_on untuk pemeriksaan kesehatan), tahap saat ini, template, uid fasilitator, jumlah aksi yang dibuatnya, dan url; respons menambahkan open_actions_count proyek. Gunakan get_retrospective untuk gambaran lengkap. Memerlukan workspace Pro atau trial.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik proyek

create_retrospectivePro · retrospectives

Buat retrospektif: retrospektif model baru jika workspace memilikinya, papan retrospektif klasik jika tidak; respons adalah retrospektif seperti yang dikembalikan get_retrospective (kolom dengan uid-nya), sehingga add_retro_items dapat segera menyusul. Retrospektif model baru berasal dari template (default went_well), terbuka untuk catatan segera dan memiliki Anda sebagai fasilitator; opsional: fokus, anonimitas (default: template), participant_ids (retro Anggota Terpilih; abaikan untuk setiap anggota proyek dengan akses tulis), jenis pertanyaan check_in dan feedback, dan suara. Fasilitator memulainya dan menjalankan tahapannya di aplikasi. Papan klasik hanya menerima name, date, dan previous_retrospective_id serta menolak argumen model baru. Memerlukan workspace Pro atau trial.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik proyek
name	string	ya	Nama retrospektif
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		Kunci template; default went_well
starts_on	string		Tanggal, ISO-8601 (YYYY-MM-DD); default hari ini
starts_at	string		Alias usang dari starts_on
focus	string		Tentang apa retrospektif ini, ditampilkan di bawah namanya
anonymity	enum: anonymous | optional | named		Siapa yang ditampilkan pada catatan: anonim, opsional (penulis dapat menambahkan nama) atau bernama
participant_ids	array of string		Uid pengguna peserta (list_project_users); Anda selalu salah satunya
check_in	enum: safety | mood | esvp | one_word		Pertanyaan check-in (default safety)
feedback	enum: roti | pulse | one_word		Pertanyaan umpan balik penutup (default roti)
votes	object		Pengaturan suara: budget (auto | fixed | unlimited), per_person (1-20), max_per_topic (1-10)
previous_retrospective_id	string		Hanya papan klasik: uid retrospektif sebelumnya yang kolom Actions-nya ditampilkan sebagai "Past actions"

get_retrospectivePro · retrospectivesread-only

Baca retrospektif seperti yang mungkin Anda lihat: retrospektif model baru atau pemeriksaan kesehatan jika workspace memilikinya, papan retrospektif klasik jika tidak. Retrospektif model baru mengembalikan pengaturan, tahapan (tahap saat ini, pengatur waktu, kemajuan), kolom (dengan uid) yang menampung topik (grup catatan, dengan uid), penghitungan check-in dan umpan balik, sisa suara Anda, antrean Diskusi dan topik yang diparkir, proposal, aksi (yang dibuatnya plus yang terbuka dari proyek) dan, setelah ditutup, ringkasannya. Privasi mengikuti ruangan: sebelum pengungkapan Anda hanya mendapatkan catatan Anda sendiri (setiap kolom menghitung milik semua orang), penulis hanya pada catatan bernama, total suara hanya setelah suara diungkapkan. Pemeriksaan kesehatan mengembalikan dimensi dan partisipasinya, penilaian Anda sendiri saat terbuka, dan agregat per dimensi setelah ditutup. Memerlukan workspace Pro atau trial.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Uid retrospektif (dari list_retrospectives)

add_retro_itemsPro · retrospectives

Tambahkan item ke retrospektif sebagai diri Anda sendiri, beberapa sekaligus: catatan pada retrospektif model baru jika workspace memilikinya, kartu pada papan retrospektif klasik jika tidak. Setiap item adalah { column, text, recipient_id? }: column adalah judul kolom (tidak peka huruf besar/kecil) atau uid dari get_retrospective; text hingga 1000 karakter (255 pada papan klasik); recipient_id, uid pengguna rekan yang diberi terima kasih, wajib di kolom kudos model baru dan ditolak pada papan klasik. Catatan model baru memulai topiknya sendiri dan orang lain melihatnya setelah catatan diungkapkan; catatan diambil hanya saat retrospektif terbuka untuk catatan atau dalam tahap Tulis, jika tidak panggilan ditolak dengan kode wrong_stage dan tahap saat ini. Kegagalan PARSIAL: item yang valid ditambahkan, item yang tidak valid dilaporkan per indeks — periksa array "failed". Memerlukan workspace Pro atau trial.

Parameter	Tipe	Wajib	Deskripsi
retrospective_id	string	ya	Uid retrospektif
items	array of object	ya

move_retro_itemPro · retrospectives

Pindahkan item retrospektif: kelompokkan ulang catatan pada retrospektif model baru jika workspace memilikinya, pindahkan kartu ke kolom lain pada papan retrospektif klasik jika tidak. Model baru, hanya tahap Grup: topic_id menempatkan catatan ke dalam topik tersebut (grup catatan); column (judul atau uid) menjadikannya topik sendiri di sana, pada posisi di antara topik kolom (abaikan untuk terakhir). Berikan expected_updated_at, topic updated_at catatan dari get_retrospective, untuk ditolak dengan kode stale ketika seseorang mengelompokkannya ulang sementara itu. Di luar Grup panggilan ditolak dengan kode wrong_stage dan tahap saat ini; kudos dan catatan lain tidak pernah bercampur. Papan klasik hanya menerima column dan position (position diabaikan = atas). Memerlukan workspace Pro atau trial.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Uid catatan (papan klasik: uid item) dari get_retrospective
topic_id	string		Uid topik target; tinggalkan column
column	string		Judul atau uid kolom target
position	integer		Indeks di kolom target (0 = pertama)
expected_updated_at	string		topic updated_at catatan seperti yang terakhir dibaca (pemeriksaan konflik)

list_project_usersread-only

Daftarkan anggota proyek — setiap anggota workspace untuk proyek standar; pembuat, pemilik dan admin workspace, dan siapa pun yang ditambahkan secara eksplisit untuk proyek pribadi — sehingga agen dapat menyelesaikan uid penugasan alih-alih menebak nama. Mengembalikan uid setiap anggota, nama lengkap, email, dan peran workspace (owner, admin, member, atau observer). Uid tersebut adalah yang diterima assigned_to pada create_card, update_card, create_epic, update_epic, dan create_roadmap_slot.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik proyek

list_board_listsread-only

Daftarkan daftar papan kanban proyek sehingga agen dapat menyelesaikan tujuan move_card yang valid. Mengembalikan setiap daftar aktif dalam urutan tampilan dengan uid-nya (dapat digunakan sebagai target move_card) dan nama tampilan. Backlog disertakan sebagai entri yang dapat dipilih dengan id string kosong.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik (uid) proyek

list_epicsread-only

Daftarkan epik proyek sehingga agen dapat menyelesaikan uid epik untuk get_epic dan penugasan kartu. Mengembalikan setiap epik dalam urutan tampilan (posisi naik) dengan uid, nomor, nama, deskripsi (Markdown), warna, tanggal mulai/selesai, dan jumlah kartu.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik (uid) proyek
updated_since	string		Hanya epik yang catatannya berubah pada atau setelah tanggal atau datetime ISO-8601 ini. Catatan: pengeditan koleksi (daftar periksa, tautan) mungkin tidak menaikkan waktu perubahan epik; pengeditan nama/tanggal/deskripsi selalu melakukannya.

list_labelsread-only

Daftarkan label proyek sehingga agen dapat menggunakan kembali taksonomi yang ada alih-alih membuat hampir duplikat pada penulisan kartu. Mengembalikan setiap label dalam urutan tampilan (posisi naik) dengan uid, nama, dan posisinya.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik (uid) dari proyek

list_cardshanya-baca

Mencantumkan kartu-kartu dari satu daftar kanban, atau dari backlog proyek ketika list_id dihilangkan atau kosong, dalam urutan tampilan papan (bagian atas kolom terlebih dahulu, yaitu posisi penempatan menurun — urutan yang sama seperti yang ditampilkan UI produk). Filter digabungkan dengan AND: epic_id, label_id, assigned_user_id, dan reporter_id menggunakan uid (uid yang tidak dikenal tidak cocok dengan apa pun); due_date menyimpan kartu yang jatuh tempo pada atau sebelum tanggal yang diberikan. Mengembalikan ringkasan kartu yang cukup untuk tindakan (uid, judul, daftar + posisi, epik, label, penugas, pelapor, tanggal jatuh tempo) yang siap untuk get_card / move_card / update_card, dengan paginasi menggunakan limit (default 50, maks 100) dan offset; total_count adalah jumlah total yang difilter.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik (uid) dari proyek
list_id	string		Uid daftar untuk dibaca; hilangkan atau berikan string kosong untuk backlog
epic_id	string		Hanya kartu dalam epik ini (uid epik) dalam daftar atau backlog yang dipilih; untuk mencantumkan setiap kartu dari sebuah epik di semua daftar gunakan get_epic
label_id	string		Hanya kartu yang membawa label ini (uid label)
assigned_user_id	string		Hanya kartu yang ditugaskan ke pengguna ini (uid pengguna)
reporter_id	string		Hanya kartu yang dilaporkan (dibuat) oleh pengguna ini (uid pengguna)
due_date	string		Hanya kartu yang jatuh tempo pada atau sebelum tanggal ini (ISO-8601, mis. 2026-06-10)
updated_since	string		Hanya kartu yang catatannya berubah pada atau setelah tanggal atau datetime ISO-8601 ini — filter "apa yang berubah sejak terakhir saya jalankan". Catatan: pengeditan pada koleksi terlampir (label, daftar periksa, tautan) mungkin tidak memperbarui waktu perubahan kartu; pengeditan judul/deskripsi/skalar selalu melakukannya.
limit	integer		Ukuran halaman, 1-100 (default 50)
offset	integer		Jumlah kartu yang dilewati (default 0)

search_cardshanya-baca

Pencarian kartu berdasarkan substring judul dalam satu proyek (papan kanban dan backlog), cocok dengan pencarian kartu langsung dalam proyek produk secara persis (substring tidak peka huruf besar/kecil pada judul kartu saja — deskripsi dan komentar tidak dicari; gunakan alat pencarian untuk pencarian teks lengkap di semua jenis konten), diurutkan berdasarkan yang paling baru dibuat terlebih dahulu. Mengembalikan ringkasan kartu yang cukup untuk tindakan (uid, judul, penempatan daftar + posisi, epik, label, penugas, pelapor, tanggal jatuh tempo); kueri tanpa kecocokan mengembalikan array kartu kosong, bukan kesalahan. Paginasi dengan limit (default 50, maks 100) dan offset; total_count adalah jumlah kecocokan penuh.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik (uid) dari proyek
query	string	ya	Teks untuk dicocokkan dengan judul kartu (substring tidak peka huruf besar/kecil)
limit	integer		Ukuran halaman, 1-100 (default 50)
offset	integer		Jumlah kartu yang cocok untuk dilewati (default 0)

list_attention_cardsPro · metrikhanya-baca

Mencantumkan kartu yang memerlukan perhatian di papan kanban proyek — daftar yang sama dengan halaman Metrik produk. Jenis: stuck (terjebak di kolom, bukan backlog/Selesai, tidak dipindahkan selama lebih dari 7 hari; yang paling lama terjebak terlebih dahulu), blocking (kartu yang belum selesai yang memblokir kartu lain), overdue (jatuh tempo dalam 7 hari ke depan atau sudah lewat jatuh tempo; yang paling cepat terlebih dahulu). kind memilih satu daftar atau 'all' (default). Opsional filter berdasarkan uid penugas atau literal 'unassigned'. Setiap bagian yang diminta mengembalikan ringkasan kartu yang siap untuk get_card / move_card / update_card, dibatasi pada limit dengan total_count penuh. Memerlukan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik (uid) dari proyek
kind	enum: stuck | blocking | overdue | all		Daftar perhatian mana yang akan dikembalikan (default 'all' = setiap daftar sebagai bagiannya sendiri)
assignee_id	string		Hanya kartu yang ditugaskan ke uid pengguna ini, atau 'unassigned' untuk kartu tanpa penugas
limit	integer		Maks kartu per bagian, 1-100 (default 50)

get_metrics_summaryPro · metrikhanya-baca

Penghitungan sekali panggil dari kartu yang memerlukan perhatian di papan kanban proyek: overdue_cards_count, blocking_cards_count, dan stuck_cards_count — definisi yang sama dengan list_attention_cards, yang mengembalikan kartu di balik setiap penghitungan. Murah; panggil ini terlebih dahulu untuk memutuskan apakah pemeriksaan lebih dalam layak dilakukan. Memerlukan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik (uid) dari proyek

list_roadmap_slotsPro · peta jalanhanya-baca

Mencantumkan slot peta jalan proyek yang tumpang tindih dengan jendela tanggal (default: bulan ini hingga lima bulan ke depan). Sebuah slot menjadwalkan epik antara dua tanggal dan dapat membawa penugas; satu epik dapat memiliki beberapa slot, termasuk tumpang tindih — itu memang dirancang demikian. Mengembalikan paling banyak 200 slot — persempit jendela jika dibatasi. Memerlukan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik dari proyek
start_date	string		Awal jendela, ISO-8601 (YYYY-MM-DD); default: awal bulan ini
end_date	string		Akhir jendela, ISO-8601; default: start_date + 6 bulan

create_roadmap_slotPro · peta jalan

Menjadwalkan epik di peta jalan proyek: sebuah slot dari start_date hingga end_date, opsional dengan penugas. Sebuah epik dapat memiliki beberapa slot dan tumpang tindih diizinkan oleh desain — periksa list_roadmap_slots terlebih dahulu jika Anda bermaksud memperpanjang slot yang ada daripada menambahkan satu. Memerlukan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Pengidentifikasi unik dari proyek
epic_id	string	ya	Uid epik (dari list_epics); harus milik proyek ini
start_date	string	ya	ISO-8601 (YYYY-MM-DD)
end_date	string	ya	ISO-8601; hari yang sama dengan start_date diizinkan
assigned_to	array of string		Uid pengguna untuk ditugaskan (anggota proyek — lihat list_project_users)

update_roadmap_slotPro · peta jalan

Memperbarui slot peta jalan: menjadwalkan ulang atau mengubah ukuran (start_date/end_date), memindahkannya ke epik lain dari proyek yang sama (epic_id), atau mengatur penugasnya. Hanya bidang yang disediakan yang berubah, KECUALI assigned_to yang MENGGANTI seluruh set penugas — baca slot terlebih dahulu dan kirim semua orang yang harus tetap ada. Uid slot berasal dari list_roadmap_slots. Memerlukan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Uid slot peta jalan
epic_id	string		Uid epik baru (proyek yang sama)
start_date	string		ISO-8601 (YYYY-MM-DD)
end_date	string		ISO-8601
assigned_to	array of string		MENGGANTI semua penugas (uid pengguna, anggota proyek); [] menghapus

delete_roadmap_slotPro · peta jalandestruktif

MENGHAPUS PERMANEN slot peta jalan (dan tautan penugasnya). Ini tidak dapat dibatalkan — tidak ada tempat sampah untuk slot peta jalan. Epik itu sendiri tidak disentuh; untuk menjadwalkan ulang, lebih suka update_roadmap_slot. Memerlukan ruang kerja Pro atau uji coba.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	Uid slot peta jalan (dari list_roadmap_slots)

create_label

Membuat label baru di proyek berdasarkan nama. Jika label dengan nama yang sama sudah ada (tidak peka huruf besar/kecil), label yang ada dikembalikan tanpa perubahan alih-alih membuat duplikat yang hampir sama. Label baru ditambahkan di akhir urutan tampilan.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Uid proyek tempat label berada
name	string	ya

create_card

Membuat kartu di papan kanban proyek. Hanya project_id dan title yang wajib. Hilangkan list_id untuk menempatkan kartu di backlog; hilangkan position untuk bergabung di akhir antrian (move_card mendokumentasikan kontrak posisi). description adalah AgileHero Markup — jangan pernah markdown atau HTML; baca get_ahm_spec terlebih dahulu. epic_id dan uid penugas harus sudah ada (list_epics, list_project_users), sementara nama label yang belum ada dibuat di proyek. estimation adalah kompleksitas Fibonacci (0/1/2/3/5/8/13), bukan perkiraan waktu. Daftar periksa, tautan, lampiran, dan relasi kartu semuanya dapat diberikan dalam panggilan yang sama ini.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	Uid proyek tempat kartu berada (kartu dibuat di papan kanban proyek)
list_id	string		Uid daftar; hilangkan untuk menempatkan di backlog
position	integer
type	enum: story | bug | chore | research
title	string	ya
description	string		AgileHero Markup (AHM) — jangan pernah markdown atau HTML; baca get_ahm_spec terlebih dahulu. Permukaan deskripsi: tanpa tabel, warna, perataan, atau diskusi.
epic_id	string		Uid epik; harus sudah ada di proyek
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Perkiraan kompleksitas dalam poin cerita (skala Fibonacci), bukan perkiraan waktu
due_date	string		Tanggal ISO-8601
assigned_to	array of string		Uid pengguna penugas, dapat ditemukan melalui list_project_users
labels	array of string		Nama label; nama yang tidak dikenal dibuat di proyek
checklists	array of object		Setiap { name, items: [{ description, checked }] }; item mempertahankan urutan yang diberikan
cards_relations	array of object		Setiap { type, target_card_id (uid kartu di papan yang sama) }
links	array of object		Setiap { url, description }
attachments	array of object		Setiap { url, name }; file diambil dari url

update_carddestruktif

Memperbarui kartu yang ada berdasarkan uid-nya. Untuk koleksi, lebih suka bidang delta add_*/remove_* (pengeditan inkremental yang aman: add_labels, remove_assignees, add_checklist_items, check_items, …); bidang koleksi biasa (labels, assigned_to, checklists, cards_relations, links, attachments) MENGGANTI keadaan sebelumnya secara destruktif dan tidak dapat digabungkan dengan delta mereka. Gunakan move_card untuk mengubah daftar atau posisi, dan preview_description_update / update_description untuk mengedit deskripsi.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	UID kartu
type	enum: story | bug | chore | research
title	string
epic_id	string
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Perkiraan kompleksitas dalam story points (skala Fibonacci), bukan perkiraan waktu
due_date	string		Tanggal ISO-8601
assigned_to	array of string		UID pengguna yang ditugaskan, dapat ditemukan melalui list_project_users; menggantikan penugasan kartu
labels	array of string		Nama label; nama yang tidak dikenal akan dibuat di proyek; menggantikan label kartu
checklists	array of object		Setiap { name, items: [{ description, checked }] }; item mempertahankan urutan yang diberikan; menggantikan checklist kartu
cards_relations	array of object		Setiap { type, target_card_id (UID kartu di papan yang sama) }; menggantikan relasi kartu
links	array of object		Setiap { url, description }; menggantikan tautan kartu
attachments	array of object		Setiap { url, name }; file diambil dari url; menggantikan lampiran kartu
add_labels	array of string		Tambahkan label berdasarkan nama (nama yang tidak dikenal akan dibuat); mempertahankan label yang ada
remove_labels	array of string		Hapus label berdasarkan nama (tidak peka huruf besar/kecil); nama yang tidak ada tidak berpengaruh
add_assignees	array of string		Tambahkan penugasan berdasarkan UID pengguna; mempertahankan penugasan yang ada
remove_assignees	array of string		Hapus penugasan berdasarkan UID pengguna; UID yang tidak ada tidak berpengaruh
add_checklist_items	array of object		Tambahkan item: setiap { checklist, description, checked? } — checklist yang disebutkan akan dibuat jika belum ada
check_items	array of object		Tandai item selesai, dicocokkan berdasarkan deskripsi persis dalam checklist yang disebutkan
uncheck_items	array of object		Tandai item belum selesai (pencocokan sama dengan check_items)
remove_checklist_items	array of object		Hapus item; item yang tidak ada tidak berpengaruh
add_relations	array of object		Tambahkan relasi; mempertahankan relasi yang ada
remove_relations	array of object		Hapus relasi yang cocok; yang tidak ada tidak berpengaruh
add_links	array of object		Tambahkan tautan: setiap { url, description? }; mempertahankan tautan yang ada
remove_links	array of string		Hapus tautan berdasarkan url persis; url yang tidak ada tidak berpengaruh

delete_carddestructive

Hapus lunak sebuah kartu berdasarkan UID-nya: kartu tersebut meninggalkan papan dan semua daftar, relasinya ke kartu lain dihapus, sesi estimasi apa pun yang terkait dinonaktifkan, dan elemen papan tulis yang tertaut ke kartu tersebut dilepaskan tautannya. Epic tempat kartu tersebut berada tidak dihapus. Tidak ada pemulihan melalui MCP.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	UID kartu

move_card

Pindahkan kartu ke daftar yang berbeda (atau ubah posisinya dalam daftar yang sama). Hanya kartu di papan kanban yang dapat dipindahkan; kartu di papan retrospektif ditolak. Berikan string kosong untuk list_id untuk memindahkan kartu ke backlog kanban. Daftar ditampilkan dari atas ke bawah berdasarkan posisi tertingginya, jadi posisi 0 adalah BAWAH daftar. Hapus position untuk bergabung di akhir antrean (bawah, posisi 0) di backlog dan di daftar to_do dan in_progress, atau di atas daftar done.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	UID kartu
list_id	string	ya	UID daftar tujuan; string kosong memindahkan ke backlog (khusus kanban)
position	integer		Penempatan dalam tujuan: 0 adalah bawah dan posisi tertinggi adalah atas. Harus antara 0 dan jumlah kartu lain yang sudah ada di tujuan. Hapus untuk bergabung di akhir antrean (posisi 0) di backlog dan di daftar to_do dan in_progress, atau di atas daftar done.

create_epic

Buat epic di sebuah proyek. Hanya project_id dan name yang wajib. description adalah AgileHero Markup — jangan pernah markdown atau HTML; baca get_ahm_spec terlebih dahulu. UID penugasan berasal dari list_project_users. Checklist, tautan, dan lampiran dapat diberikan dalam panggilan yang sama. Mengembalikan UID epic baru — yang diterima create_card / update_card sebagai epic_id, dan yang dijadwalkan oleh create_roadmap_slot.

Parameter	Tipe	Wajib	Deskripsi
project_id	string	ya	UID proyek tempat epic berada
name	string	ya
description	string		AgileHero Markup (AHM) — jangan pernah markdown atau HTML; baca get_ahm_spec terlebih dahulu. Permukaan deskripsi: tanpa tabel, warna, perataan, atau diskusi.
color	string		Warna hex seperti #0060F0
start_date	string		Tanggal ISO-8601
end_date	string		Tanggal ISO-8601
assigned_to	array of string		UID pengguna yang ditugaskan, dapat ditemukan melalui list_project_users
checklists	array of object		Setiap { name, items: [{ description, checked }] }; item mempertahankan urutan yang diberikan
links	array of object		Setiap { url, description }
attachments	array of object		Setiap { url, name }; file diambil dari url

update_epicdestructive

Perbarui epic yang ada berdasarkan UID-nya; hanya bidang yang diberikan yang diubah. Untuk koleksi, lebih baik gunakan bidang delta add_*/remove_* (pengeditan inkremental yang aman); bidang koleksi biasa (assigned_to, checklists, links, attachments) MENGGANTI keadaan sebelumnya secara destruktif dan tidak dapat digabungkan dengan delta-nya. Gunakan preview_description_update / update_description untuk mengedit deskripsi.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	UID epic
name	string
color	string		Warna hex seperti #0060F0
start_date	string		Tanggal ISO-8601
end_date	string		Tanggal ISO-8601
assigned_to	array of string		UID pengguna yang ditugaskan, dapat ditemukan melalui list_project_users; menggantikan penugasan epic
checklists	array of object		Setiap { name, items: [{ description, checked }] }; menggantikan checklist epic
links	array of object		Setiap { url, description }; menggantikan tautan epic
attachments	array of object		Setiap { url, name }; file diambil dari url; menggantikan lampiran epic
add_assignees	array of string		Tambahkan penugasan berdasarkan UID pengguna; mempertahankan penugasan yang ada
remove_assignees	array of string		Hapus penugasan berdasarkan UID pengguna; UID yang tidak ada tidak berpengaruh
add_checklist_items	array of object		Tambahkan item: setiap { checklist, description, checked? } — checklist yang disebutkan akan dibuat jika belum ada
check_items	array of object		Tandai item selesai, dicocokkan berdasarkan deskripsi persis dalam checklist yang disebutkan
uncheck_items	array of object		Tandai item belum selesai (pencocokan sama dengan check_items)
remove_checklist_items	array of object		Hapus item; item yang tidak ada tidak berpengaruh
add_links	array of object		Tambahkan tautan: setiap { url, description? }; mempertahankan tautan yang ada
remove_links	array of string		Hapus tautan berdasarkan url persis; url yang tidak ada tidak berpengaruh

delete_epicdestructive

Hapus lunak sebuah epic berdasarkan UID-nya. Kartu-kartunya TIDAK dihapus — mereka tetap di papan, terlepas dari epic. Slot roadmap epic TERSBUT dihapus secara permanen (slot menjadwalkan epic, jadi tidak berarti tanpa epic), dan elemen papan tulis yang tertaut ke epic dilepaskan tautannya.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	UID epic

create_comment

Tambahkan komentar ke kartu atau epic. Berikan tepat satu dari card_id atau epic_id. Konten adalah AgileHero Markup (AHM, permukaan komentar: tanpa tabel, media, warna, perataan, atau diskusi) — jangan pernah markdown atau HTML; baca get_ahm_spec terlebih dahulu. Komentar diatribusikan kepada pengguna yang masuk sebagai klien ini dan muncul dalam respons get_card / get_epic berikutnya. Komentar tidak dapat diedit melalui MCP; delete_comment menghapus komentar Anda sendiri (perbaiki kesalahan dengan hapus + posting ulang). Berikan parent_comment_id untuk membalas komentar yang ada. Thread hanya satu tingkat: membalas balasan akan melampirkan komentar baru ke akar thread balasan tersebut, jadi jangan mencoba menumpuk balasan. Induk harus berupa komentar pada kartu atau epic yang sama — UID dari tempat lain ditolak.

Parameter	Tipe	Wajib	Deskripsi
card_id	string		UID kartu untuk dikomentari (saling eksklusif dengan epic_id)
epic_id	string		UID epic untuk dikomentari (saling eksklusif dengan card_id)
content	string	ya	Isi komentar sebagai AgileHero Markup (AHM)
parent_comment_id	string		UID opsional dari komentar pada kartu atau epic yang SAMA untuk dibalas. Hapus untuk komentar tingkat atas. Membalas balasan akan dinormalisasi ke akar thread balasan tersebut (thread hanya satu tingkat).

delete_commentdestructive

Hapus komentar yang ANDA posting (komentar diatribusikan kepada pengguna yang masuk sebagai klien ini — komentar orang lain tidak dapat dihapus). Pola koreksi adalah hapus + posting komentar yang diperbaiki dengan create_comment. Komentar yang dihapus yang memiliki balasan tetap terlihat sebagai batu nisan di thread-nya. UID komentar berasal dari get_card / get_epic.

Parameter	Tipe	Wajib	Deskripsi
id	string	ya	UID komentar