AIエージェントから使う(APIキー・MCP)

Claude Code などの AI エージェントから、KadaiLog の課題を読み書きできます。

APIキーを発行する

「個人設定」→「APIキー」を開きます。
「キーの名前」(例: Claude Code (MacBook))を入力します。
キーの使える範囲を選びます(下の「キーの範囲を絞る」)。そのままでよければ「読み書き」「すべて」「なし」のままにします。
「発行する」を押し、表示されたキーを「コピー」して控えます。キーが表示されるのはこの1回だけです。

使わなくなったキーは「失効させる」で無効にします。

キーの範囲を絞る

発行するときに、そのキーでできることを絞れます。AI エージェントに渡すキーは、読み取り専用・必要なプロジェクトだけ・有効期限つきにしておくと、エージェントが想定外の変更をしたり、キーが漏れたときの影響を小さくできます。

項目	選べる値	絞ったときの動き
権限	「読み書き」(標準)/「読み取り専用」	読み取り専用のキーでは、課題の作成・更新、コメントの追加・編集、関連課題・ウォッチの変更、通知の既読化、Wiki の作成・更新、プロジェクト設定(マスタ)の作成・変更ができません
対象プロジェクト	「すべて」(標準)/「選ぶ」→ プロジェクトを選択	選んだプロジェクトの課題・Wiki・通知だけを扱えます。ほかのプロジェクトは一覧にも出ません
有効期限	「なし」(標準)/「30日」/「90日」/「1年」	期限を過ぎると、そのキーは使えなくなります(一覧に赤く「期限切れ」と出ます)

発行後に範囲は変えられません。変えたいときは、新しいキーを発行して AI エージェントの設定を入れ替え、古いキーを失効させます。

キーの一覧には、各キーの権限・対象プロジェクト・有効期限・最後に使われた日時が出ます。以前に発行したキーは「読み書き・すべてのプロジェクト・期限なし」として、これまでどおり動きます。

MCP サーバーの設定

プロジェクトの .mcp.json に次のように設定します。

{
  "mcpServers": {
    "kadailog": {
      "command": "npx",
      "args": ["-y", "@nocodelab/kadailog-mcp"],
      "env": { "KADAILOG_API_KEY": "発行したキー" }
    }
  }
}

利用できる機能

AI エージェントには、自然言語で操作を指示できます。AI エージェントは、以下のツールを必要に応じて組み合わせて操作を実行します。

アカウント情報・通知

ツール	操作内容	指示の例
`get_myself`	自分の表示名・権限と、スペースの情報を確認	「KadaiLog で私は誰としてつながっている?」
`list_my_issues`	自分が担当の課題を、参加している全プロジェクトから期限が近い順に表示	「今日やることを教えて」
`list_notifications`	自分宛ての通知を新しい順に表示(未読だけにもできます)	「未読の通知をまとめて」
`mark_notifications_read`	通知を既読にする(課題ごと、またはすべて)	「RENEW-12 の通知は確認したので既読にして」

課題・コメント

ツール	操作内容	指示の例
`list_projects`	参加しているプロジェクトの一覧	「参加しているプロジェクトは?」
`get_project_meta`	プロジェクトのステータス・種別・カテゴリ・マイルストーン・メンバー(メンバーのメールアドレスは管理者のキーでだけ表示)	「RENEW のステータスの種類を教えて」
`list_issues`	課題を担当者・ステータス・種別・マイルストーン・カテゴリ・更新日時などで絞り込み	「RENEW で今週更新された未完了の課題は?」
`search_issues`	スペース全体の課題を件名・本文のキーワードで検索(2文字以上)	「証明書に関する課題を探して」
`get_issue`	課題1件の詳細(親課題・子課題・関連課題・ウォッチ中かどうかも含む)	「RENEW-12 の内容を要約して」
`get_issue_context`	課題1件の本文・コメント・親子と関連課題・直近の変更履歴・添付の一覧を1回でまとめて読む(コメントが多いときは新しいものから一定数まで。続きは `list_comments`)	「RENEW-12 の経緯をまとめて」
`get_issue_history`	課題の変更履歴(だれが・いつ・何を変えたか。画面からの変更か、APIキー(AI エージェントなど)からの変更かも分かります)	「RENEW-12 の担当はいつ誰に変わった?」
`list_recent_activities`	最近の更新(課題の作成・更新、コメントの追加)を新しい順に表示	「昨日から何が変わった?」
`create_issue`	課題を作成	「この不具合を RENEW に課題として登録して」
`update_issue`	課題の項目を変更(ステータス・担当者・期限日など)。コメントも一緒に渡せます(変更とコメントを1回で保存し、同じ人へのメールは1通にまとまります)	「RENEW-12 を完了にして、対応内容をコメントして」
`list_comments`	課題のコメントを古い順に表示	「RENEW-12 のやり取りを時系列でまとめて」
`add_comment`	課題にコメントを追加(`@表示名` でメンションできます)	「RENEW-12 に調査結果をコメントして」
`update_comment`	自分が書いたコメントの本文を直す(画面には「(編集済み)」と出ます。ほかの人のコメントは直せません)	「さっきのコメントの日付が間違っていたので直して」

