AgileHero
公式エージェントからアジャイルワークスペースを実行：カードの作成と移動、エピックのグルーミング、ロードマップの計画、レトロスペクティブの実施、ホワイトボードの描画、Wikiページの作成が可能です。
AgileHero MCPで何ができますか？
-
OAuthで接続 — 任意のMCPクライアントに
https://mcp.agilehero.io/mcpを追加し、AgileHeroアカウントでサインインします。APIキーは不要です。 -
プロジェクト横断で検索 — アシスタントに、グローバル全文
searchツールを使って、コンテンツに基づいてカード、エピック、Wikiページを探してもらいます。 -
カードとエピックを管理 — 説明、チェックリスト、ラベル、コメントを含む、カードまたはエピックの詳細を、 または で読み取ります。
-
Wikiページを安全に編集 — 変更をプレビューし、返されたトークンを使って で適用します。
-
ホワイトボードを作成・変換 — で図を描いたり、付箋をバックログ項目に変換したりします。
-
レトロスペクティブを実施 — で既存のレトロスペクティブを一覧表示するか、新しいものを作成します。
ホスト型 MCP サーバー
npx add-mcp 'https://mcp.agilehero.io/mcp'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
AgileHeroにはビルトインのMCPサーバーが搭載されています。MCP対応のAIアシスタントにURLを1つ追加し、AgileHeroアカウントでサインインするだけで、あなたのプロジェクトをあなたとまったく同じ権限で操作できます。ボード、バックログ、エピック、Wiki、ホワイトボード、レトロスペクティブ、ロードマップにわたる49のツールが利用可能です。このリファレンスはサーバー自体から生成されているため、常に最新の状態に保たれています。
はじめての方ですか？AIエージェント概要から始めるか、以下のクライアント接続に直接進んでください。このサーバー上のリッチテキストはすべてAgileHero Markup (AHM)です。これは、エージェントが人間のコンテンツを決して壊さないように設計された、厳格で検証済みのXML方言です。アシスタントを接続する代わりにスクリプトを書いていますか？REST APIリファレンスは同じOAuthサインインを使用します。
AIクライアントを接続する
接続とは、エンドポイントURLをクライアントに追加し、クライアントが要求したときにAgileHeroアカウントでサインインするという2つのことを意味します。作成または貼り付けるキーはありません。接続されると、クライアントはあなたとして、あなたとまったく同じ権限で動作します。接続された各クライアントは、アプリの設定 → AIクライアントに一覧表示され、いつでも取り消すことができます。オブザーバーはMCPサーバーを使用できません。オブザーバーであるワークスペースは一覧表示されず、その中のすべてが「見つかりません」と読み取られます。
エンドポイント
https://mcp.agilehero.io/mcp
トランスポート
Streamable HTTP (POST)
サインイン
AIクライアントがブラウザウィンドウを開きます。一度承認すると、いつでも設定 → AIクライアントで取り消すことができます。
Claude Code
ターミナルで一度実行します。Claude Codeはサーバーをユーザーレベルの設定に保存し、ブラウザ経由でサインインします。
claude mcp add --transport http --scope user agilehero https://mcp.agilehero.io/mcp
- すべてのフラグはサーバー名より前に置く必要があります。
- 次に、Claude Codeセッション内で
/mcpを実行し、「Authenticate」を選択（またはclaude mcp login agileheroを実行）して、ブラウザでサインインを承認します。
確認: claude mcp listを実行します — agileheroが接続済みとして表示されるはずです。「要認証」と表示される場合は、claude mcp login agileheroを実行します。
Claude Codeドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
VS Code (GitHub Copilot)
ワークスペース内の.vscode/mcp.jsonに追加するか、すべてのワークスペースで「MCP: Open User Configuration」を実行します。サーバーが初めて起動するときに、サインイン用のブラウザウィンドウが開きます。
.vscode/mcp.json
{
"servers": {
"agilehero": {
"type": "http",
"url": "https://mcp.agilehero.io/mcp"
}
}
}
- "type": "http" は必須です — これがないとVS CodeはURLを実行するコマンドとして扱います。
確認: 「MCP: List Servers」を実行し、agileheroを起動して、ブラウザでサインインを完了し、そのツールがチャットビューに表示されることを確認します。
VS Code (GitHub Copilot)ドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Codex
ターミナルから追加してからサインインします。設定はCodex CLI、IDE拡張機能、ChatGPTデスクトップアプリで共有されます。
codex mcp add agilehero --url https://mcp.agilehero.io/mcp
codex mcp login agilehero
- Codexは自動的にサインインを開始しません — サーバーを追加した後、
codex mcp login agileheroを実行してください。
確認: codex mcp listを実行します — agileheroが認証済みとして表示されるはずです。次にCodexにAgileHeroプロジェクトの一覧表示を依頼します。
Codexドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Zed
settings.jsonに追加するか、設定 → AI → MCP Servers → Add Remote Serverを使用します。Zedがサインインを促します。
~/.config/zed/settings.json
{
"context_servers": {
"agilehero": {
"url": "https://mcp.agilehero.io/mcp"
}
}
}
- ヘッダーは含めないでください — ZedはAuthorizationヘッダーが設定されていない場合にのみサインインを開始します。
確認: Zedを再起動し、要求されたらブラウザでサインインを承認し、AgileHeroプロジェクトの一覧表示を依頼します — 最初の成功した呼び出しで接続が確認されます。
Zedドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
GitHub Copilot CLI
~/.copilot/mcp-config.json、またはリポジトリ内の.mcp.jsonに追加します。
~/.copilot/mcp-config.json
{
"mcpServers": {
"agilehero": {
"type": "http",
"url": "https://mcp.agilehero.io/mcp"
}
}
}
- GitHub Copilot CLI 1.0.83以降が必要です（Client ID Metadata Documentサポート）。
- Copilot CLIは、サーバーが最初に要求したときにサインインを開きます。セッション内で
/mcp auth agileheroを実行することもできます。
確認: Copilot CLI内で/mcpを実行します — agileheroがそのツールとともに接続済みとして一覧表示されるはずです。
GitHub Copilot CLIドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Claude (ウェブ、デスクトップ、Cowork)
AgileHeroをカスタムコネクタとして追加してサインインします。コネクタは、Claude on the web、Claude Desktop、Cowork、モバイルアプリで利用できます。
Settings → Connectors → Add custom connector
Name: AgileHero
URL: https://mcp.agilehero.io/mcp
Sign in now
- コネクタは、同じClaudeアカウントでサインインしている場合、Claude Codeにも表示されます。
- 無料プラン: カスタムコネクタは1つ。TeamおよびEnterprise: オーナーがコネクタを追加し、各メンバーが自分のAgileHeroアカウントでサインインします。
確認: 新しいチャットを開始します — AgileHeroがコネクタの下に一覧表示され、ClaudeにAgileHeroプロジェクトの一覧表示を依頼すると機能します。
Claude (ウェブ、デスクトップ、Cowork)ドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
ChatGPT
Developerモードでコネクタを作成し、OAuthでサインインします。
Settings → Connectors → Create (Developer mode)
Name: AgileHero
MCP server URL: https://mcp.agilehero.io/mcp
Authentication: OAuth
- Developerモードが有効なPlus、Pro、Business、Enterprise、Eduで利用可能です。ワークスペースでは、管理者またはオーナーがメンバー向けにコネクタを公開します。
確認: AgileHeroコネクタを有効にして新しいチャットを開き、ChatGPTにAgileHeroプロジェクトの一覧表示を依頼します。
ChatGPTドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
その他のクライアント
Client ID Metadata DocumentsでOAuthをサポートするMCPクライアント: エンドポイントをリモート（Streamable HTTP）サーバーとして追加し、ブラウザでサインインを承認します。
Transport: Streamable HTTP
URL: https://mcp.agilehero.io/mcp
Authentication: OAuth (sign in when the client asks)
- 静的トークンまたはヘッダーのみをサポートするクライアントは接続できません — AgileHeroはOAuthサインインのみを使用します。
確認: クライアントを再起動し、要求されたらブラウザでサインインを承認し、AgileHeroプロジェクトの一覧表示を依頼します — 最初の成功した呼び出しで接続が確認されます。
その他のクライアントドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
まだサポートされていません
これらのクライアントはまだAgileHeroにサインインできません。それらのほとんどは、AgileHeroが使用するOAuthクライアント登録方法であるClient ID Metadata Documents（現在のMCP推奨）をサポートしていません。ベンダードキュメントを定期的に再確認し、資格が満たされ次第、クライアントを上のリストに移動します。
Cursor未対応
CursorはまだClient ID Metadata Documentsをサポートしていません（そのOAuthサインインにはDynamic Client Registrationまたは事前登録されたクライアントが必要です）。そのため、現在AgileHeroに接続できません。
Cursorドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
OpenCode未対応
OpenCodeはまだClient ID Metadata Documentsをサポートしていません（そのOAuthサインインにはDynamic Client Registrationまたは事前登録されたクライアントが必要です）。そのため、現在AgileHeroに接続できません。
OpenCodeドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Gemini CLI未対応
Gemini CLIはまだClient ID Metadata Documentsをサポートしていません（そのOAuthサインインにはDynamic Client Registrationまたは事前登録されたクライアントが必要です）。そのため、現在AgileHeroに接続できません。
Gemini CLIドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Cline未対応
ClineはまだClient ID Metadata Documentsをサポートしていません（そのOAuthサインインにはDynamic Client Registrationまたは事前登録されたクライアントが必要です）。そのため、現在AgileHeroに接続できません。
Clineドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Google Antigravity未対応
Google AntigravityはまだClient ID Metadata Documentsをサポートしていません（そのOAuthサインインにはDynamic Client Registrationまたは事前登録されたクライアントが必要です）。そのため、現在AgileHeroに接続できません。
Google Antigravityドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Amp未対応
AmpはまだClient ID Metadata Documentsをサポートしていません（そのOAuthサインインにはDynamic Client Registrationまたは事前登録されたクライアントが必要です）。そのため、現在AgileHeroに接続できません。
Ampドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Raycast AI未対応
Raycast AIはまだClient ID Metadata Documentsをサポートしていません（そのOAuthサインインにはDynamic Client Registrationまたは事前登録されたクライアントが必要です）。そのため、現在AgileHeroに接続できません。
Raycast AIドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Kiro未対応
Kiroは、ユーザーが提供するClient ID Metadata Document URLでサインインしますが、AgileHeroはまだそのためのClient ID Metadata Documentをホストしていません。
Kiroドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Warp未対応
Warpには、ユーザーが追加したサーバー向けのOAuthサインインがまだないため、現在AgileHeroに接続できません。
Warpドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
JetBrains AI Assistant未対応
JetBrains AI Assistantにはリモートサーバー向けのOAuthサインインがなく、mcp-remoteブリッジにはホストされたクライアントドキュメントが必要です — AgileHeroはまだそのためのClient ID Metadata Documentをホストしていません。
JetBrains AI Assistantドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
Continue未対応
ContinueにはStreamable HTTPサーバー向けのOAuthサインインがなく、mcp-remoteブリッジにはホストされたクライアントドキュメントが必要です — AgileHeroはまだそのためのClient ID Metadata Documentをホストしていません。
Continueドキュメント · 2026-09-15にベンダードキュメントに対して検証済み
サーバー指示
すべてのMCPクライアントは、初期化時にこれらの規則を受け取ります:
AgileHero MCPサーバー。
すべてのidパラメータとレスポンス内のすべてのidは短いuidです — 常にlist/get/searchツールによって返されたuidを使用し、決して独自に作成しないでください。ほとんどのツールはプロジェクトuidを必要とします — 最初にlist_projectsを呼び出して、ワークスペースとプロジェクトを発見してください。search_cards（タイトル部分文字列、1つのプロジェクト）よりもsearch（全文、すべてのコンテンツタイプ）を優先してください。
更新ツールでは、コレクションにはadd_*/remove_*デルタフィールドを優先してください（増分的で安全）。プレーンなコレクションフィールド（assigned_to、labels、checklists、cards_relations、links、attachments）は以前の状態を置き換え、それらのデルタと組み合わせることはできません。チェックリスト項目は{ description, checked }です。list_cards / list_epicsでupdated_sinceを使用して変更をキャッチアップしてください。
カードのリストまたは位置を変更するには、move_card（update_cardではなく）を使用します。空のlist_idはバックログを意味します。
Wiki、ホワイトボード、レトロスペクティブ、ロードマップのツールでは、プロジェクトのワークスペースがProまたはトライアルプランである必要があります。ホワイトボード要素の書き込みはバッチツールであり、全か無かです。要素uidはget_whiteboardから取得します。レトロスペクティブ項目はadd_retro_itemsとmove_retro_itemで管理します（move_cardはレトロスペクティブカードを拒否します）。
1日の制限: ツール呼び出しはユーザーごと、ワークスペースごとに測定されます — 無料プランでは1日500回、Proまたはトライアルでは1日5,000回で、00:00 UTCにリセットされます。get_ahm_specとlist_projectsはカウントされません（スコープなしの検索など、単一のワークスペースに帰属しない呼び出しも同様です）。制限を超えると、リセットまたはアップグレードまで、ツールは1日の制限エラーを返します。
すべてのリッチテキスト（Wikiページ、カード/エピックの説明、コメント）はAgileHero Markup (AHM)です — 厳格なXMLであり、決してMarkdownやHTMLではありません。書き込む前に必ずget_ahm_specを一度呼び出してください。リッチテキストの編集は設計上2段階です: preview_wiki_page_update / preview_description_update（結果 + preview_token）、次にそのトークンを使用して対応する更新ツールを実行します。
完全なツールドキュメント: https://agilehero.io/docs/mcp
AHM仕様: https://agilehero.io/docs/mcp/agilehero-markup
ツール (49)
list_projects読み取り専用
トークンのユーザーがアクセスできるすべてのワークスペースとプロジェクトを一覧表示し、エージェントが他のほとんどのツールで必要とするプロジェクトuidを解決できるようにします。プロジェクトuidが不明な場合は、必ず最初にこれを呼び出してください — ユーザーに貼り付けを依頼しないでください。ワークスペース（uid、名前、プラン、あなたの役割）とそのプロジェクト（uid、名前、url）を返します。Proピラーツール（Wiki、メトリクス）では、ワークスペースのプランがproまたはトライアルである必要があります。
search読み取り専用
この製品のグローバル全文検索（OpenSearch）：カード、エピック、Wikiページ、プロジェクトを対象に、タイトル、説明、コメント、チェックリスト項目、添付ファイル名を検索し、関連度順にランク付けして、新しいものほど優先度を高く表示します。これを使って、コンテンツから何でも検索できます（「移行について話し合ったカード」など）。search_cardsは、1つのプロジェクト内でのタイトル部分文字列検索にのみ使用します。各結果には、タイプ、アクション対応のuid（カードはget_card/update_card、エピックはget_epic、wiki_pagesはshow_wiki_page、プロジェクトはproject_idパラメータ）、ディープリンクURL、および一致理由を示す<mark>ハイライト付きスニペットが含まれます。必要に応じてproject_idまたはassigned_to_meで範囲を絞り込めます。page/per_pageでページネーションします。total_countは完全一致数です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| query | string | はい | フリーテキスト検索クエリ |
| project_id | string | 検索範囲を絞り込むためのオプションのプロジェクトuid | |
| assigned_to_me | boolean | トークンのユーザーに割り当てられた結果のみ | |
| page | integer | ページ番号（デフォルト1） | |
| per_page | integer | 1ページあたりの結果数、1〜50（デフォルト20） |
get_card読み取り専用
1枚のカードを完全に読み取ります：ブロックID付きのAgileHero Markup説明とdescription_version（preview_description_update / update_descriptionの2つの入力が受け取るもの）、リスト配置、エピック、ラベル、担当者、報告者、タイプ、見積もり、期限日、チェックリスト、リンク、添付ファイル、関連カード、スレッド化されたコメント。カードuidのみを受け取ります — project_idパラメータはありません。カードuidはlist_cards、search、またはsearch_cardsから取得します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | カードの一意の識別子 |
get_epic読み取り専用
1つのエピックを完全に読み取ります：ブロックID付きのAgileHero Markup説明とdescription_version（preview_description_update / update_descriptionの2つの入力が受け取るもの）、名前、番号、色、開始日/終了日、担当者、チェックリスト、リンク、添付ファイル、その上のすべてのカード（uid、番号、タイトル、およびカテゴリ付きのリスト — nullリスト = バックログ — ボード順、つまりエピックのすべてのカードを一覧表示し、どれが未着手、進行中、完了かを確認する方法です）、およびスレッド化されたコメント。エピックuidのみを受け取ります — project_idパラメータはありません。エピックuidはlist_epicsまたはsearchから取得します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | エピックの一意の識別子 |
list_wiki_pathsPro · wiki読み取り専用
プロジェクトのWikiツリー全体を表示順に一覧表示します — すべてのフォルダとページについて、uid、名前、タイプ（ページまたはフォルダ）、parent_idを含みます — これにより、エージェントはshow_wiki_pageが受け取るページuidを解決し、create_wiki_pageのparent_idを選択できます。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子 |
show_wiki_pagePro · wiki読み取り専用
WikiページをAgileHero Markup（AHM）としてdocument_version付きで取得します。コンテンツはAHMであり、Markdownではありません — ブロックID、<discussion>アンカー、<image/>/<attachment/>参照はドキュメントの一部です。編集前にget_ahm_specを読んでください。ここで返されたブロックIDとdocument_versionを使用して、preview_wiki_page_updateで編集し、その後update_wiki_pageで更新します。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | ページパスの一意の識別子 |
get_ahm_spec読み取り専用
AgileHero Markup（AHM）v1.0仕様 — AgileHeroが受け入れる唯一のリッチテキスト形式です（MarkdownとHTMLは拒否されます）。リッチテキスト（Wikiページ、カード/エピックの説明、コメント）を書いたり編集したりする前に、これを一度読んでください：語彙、属性、エスケープ規則、および実例。Web上の同じテキスト：https://agilehero.io/docs/mcp/agilehero-markup
create_wiki_pagePro · wiki
AgileHero Markup（AHM）コンテンツでWikiページ（オプションでフォルダ内）を作成します。コンテンツは<agile-hero-markup version="1.0">でラップする必要があります — MarkdownとHTMLは拒否されます。最初にget_ahm_specを読んでください。新しいページのuid、url、document_version、コンテンツを返します。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子（uid） |
| name | string | はい | ページタイトル |
| parent_id | string | オプションのフォルダuid（list_wiki_pathsから） | |
| content | string | AHMとしてのページ本文。空のページの場合は省略 |
preview_wiki_page_updatePro · wiki読み取り専用
すべてのWikiページ更新の必須の最初のステップ：操作を検証し、サーバー計算の結果（追加/削除/変更されたブロック、完全に削除されるファイル、アンカーを失うチームディスカッション、可能性のあるMarkdown警告）と、update_wiki_pageが必要とするpreview_tokenを返します。何も変更されません。操作はブロックアドレス指定（replace_block / insert_after / delete_block / move_block）でAHMコンテンツを使用します — 最初にget_ahm_specを読み、show_wiki_pageからブロックIDとdocument_versionを取得してください。保存する前に結果を確認してください：リストされたファイルの削除やディスカッションのアンカー解除は、ユーザーがそれを要求した場合にのみ受け入れられます。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | ページパスuid |
| document_version | string | はい | show_wiki_pageから — 最新性を証明します |
| operations | array of object | はい | 進化するドキュメントに対して順に適用されます |
update_wiki_pagePro · wiki破壊的
以前にプレビューした更新をWikiページに適用します。preview_wiki_page_updateからのpreview_tokenが、これらの操作とこのdocument_versionに正確に必要です — プレビューなしでの保存は設計上不可能です。保存のたびに、人間がアプリで元に戻せるページバージョンが作成されます。更新されたページ（AHM + 新しいdocument_version）と適用された結果を返します。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | ページパスuid |
| document_version | string | はい | プレビューが取得されたバージョン |
| operations | array of object | はい | プレビューされた正確な操作 |
| preview_token | string | はい | preview_wiki_page_updateから |
preview_description_update読み取り専用
すべてのカードまたはエピックの説明編集の必須の最初のステップ：ブロック操作を検証し、サーバー計算の結果と、update_descriptionが必要とするpreview_tokenを返します。何も変更されません。コンテンツはAgileHero Markup（AHM、説明サーフェス：テーブル、色、配置、ディスカッション、ファイル添付なし）です — 最初にget_ahm_specを読み、ブロックIDとdocument_versionはget_card / get_epicから取得します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| resource_type | enum: card | epic | はい | |
| id | string | はい | カードまたはエピックのuid |
| document_version | string | はい | get_card / get_epicから |
| operations | array of object | はい | 進化する説明に対して順に適用されます |
update_description破壊的
以前にプレビューした説明更新をカードまたはエピックに適用します。preview_description_updateからのpreview_tokenが、これらの操作とこのdocument_versionに正確に必要です — プレビューなしでの保存は設計上不可能です。更新された説明（AHM + 新しいdocument_version）を返します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| resource_type | enum: card | epic | はい | |
| id | string | はい | カードまたはエピックのuid |
| document_version | string | はい | プレビューが取得されたバージョン |
| operations | array of object | はい | プレビューされた正確な操作 |
| preview_token | string | はい | preview_description_updateから |
list_whiteboardsPro · whiteboard読み取り専用
プロジェクトのホワイトボードを一覧表示します（uid、名前、要素数、url）。ボードの要素を読み取るにはget_whiteboardを使用します。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子 |
create_whiteboardPro · whiteboard
プロジェクトに空のホワイトボードを作成します。create_whiteboard_elementsでコンテンツを追加します。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子 |
| name | string | はい | ホワイトボード名 |
get_whiteboardPro · whiteboard読み取り専用
ホワイトボードをコンパクトなテキスト表現として読み取ります：ボードの境界と、要素ごとに1行 — "<type> <uid> at <x>,<y> size <w>x<h> [color] [parent <frame-uid>] [linked <card|epic> <uid>] \"text\""、コネクタは "connector <uid> <from> -> <to>"。ここからの要素uidは、すべてのホワイトボード書き込みツールが受け取るハンドルです。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | ホワイトボードの一意の識別子 |
create_whiteboard_elementsPro · whiteboard
1回のトランザクション呼び出しで最大100個のホワイトボード要素を作成します（全か無か、1つのリアルタイムイベント）。ネイティブサイズ、色、テキスト配置はサーバー側で適用されます — 通常はタイプ+テキスト（+色）だけを指定します。x/yを省略すると、要素は自動配置されます（デフォルトはグリッド。arrange: row|column|grid、origin_x/origin_y/gapで調整可能）。x/yを指定すると完全に制御できます。フレームはparent_id（既存のフレームuid）またはparent_ref（この呼び出し内の前のフレームのref）を介して要素を含みます。コネクタは要素をuid（source_id/target_id）またはバッチref（source_ref/target_ref）でバインドします — 座標は使用しません。アンカーはUIによって計算されます。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| whiteboard_id | string | はい | ホワイトボードの一意の識別子 |
| elements | array of object | はい | 配列順に作成されます — refは後方のみ解決されます |
| arrange | enum: grid | row | column | 明示的なx/yがない要素のレイアウト（デフォルトはgrid） | |
| origin_x | number | 自動配置の開始x（デフォルト100） | |
| origin_y | number | 自動配置の開始y（デフォルト100） | |
| gap | number | 自動配置の間隔（px、デフォルト20） |
create_whiteboard_diagramPro · whiteboard
セマンティックグラフからホワイトボードに図（フローチャート、プロセス、依存関係グラフ）を描画します — ノード、エッジ、オプションのグループ、座標なし：サーバーがネイティブサイズでレイヤー化された上から下へのレイアウトを実行し、作成された要素uidをノードIDでキー付けして返します。既存のボードコンテンツの下に配置されます。トランザクション（全か無か、1つのリアルタイムイベント）。最大20ノード — 大きなフローは2つの図に分割してください。セマンティクスが要求しない限り、形状はプレーン（rectangle）に保ちます（diamond = 決定、stadium = 開始/終了、cylinder = データストア）。結果はupdate_whiteboard_elementsで編集します — レイアウトは再度実行されません。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| whiteboard_id | string | はい | ホワイトボードの一意の識別子 |
| title | string | 図のタイトル（フレームタイトル、またはグループ使用時の見出し） | |
| nodes | array of object | はい | |
| edges | array of object | ||
| groups | array of object | ||
| origin_x | number | オプションの左上x。デフォルトは既存コンテンツの下 | |
| origin_y | number | オプションの左上y。デフォルトは既存コンテンツの下 |
update_whiteboard_elementsPro · whiteboard
ホワイトボード要素を最大100件まで、1回の全か無かの呼び出しで更新します：移動（x/y）、サイズ変更、重ね順の変更（z_index）、テキスト変更、色変更、親の変更（parent_id — フレームのuid、または切り離す場合は""）、コネクタの矢印/パス/ラベル。要素のuidはget_whiteboardから取得します。要素のタイプは変更できません。指定されたフィールドのみが変更され、関連しないプロパティは保持されます。Proまたはトライアルのワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| whiteboard_id | string | はい | ホワイトボードの一意の識別子 |
| updates | objectの配列 | はい |
delete_whiteboard_elementsPro · whiteboard破壊的
ホワイトボード要素を最大100件まで、1回のトランザクション呼び出しで削除します。フレームまたはマインドマップノードを削除すると、その子要素はボード上に解放されます（削除されません — それらも削除するには、そのuidを明示的に含めてください）。削除された要素に接続されたコネクタは削除されず、ぶら下がったままになります。要素のuidはget_whiteboardから取得します。Proまたはトライアルのワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| whiteboard_id | string | はい | ホワイトボードの一意の識別子 |
| ids | stringの配列 | はい | 削除する要素のuid |
review_whiteboardPro · whiteboard読み取り専用
ホワイトボードに対して決定的な品質チェックを実行します：要素からあふれている可能性のあるテキスト、視覚的に重なっている要素、未バインドまたはぶら下がったエンドポイントを持つコネクタ、UIパレット外の色、グリッドから外れた位置、親が削除された要素。アドバイザリ — 検出結果は提案でありエラーではありません。検出結果があるボードが、まさにユーザーが望むものである可能性もあります。描画後に使用して健全性を確認し、最大1回修正し、空のレポートを追いかけ続けないでください。Proまたはトライアルのワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | ホワイトボードの一意の識別子 |
convert_whiteboard_elementPro · whiteboard
ホワイトボード要素をバックログアイテムに変換します：付箋をカードまたはエピックに、またはフレームをエピックに変換します（フレームの付箋の子要素はそのエピックのカードになります。すでに変換された子要素は再割り当てされ、複製されません）。要素はボード上に残り、変換後のアイテムにリンクされます — get_whiteboardにリンクが表示されます。要素は一度だけ変換できます。タイトルを渡さない限り、ノート/フレームのテキストがタイトルになります。Proまたはトライアルのワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | 要素のuid（sticky_noteまたはframe、get_whiteboardから） |
| to | enum: card | epic | はい | 作成するもの |
| title | string | カードのタイトル / エピックの名前。デフォルトは要素のテキスト | |
| list_id | string | カードのみ：ターゲットリストのuid。バックログの場合は省略 | |
| color | string | エピックのみ：16進数の色。デフォルトは要素の色 |
convert_mind_mapPro · whiteboard
マインドマップをノードごとのマッピングでバックログアイテムに変換します：ルートは新しいエピック（ロール「epic」）になるか、既存のエピックにアタッチ（ロール「existing_epic」+ target_epic_id）できます。他のノードはそのエピックのカード（ロール「card」）またはプロジェクトラベル（ロール「label」 — ツリー内でカードノードの上にあるラベルノードはそのカードに適用されます）になります。ロール「skip」はノードを無視します。ルート要素のuidをidとして渡し、変換するすべてのノードをnodesに渡します（リストにないノードは無視されます）。ノードごとに1回の変換：すでに変換されたノードは事前に拒否されます — それらなしで再送信してください。Proまたはトライアルのワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | ルートのマインドマップノードのuid（get_whiteboardから） |
| nodes | objectの配列 | はい | |
| target_epic_id | string | エピックのuid。ルートのロール「existing_epic」で必須 |
list_retrospectivesPro · retrospectives読み取り専用
プロジェクトのレトロスペクティブを一覧表示します：ワークスペースに新しいモデルのレトロスペクティブとヘルスチェックがある場合はそれらを、それ以外の場合はクラシックなレトロスペクティブボードを表示します。新しいモデルのエントリには、uid、name、kind（retro | health_check）、status（open | live | closed）、date（starts_on。ヘルスチェックの場合はcloses_on）、現在のステージ、テンプレート、ファシリテーターのuid、作成されたアクションの数、urlが含まれます。レスポンスにはプロジェクトのopen_actions_countが追加されます。完全な情報はget_retrospectiveを使用してください。Proまたはトライアルのワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子 |
create_retrospectivePro · retrospectives
レトロスペクティブを作成します：ワークスペースに新しいモデルのレトロスペクティブがある場合はそれを作成し、それ以外の場合はクラシックなレトロスペクティブボードを作成します。レスポンスはget_retrospectiveが返す形式のレトロスペクティブです（uid付きのカラムを含む）。そのため、add_retro_itemsをすぐに続けて呼び出すことができます。新しいモデルのレトロスペクティブはテンプレート（デフォルトはwent_well）から作成され、すぐにノートを受け付け、あなたがファシリテーターになります。オプション：focus、匿名性（デフォルト：テンプレートの設定）、participant_ids（選択メンバーのレトロスペクティブ。省略すると書き込みアクセス権を持つすべてのプロジェクトメンバー）、チェックインとフィードバックの質問の種類、投票。ファシリテーターが開始し、アプリでステージを実行します。クラシックボードはname、date、previous_retrospective_idのみを受け付け、新しいモデルの引数は拒否します。Proまたはトライアルのワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子 |
| name | string | はい | レトロスペクティブの名前 |
| 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 | テンプレートキー。デフォルトはwent_well | |
| starts_on | string | 日付、ISO-8601（YYYY-MM-DD）。デフォルトは今日 | |
| starts_at | string | starts_onの非推奨のエイリアス | |
| focus | string | このレトロスペクティブの目的。名前の下に表示されます | |
| anonymity | enum: anonymous | optional | named | ノートに表示される人物：anonymous、optional（作成者が名前を追加できる）、またはnamed | |
| participant_ids | stringの配列 | 参加者のユーザーuid（list_project_users）。あなたは常にその1人です | |
| check_in | enum: safety | mood | esvp | one_word | チェックインの質問（デフォルトはsafety） | |
| feedback | enum: roti | pulse | one_word | 終了時のフィードバックの質問（デフォルトはroti） | |
| votes | object | 投票設定：budget（auto | fixed | unlimited）、per_person（1-20）、max_per_topic（1-10） | |
| previous_retrospective_id | string | クラシックボードのみ：以前のレトロスペクティブのuid。そのActionsカラムが「Past actions」として表示されます |
get_retrospectivePro · retrospectives読み取り専用
レトロスペクティブを表示される形式で読み取ります：ワークスペースに新しいモデルのレトロスペクティブまたはヘルスチェックがある場合はそれらを、それ以外の場合はクラシックなレトロスペクティブボードを読み取ります。新しいモデルのレトロスペクティブは、セットアップ、ステージ（現在のもの、タイマー、進捗）、トピック（uid付きのノートのグループ）を保持するカラム（uid付き）、チェックインとフィードバックの集計、残りの投票、Discussキューと保留中のトピック、提案、アクション（作成されたものとプロジェクトの未完了のもの）、そして閉じられた後のサマリーを返します。プライバシーはルームに従います：公開前は自分のノートのみが表示されます（各カラムは全員のノート数をカウントします）、名前付きノートでは作成者のみ、投票数は投票が公開された後にのみ表示されます。ヘルスチェックは、そのディメンションと参加状況、開いている間は自分の評価、閉じられた後はディメンションごとの集計を返します。Proまたはトライアルのワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | レトロスペクティブのuid（list_retrospectivesから） |
add_retro_itemsPro · retrospectives
自分としてレトロスペクティブにアイテムを一度に複数追加します：ワークスペースに新しいモデルのレトロスペクティブがある場合はノートを、それ以外の場合はクラシックなレトロスペクティブボードにカードを追加します。各アイテムは{ column, text, recipient_id? }です：columnはカラムのタイトル（大文字小文字を区別しない）またはget_retrospectiveからのuid。textは最大1000文字（クラシックボードでは255文字）。recipient_idは、感謝するチームメイトのユーザーuidで、新しいモデルのkudosカラムでは必須で、クラシックボードでは拒否されます。新しいモデルのノートは独自のトピックを開始し、ノートが公開されると他の人に表示されます。ノートはレトロスペクティブがノートを受け付けている間、またはWriteステージの間のみ取得できます。それ以外の場合は、コードwrong_stageと現在のステージで呼び出しが拒否されます。部分的な失敗：有効なアイテムは追加され、無効なアイテムはインデックスごとに報告されます — 「failed」配列を確認してください。Proまたはトライアルのワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| retrospective_id | string | はい | レトロスペクティブのuid |
| items | objectの配列 | はい |
move_retro_itemPro · retrospectives
レトロスペクティブのアイテムを移動します：ワークスペースに新しいモデルのレトロスペクティブがある場合はノートを再グループ化し、それ以外の場合はクラシックなレトロスペクティブボードの別のカラムにカードを移動します。新しいモデル、Groupステージのみ：topic_idはノートをそのトピック（ノートのグループ）に入れます。column（タイトルまたはuid）は、そのカラムのトピック内のpositionの位置に独自のトピックを作成します（省略すると最後）。expected_updated_at（get_retrospectiveからのノートのトピックのupdated_at）を渡すと、その間に誰かが再グループ化した場合にコードstaleで拒否されます。Group以外では、コードwrong_stageと現在のステージで呼び出しが拒否されます。kudosとその他のノートは決して混在しません。クラシックボードはcolumnとpositionのみを受け付けます（position省略 = 先頭）。Proまたはトライアルのワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | ノートのuid（クラシックボード：アイテムのuid）。get_retrospectiveから |
| topic_id | string | ターゲットのトピックuid。columnは省略してください | |
| column | string | ターゲットのカラムのタイトルまたはuid | |
| position | integer | ターゲットのカラム内のインデックス（0 = 最初） | |
| expected_updated_at | string | 最後に読み取ったときのノートのトピックのupdated_at（競合チェック） |
list_project_users読み取り専用
プロジェクトのメンバーを一覧表示します — 標準プロジェクトの場合はすべてのワークスペースメンバー。プライベートプロジェクトの場合は作成者、ワークスペースのオーナーと管理者、および明示的に追加された全員。これにより、エージェントは名前を推測する代わりに担当者のuidを解決できます。各メンバーのuid、フルネーム、メールアドレス、ワークスペースのロール（owner、admin、member、observer）を返します。これらのuidは、create_card、update_card、create_epic、update_epic、create_roadmap_slotのassigned_toが受け取る値です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子 |
list_board_lists読み取り専用
プロジェクトのかんばんボードのリストを一覧表示して、エージェントが有効なmove_cardの宛先を解決できるようにします。各アクティブなリストを表示順に、そのuid（move_cardのターゲットとして使用可能）と表示名とともに返します。バックログは、空文字列のidを持つ選択可能なエントリとして含まれます。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子（uid） |
list_epics読み取り専用
プロジェクトのエピックを一覧表示して、エージェントがget_epicおよびカード割り当てのためのエピックuidを解決できるようにします。各エピックを表示順（位置の昇順）で、そのuid、番号、名前、説明（Markdown）、色、開始日/終了日、カード数を返します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子（uid） |
| updated_since | string | このISO-8601の日付または日時の時点以降にレコードが変更されたエピックのみ。注意：コレクションの編集（チェックリスト、リンク）はエピックの変更時刻を更新しない場合があります。名前/日付/説明の編集は常に更新します。 |
list_labels読み取り専用
プロジェクトのラベルを一覧表示して、エージェントがカード書き込み時にほぼ重複したものを作成する代わりに、既存の分類法を再利用できるようにします。各ラベルを表示順（位置の昇順）で、そのuid、名前、位置とともに返します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子（uid） |
list_cards読み取り専用
1つのカンバンリスト、またはlist_idを省略・空にした場合はプロジェクトのバックログのカードを、ボード表示順（列の先頭が最初、つまり配置位置の降順 — 製品UIが表示するのと同じ順序）で一覧表示します。フィルターはANDで組み合わせます：epic_id、label_id、assigned_user_id、reporter_idはuidを受け取ります（不明なuidは何も一致しません）。due_dateは指定日以前に期限が来るカードを保持します。アクションに十分なカード概要（uid、タイトル、リスト+位置、エピック、ラベル、担当者、報告者、期限）を返し、get_card / move_card / update_card にそのまま使用できます。limit（デフォルト50、最大100）とoffsetでページングされ、total_countはフィルター後の完全な数です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子（uid） |
| list_id | string | 読み取るリストのuid。バックログの場合は省略するか空文字列を渡します | |
| epic_id | string | 選択したリストまたはバックログ内で、このエピック（エピックuid）のカードのみ。全リストにわたってエピックの全カードを一覧表示するにはget_epicを使用します | |
| label_id | string | このラベル（ラベルuid）を持つカードのみ | |
| assigned_user_id | string | このユーザー（ユーザーuid）に割り当てられたカードのみ | |
| reporter_id | string | このユーザー（ユーザーuid）によって報告（作成）されたカードのみ | |
| due_date | string | この日付以前に期限が来るカードのみ（ISO-8601、例：2026-06-10） | |
| updated_since | string | このISO-8601の日付または日時以降にレコードが変更されたカードのみ — 「前回実行時から何が変わったか」のフィルター。注意：添付コレクション（ラベル、チェックリスト、リンク）への編集はカードの変更時刻を更新しない場合があります。タイトル/説明/スカラー編集は常に更新します。 | |
| limit | integer | ページサイズ、1〜100（デフォルト50） | |
| offset | integer | スキップするカード数（デフォルト0） |
search_cards読み取り専用
1つのプロジェクト内（カンバンボードとバックログ）でのタイトル部分文字列カード検索で、製品のプロジェクト内ライブカード検索と完全に一致します（カードタイトルのみに対するデータベースの大文字小文字を区別しない部分文字列 — 説明やコメントは検索されません。全コンテンツタイプにわたる全文検索にはsearchツールを使用します）。新しく作成された順に並べられます。アクションに十分なカード概要（uid、タイトル、リスト配置+位置、エピック、ラベル、担当者、報告者、期限）を返します。一致がないクエリはエラーではなく空のcards配列を返します。limit（デフォルト50、最大100）とoffsetでページングし、total_countは完全な一致数です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子（uid） |
| query | string | はい | カードタイトルと照合するテキスト（大文字小文字を区別しない部分文字列） |
| limit | integer | ページサイズ、1〜100（デフォルト50） | |
| offset | integer | スキップする一致カード数（デフォルト0） |
list_attention_cardsPro · メトリクス読み取り専用
プロジェクトのカンバンボードで注意が必要なカードを一覧表示します — 製品のメトリクスページと同じリストです。種類：stuck（バックログやDoneではなく列に7日以上動かずに留まっているカード。最も長く留まっているものから順）、blocking（他のカードがブロックされている未完了のカード）、overdue（7日以内に期限が来るか、すでに期限切れのカード。最も早いものから順）。kindは1つのリストまたは'all'（デフォルト）を選択します。オプションで担当者uidまたはリテラル'unassigned'でフィルターできます。要求された各セクションは、get_card / move_card / update_card に使用できるカード概要を返し、limitで上限が設定され、完全なtotal_countが含まれます。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子（uid） |
| kind | enum: stuck | blocking | overdue | all | 返す注意リスト（デフォルト 'all' = 各リストを独自のセクションとして） | |
| assignee_id | string | このユーザーuidに割り当てられたカードのみ、または担当者なしのカードには'unassigned' | |
| limit | integer | セクションごとの最大カード数、1〜100（デフォルト50） |
get_metrics_summaryPro · メトリクス読み取り専用
プロジェクトのカンバンボードで注意が必要なカードのワンコールでのカウント：overdue_cards_count、blocking_cards_count、stuck_cards_count — list_attention_cardsと同じ定義で、各カウントの背後にあるカードを返します。軽量です。より深く調べる価値があるかを判断するために最初にこれを呼び出してください。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子（uid） |
list_roadmap_slotsPro · ロードマップ読み取り専用
日付ウィンドウに重なるプロジェクトのロードマップスロットを一覧表示します（デフォルト：今月から5か月先まで）。スロットは2つの日付の間にエピックをスケジュールし、担当者を持つことができます。1つのエピックが複数のスロットを持つことができ、重複も含まれます — これは設計によるものです。最大200スロットを返します — 上限に達した場合はウィンドウを狭めてください。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子 |
| start_date | string | ウィンドウ開始、ISO-8601（YYYY-MM-DD）。デフォルト：今月の初め | |
| end_date | string | ウィンドウ終了、ISO-8601。デフォルト：start_date + 6か月 |
create_roadmap_slotPro · ロードマップ
プロジェクトのロードマップにエピックをスケジュールします：start_dateからend_dateまでのスロットで、オプションで担当者を指定できます。エピックは複数のスロットを持つことができ、重複は設計上許可されています — 既存のスロットを拡張するつもりなら、追加する前にlist_roadmap_slotsを確認してください。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | プロジェクトの一意の識別子 |
| epic_id | string | はい | エピックuid（list_epicsから）。このプロジェクトに属している必要があります |
| start_date | string | はい | ISO-8601（YYYY-MM-DD） |
| end_date | string | はい | ISO-8601。start_dateと同じ日も許可されます |
| assigned_to | stringの配列 | 割り当てるユーザーuid（プロジェクトメンバー — list_project_usersを参照） |
update_roadmap_slotPro · ロードマップ
ロードマップスロットを更新します：再スケジュールまたはサイズ変更（start_date/end_date）、同じプロジェクトの別のエピックに移動（epic_id）、または担当者を設定します。指定されたフィールドのみが変更されます。ただし、assigned_toは担当者セット全体をREPLACEします — 最初にスロットを読み取り、残すべき全員を送信してください。スロットuidはlist_roadmap_slotsから取得します。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | ロードマップスロットuid |
| epic_id | string | 新しいエピックuid（同じプロジェクト） | |
| start_date | string | ISO-8601（YYYY-MM-DD） | |
| end_date | string | ISO-8601 | |
| assigned_to | stringの配列 | すべての担当者をREPLACEします（ユーザーuid、プロジェクトメンバー）。[] でクリア |
delete_roadmap_slotPro · ロードマップ破壊的
ロードマップスロット（およびその担当者リンク）をPERMANENTLY削除します。これは元に戻せません — ロードマップスロットにはゴミ箱がありません。エピック自体は影響を受けません。再スケジュールするには、update_roadmap_slotを優先してください。Proまたはトライアルワークスペースが必要です。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | ロードマップスロットuid（list_roadmap_slotsから） |
create_label
名前でプロジェクトに新しいラベルを作成します。同じ名前のラベルがすでに存在する場合（大文字小文字を区別しない）、新しいラベルを作成せずに既存のラベルが変更されずに返されます。新しいラベルは表示順の最後に追加されます。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | ラベルが属するプロジェクトuid |
| name | string | はい |
create_card
プロジェクトのカンバンボードにカードを作成します。必須なのはproject_idとtitleのみです。list_idを省略するとカードはバックログに配置されます。positionを省略するとキューの最後に追加されます（move_cardに位置の契約が記載されています）。descriptionはAgileHero Markupです — マークダウンやHTMLではありません。最初にget_ahm_specを読んでください。epic_idと担当者uidはすでに存在している必要があります（list_epics、list_project_users）。一方、まだ存在しないラベル名はプロジェクトに作成されます。estimationはフィボナッチ複雑度（0/1/2/3/5/8/13）で、時間の見積もりではありません。チェックリスト、リンク、添付ファイル、カード関係はすべて同じ呼び出しで指定できます。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | カードが属するプロジェクトuid（カードはプロジェクトのカンバンボードに作成されます） |
| list_id | string | リストuid。バックログに配置する場合は省略 | |
| position | integer | ||
| type | enum: story | bug | chore | research | ||
| title | string | はい | |
| description | string | AgileHero Markup（AHM）— マークダウンやHTMLではありません。最初にget_ahm_specを読んでください。説明の表面：テーブル、色、配置、ディスカッションはありません。 | |
| epic_id | string | エピックuid。プロジェクトにすでに存在している必要があります | |
| estimation | enum: 0 | 1 | 2 | 3 | 5 | 8 | 13 | ストーリーポイントでの複雑度の見積もり（フィボナッチスケール）。時間の見積もりではありません | |
| due_date | string | ISO-8601の日付 | |
| assigned_to | stringの配列 | 担当者ユーザーuid。list_project_usersで確認できます | |
| labels | stringの配列 | ラベル名。不明な名前はプロジェクトに作成されます | |
| checklists | オブジェクトの配列 | 各 { name, items: [{ description, checked }] }。項目は指定された順序を保持します | |
| cards_relations | オブジェクトの配列 | 各 { type, target_card_id（同じボード上のカードuid） } | |
| links | オブジェクトの配列 | 各 { url, description } | |
| attachments | オブジェクトの配列 | 各 { url, name }。ファイルはurlから取得されます |
update_card破壊的
uidで既存のカードを更新します。コレクションについては、add_*/remove_*のデルタフィールド（安全な増分編集：add_labels、remove_assignees、add_checklist_items、check_itemsなど）を優先してください。通常のコレクションフィールド（labels、assigned_to、checklists、cards_relations、links、attachments）は以前の状態を破壊的にREPLACEし、そのデルタと組み合わせることはできません。リストや位置を変更するにはmove_cardを使用し、説明を編集するにはpreview_description_update / update_descriptionを使用してください。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | カードUID |
| type | enum: story | bug | chore | research | ||
| title | string | ||
| epic_id | string | ||
| estimation | enum: 0 | 1 | 2 | 3 | 5 | 8 | 13 | 複雑さの見積もり（ストーリーポイント、フィボナッチ数列）。時間の見積もりではありません | |
| due_date | string | ISO-8601形式の日付 | |
| assigned_to | array of string | 担当者のユーザーUID。list_project_usersで確認可能。カードの担当者を置き換えます | |
| labels | array of string | ラベル名。不明な名前はプロジェクトに作成されます。カードのラベルを置き換えます | |
| checklists | array of object | 各要素は { name, items: [{ description, checked }] }。項目は指定された順序を維持します。カードのチェックリストを置き換えます | |
| cards_relations | array of object | 各要素は { type, target_card_id（同じボード上のカードUID）}。カードの関連を置き換えます | |
| links | array of object | 各要素は { url, description }。カードのリンクを置き換えます | |
| attachments | array of object | 各要素は { url, name }。ファイルはurlから取得されます。カードの添付ファイルを置き換えます | |
| add_labels | array of string | 名前でラベルを追加（不明な名前は作成されます）。既存のラベルは保持されます | |
| remove_labels | array of string | 名前でラベルを削除（大文字小文字を区別しません）。存在しない名前は何もしません | |
| add_assignees | array of string | ユーザーUIDで担当者を追加。既存の担当者は保持されます | |
| remove_assignees | array of string | ユーザーUIDで担当者を削除。存在しないUIDは何もしません | |
| add_checklist_items | array of object | 項目を追加：各要素は { checklist, description, checked? } — 指定されたチェックリストが存在しない場合は作成されます | |
| check_items | array of object | 指定されたチェックリスト内の正確な説明に一致する項目を完了としてマークします | |
| uncheck_items | array of object | 項目を未完了としてマークします（check_itemsと同じ一致方法） | |
| remove_checklist_items | array of object | 項目を削除します。存在しない項目は何もしません | |
| add_relations | array of object | 関連を追加します。既存の関連は保持されます | |
| remove_relations | array of object | 一致する関連を削除します。存在しないものは何もしません | |
| add_links | array of object | リンクを追加：各要素は { url, description? }。既存のリンクは保持されます | |
| remove_links | array of string | 正確なurlでリンクを削除します。存在しないurlは何もしません |
delete_card破壊的
カードをUIDでソフト削除します：ボードとすべてのリストから外れ、他のカードとの関連は削除され、そのカードに関する見積もりセッションは無効化され、リンクされたホワイトボード要素はリンク解除されます。所属していたエピックは削除されません。MCPを通じた削除取り消しはありません。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | カードUID |
move_card
カードを別のリストに移動します（または同じリスト内での位置を変更します）。カンバンボード上のカードのみ移動できます。レトロスペクティブボード上のカードは拒否されます。list_idに空文字列を渡すと、カードはカンバンのバックログに移動します。リストは最上位の位置から上から下に表示されるため、位置0はリストの最下部です。positionを省略すると、バックログ、to_do、in_progressリストではキューの末尾（最下部、位置0）に、doneリストでは最上部に追加されます。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | カードUID |
| list_id | string | はい | 移動先リストUID。空文字列はバックログへの移動（カンバンのみ） |
| position | integer | 移動先内での配置：0が最下部、最大の位置が最上部。0以上、移動先に既にある他のカード数以下である必要があります。省略すると、バックログ、to_do、in_progressリストではキューの末尾（位置0）に、doneリストでは最上部に追加されます。 |
create_epic
プロジェクトにエピックを作成します。必須なのはproject_idとnameのみです。descriptionはAgileHero Markupです — マークダウンやHTMLではなく、最初にget_ahm_specを読んでください。担当者UIDはlist_project_usersから取得します。チェックリスト、リンク、添付ファイルは同じ呼び出しで指定できます。新しいエピックUIDを返します — create_card / update_cardがepic_idとして受け取り、create_roadmap_slotがスケジュールするものです。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| project_id | string | はい | エピックが属するプロジェクトUID |
| name | string | はい | |
| description | string | AgileHero Markup (AHM) — マークダウンやHTMLではなく、最初にget_ahm_specを読んでください。説明の表面：テーブル、色、配置、ディスカッションはありません。 | |
| color | string | #0060F0のような16進カラーコード | |
| start_date | string | ISO-8601形式の日付 | |
| end_date | string | ISO-8601形式の日付 | |
| assigned_to | array of string | 担当者のユーザーUID。list_project_usersで確認可能 | |
| checklists | array of object | 各要素は { name, items: [{ description, checked }] }。項目は指定された順序を維持します | |
| links | array of object | 各要素は { url, description } | |
| attachments | array of object | 各要素は { url, name }。ファイルはurlから取得されます |
update_epic破壊的
既存のエピックをUIDで更新します。指定されたフィールドのみが変更されます。コレクションについては、add_*/remove_*の差分フィールド（安全な増分編集）を優先してください。通常のコレクションフィールド（assigned_to、checklists、links、attachments）は以前の状態を破壊的に置き換え、その差分フィールドと組み合わせることはできません。説明の編集にはpreview_description_update / update_descriptionを使用してください。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | エピックUID |
| name | string | ||
| color | string | #0060F0のような16進カラーコード | |
| start_date | string | ISO-8601形式の日付 | |
| end_date | string | ISO-8601形式の日付 | |
| assigned_to | array of string | 担当者のユーザーUID。list_project_usersで確認可能。エピックの担当者を置き換えます | |
| checklists | array of object | 各要素は { name, items: [{ description, checked }] }。エピックのチェックリストを置き換えます | |
| links | array of object | 各要素は { url, description }。エピックのリンクを置き換えます | |
| attachments | array of object | 各要素は { url, name }。ファイルはurlから取得されます。エピックの添付ファイルを置き換えます | |
| add_assignees | array of string | ユーザーUIDで担当者を追加。既存の担当者は保持されます | |
| remove_assignees | array of string | ユーザーUIDで担当者を削除。存在しないUIDは何もしません | |
| add_checklist_items | array of object | 項目を追加：各要素は { checklist, description, checked? } — 指定されたチェックリストが存在しない場合は作成されます | |
| check_items | array of object | 指定されたチェックリスト内の正確な説明に一致する項目を完了としてマークします | |
| uncheck_items | array of object | 項目を未完了としてマークします（check_itemsと同じ一致方法） | |
| remove_checklist_items | array of object | 項目を削除します。存在しない項目は何もしません | |
| add_links | array of object | リンクを追加：各要素は { url, description? }。既存のリンクは保持されます | |
| remove_links | array of string | 正確なurlでリンクを削除します。存在しないurlは何もしません |
delete_epic破壊的
エピックをUIDでソフト削除します。そのカードは削除されません — ボード上に残り、エピックから切り離されます。エピックのロードマップスロットは完全に削除されます（スロットはエピックをスケジュールするものであり、エピックなしでは意味がないため）、エピックにリンクされたホワイトボード要素はリンク解除されます。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | エピックUID |
create_comment
カードまたはエピックにコメントを追加します。card_idまたはepic_idのいずれか一方を指定してください。コンテンツはAgileHero Markup（AHM、コメントの表面：テーブル、メディア、色、配置、ディスカッションはありません）です — マークダウンやHTMLではなく、最初にget_ahm_specを読んでください。コメントはこのクライアントが操作するサインイン済みユーザーに帰属し、その後のget_card / get_epicの応答に表示されます。コメントはMCP経由で編集できません。delete_commentは自分自身のコメントを削除します（間違いは削除して再投稿で修正してください）。parent_comment_idを渡すと既存のコメントに返信します。スレッドは1レベルまでです：返信への返信は、その返信のスレッドルートに新しいコメントが付くため、ネストした返信は試みないでください。親は同じカードまたはエピックのコメントである必要があります — 他の場所のUIDは拒否されます。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| card_id | string | コメントするカードUID（epic_idとは排他的） | |
| epic_id | string | コメントするエピックUID（card_idとは排他的） | |
| content | string | はい | AgileHero Markup (AHM)としてのコメント本文 |
| parent_comment_id | string | 返信する同じカードまたはエピックのコメントのUID（任意）。トップレベルのコメントには省略します。返信への返信は、その返信のスレッドルートに正規化されます（スレッドは1レベルまで）。 |
delete_comment破壊的
自分が投稿したコメントを削除します（コメントはこのクライアントが操作するサインイン済みユーザーに帰属します — 他の人のコメントは削除できません）。修正パターンは、削除してからcreate_commentで修正したコメントを再投稿することです。返信がある削除済みコメントは、スレッド内に墓標として表示されたままになります。コメントUIDはget_card / get_epicから取得します。
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
| id | string | はい | コメントUID |