ツール	操作内容	指示の例
`link_issues` / `unlink_issues`	課題どうしを関連課題としてつなぐ・外す(別のプロジェクトの課題ともつなげます。両方の課題に表示されます)	「RENEW-12 と RENEW-15 を関連付けて」
`watch_issue` / `unwatch_issue`	自分として課題をウォッチする・やめる(ウォッチ)	「RENEW-12 をウォッチして」
`list_watching`	自分がウォッチ中の課題を、更新の新しい順に表示	「ウォッチしている課題で最近動いたものは?」

添付ファイル

ツール	操作内容	指示の例
`list_attachments`	課題本体とコメントに添付されたファイルの一覧	「RENEW-12 に添付されているファイルは?」
`get_attachment`	添付ファイルを読む。テキスト(md・txt・csv・json など)は本文を、画像(png・jpeg・gif・webp)は画像として渡します。PDF などそのほかのファイルは、10分間だけ使えるダウンロード用の URL を返します	「RENEW-12 のコメントに付いている議事録.md を読んで要点をまとめて」

読めるのは、課題本体とコメントの添付ファイルです。テキストは先頭の1MBまで、画像は5MBまでです。プロジェクトの「ファイル」と Wiki の添付ファイル、ファイルのアップロードには対応していません。

プロジェクト設定(マスタ)

管理者のキーだけが使えます(画面のプロジェクト設定と同じです)。

ツール	操作内容	指示の例
`create_milestone` / `update_milestone`	マイルストーン(発生バージョンと共通)の追加、名前・開始日・期限日の変更	「RENEW に 11月リリースのマイルストーンを作って、未完了の課題に付けて」
`create_category` / `update_category`	カテゴリの追加・名前の変更	「RENEW にカテゴリ『API』を追加して」
`create_type` / `update_type`	種別の追加、名前・色の変更	「種別『要調査』を黄色で追加して」
`create_status` / `update_status`	ステータスの追加、名前・色の変更	「『レビュー中』というステータスを追加して」

追加したステータスは「完了」のすぐ前に、種別・マイルストーンは一番下に入ります。並び替えは画面から行います。
完了として扱うステータスは追加・変更できません。
削除と、「使う項目」(カテゴリ・マイルストーン・発生バージョンを使うかどうか)の切り替えは、画面のプロジェクト設定から行います(プロジェクト設定)。
課題の作成・更新で存在しない名前を指定しても、自動では追加されません(候補つきのエラーになります)。表記ゆれで項目が増えないようにするためです。

Wiki

ツール	操作内容	指示の例
`list_wiki_pages`	プロジェクトの Wiki ページの一覧(タイトル・本文のキーワードで絞り込みもできます)	「RENEW の Wiki にどんなページがある?」
`get_wiki_page`	Wiki ページの本文を読む	「RENEW の Wiki『10. 概要/01. 用語集』を読んで」
`create_wiki_page`	Wiki ページを作成	「今日の打ち合わせメモを RENEW の Wiki に作って」
`update_wiki_page`	Wiki ページのタイトル・本文を変更	「用語集のページに『SLA』の説明を追記して」

Wiki のページはタイトルで指定します。タイトルの「/」区切りは階層になり、「親/子」の形のタイトルで作ると親ページの下に入ります。本文の更新は全文の置き換えになるため、エージェントは先にページを読んでから書き換えます。エージェントが読んだときの更新日時を添えて書き換えた場合、その後にほかの人が同じページを更新していれば、上書きせずにエラーで止まります。

件数が多いとき

一覧の操作は、1回に最大100件まで取得できます(既定は課題の一覧と Wiki の一覧が50件、通知が20件、最近の更新が30件、キーワード検索が20件)。課題の一覧・自分の担当課題・ウォッチ中の課題・通知・最近の更新・Wiki の一覧は、続きがあればエージェントが続きを取得できます。「RENEW の未完了課題をすべて一覧にしてください」のように指示すると、必要なだけ続きを読み進めます。

プロンプト

MCP には、ツールのほかに定型の頼みかた(プロンプト)が入っています。Claude Code では / から、claude.ai ではコネクタのメニューから選べます(対応は AI アプリによって違います)。

プロンプト	内容
今日の自分のタスク	自分の担当課題を、期限切れ・今日・今週・それ以降に分けて整理します
週報を作る	指定した期間の完了・更新から、週報の下書きを作ります
課題を子課題に分ける	大きな課題を読んで子課題の案を出し、確認してから作成します
返事をしていないメンション	自分宛てのメンションのうち、まだ返事をしていないものを洗い出します

補足

プロジェクトキーを変更した後も、古いキー(例: OLD-12)のまま課題を指定できます。
ステータスや種別の名前を間違えると、候補つきのエラーが返り、エージェントが自分で言い直します。
参加していないプロジェクトやその課題は、APIキーからは見えません。指定しても、存在しないときと同じ「見つからない」扱いになります。
get_myself の結果には、そのキーの権限・対象プロジェクト・有効期限(apiKey)も入ります。エージェントが「このキーではできない」と答えたときは、ここで範囲を確かめられます。
最近の更新では、同じ人が10分以内に続けて変えた内容が1件にまとまります。また、Backlog から移行したコメントは含まれません。
AI から行った変更も変更履歴に記録され、画面から操作したときと同じように通知が届きます。
担当者・作成者・コメントの投稿者などは、管理者のキーではメールアドレス、メンバー・ゲストのキーでは表示名で表示されます。担当者の指定は、どのキーでもメールアドレス・表示名のどちらでもできます。
課題やコメントの作成で通信が途中で切れたときは、エージェントが同じ内容を送り直しても二重に登録されません(下の「REST API で使う」の Idempotency-Key をエージェントが自動で付けています)。
APIキー1つにつき、1分あたり120回(うち書き込みは60回)まで呼び出せます。超えると、待つ秒数を添えたエラーが返り、エージェントが待ってからやり直します。残り回数は応答のヘッダー(X-RateLimit-Remaining)で分かります。
KadaiLog のメンテナンス中は、API と MCP がすべて 503 を返します。エージェントには「メンテナンス中のため利用できません」と再試行の目安が返るので、終了後にやり直してください(メンテナンスモード)。

エラーが出たとき

AI エージェントが「KadaiLog の操作に失敗した」と答えたときは、エラーのメッセージにキーの状態が書かれています。

メッセージ(抜粋)	原因	対処
「このAPIキーは … に期限切れになりました」	キーの有効期限が切れています	新しいキーを発行し、エージェントの設定のキーを入れ替えます
「このAPIキーは読み取り専用です(必要: 読み書き)」	読み取り専用のキーで、課題の作成・更新などをしようとしました	その操作は画面から行うか、読み書きのキーを発行して入れ替えます
「このAPIキーはプロジェクト RENEW だけに使えます」	対象プロジェクトに入っていないプロジェクトを指定しました	対象プロジェクトを広げたキーを発行して入れ替えます
「この操作には管理者権限が必要です」	管理者でない人のキーで、プロジェクト設定(マスタ)を変えようとしました	管理者に頼むか、画面から管理者が操作します
「他の人のコメントは編集できません」	ほかの人が書いたコメントを直そうとしました	書いた本人が直すか、新しいコメントで補足します
「APIキーが無効です」	キーを失効させたか、設定の値が間違っています	個人設定でキーを確認し、必要なら発行し直します
「… がありません」	課題・プロジェクト・ページが存在しないか、キーの持ち主が参加していません	名前やキーを確認します(候補がメッセージに出ます)

REST API で使う

スクリプトなどから REST API で直接使う場合の接続先は https://api.kadailog.com/v1 です。Authorization: Bearer 発行したキー を付けて呼び出します。API の利用は1分あたり60リクエストまでです。

課題・コメントの作成などの POST には、Idempotency-Key ヘッダー(リクエストごとに新しい UUID など)を付けられます。タイムアウトなどで同じリクエストを送り直したとき、24時間以内であれば新しく作らずに1回目の結果を返すので、二重登録を防げます。

2回目の結果には Idempotent-Replayed: true ヘッダーが付きます。
同じキーを内容の違うリクエストに使うと、エラー(422)になります。
1回目の処理中に送り直したときは 409 が返ります。数秒待って、同じキーで送り直してください。
エラーになったリクエストの結果は残りません。直して同じキーで送り直せます。

課題やコメントの更新を Slack などへ通知したいときは、Webhookを使います。