What you get
エージェントが、ボードを直接さわれる。
UI でできるタスク操作を、そのままエージェントに渡しました。新しい権限の仕組みは持ち込まず、あなたのアカウントでできることだけができます。
会話からタスクを起票
タイトルだけでなく、問題点・実装方針・受入基準・対象範囲まで構造化して登録します。あとから人が読んでも、別のエージェントが拾っても、何をすればいいかが分かるタスクになります。
名前で指示できる
Project やラベルは名前で、ステータスは「進行中」「レビュー中」のような種別で指定できます。ID を覚えさせる必要はありません。名前が複数に当たるときは勝手に選ばず、候補を返して聞き直します。
PR と一緒に進む
GitHub / Bitbucket Cloud のリポジトリを紐付けると、PR が開いたら In Review、マージされたら Done へ自動で移ります。エージェントが更新を忘れても、ボードはリポジトリの実際の状態に追いつきます。
つなぎ方は 2 通り
Claude Desktop や claude.ai は URL を入れてブラウザで許可するだけ。Claude Code や CI からは API キーで接続します。どちらも設定画面からいつでも解除・失効できます。
あなたの権限を超えない
エージェントは接続したユーザー本人として動きます。見られない Project は見えず、読み取り専用の Project には書き込めません。Project のロールもプランの制限も、UI と同じように効きます。
消す操作は既定で渡さない
タスクの完全削除は、既定の権限に含めていません。エージェントができるのはアーカイブまでなので、誤操作があっても元に戻せます。削除が必要なときだけ、明示的に許可します。
Connect
クライアントに合わせて、つなぐ。
どちらの方法でも、つながる先は同じ MCP サーバーです。できることも変わりません。
Claude Desktop / claude.ai
コネクタに URL を入れるだけ。エンジニアでなくても使えます
- Claude の設定で「カスタムコネクタを追加」を開き、下の URL を入力します。
- ブラウザで ONLIVE Backstage にログインし、同意画面で接続するアプリと許可する操作を確認して「許可」を押します。
- 接続は「設定 → API キー」の「接続済みアプリ」に並び、そこからいつでも解除できます。
コネクタの URL
https://backstage.onlive.app/api/mcpClaude Code / CI
API キーで接続。ターミナルやスクリプトから使う場合に
- ONLIVE Backstage の「設定 → API キー」でキーを発行します。名前・有効期限・許可する操作を選べます。
- キーは発行直後の 1 回だけ表示されます。安全な場所に控えてください。
- 下のコマンドで Claude Code に登録します。不要になったキーは同じ画面から失効できます。
Claude Code に登録
claude mcp add --transport http onlive \
https://backstage.onlive.app/api/mcp \
--header "Authorization: Bearer $ONLIVE_API_KEY"How it works
頼んでから、Done になるまで。
- 「これをタスクにして」
- エージェントが create_task でタスクを登録します。問題点・実装方針・受入基準はタスクの説明に Markdown で入るので、UI からそのまま読めて、手で直すこともできます。
- 「次にやるものを選んで」
- list_tasks でステータス・担当者・ラベルなどから絞り込み、get_task で仕様と紐付いた PR の状況を読みます。
- 着手する
- start_task でタスクが In Progress に移り、担当者に接続したユーザーが付きます。作業用のブランチ名(
onlive/<タスク ID>/…)も返すので、エージェントはそこに実装を push します。 - PR を出す
- create_pull_request で PR を作ると、タスクは In Review へ移り、PR の URL がコメントに残ります。PR を手で作っても、リポジトリの webhook 経由で同じ状態になります。
- PR がマージされる
- webhook を受けて Done へ移ります。レビューとマージの判断は GitHub / Bitbucket 側に任せていて、ONLIVE Backstage がマージすることはありません。マージせずに閉じた PR ではタスクを動かしません。
- 途中経過を残す
- add_comment で調べたことや判断の理由をタスクのコメントに書き残せます。あとからチームの誰が見ても、経緯を追えます。
Details
仕様
- 対象プラン
- Pro / Team(ベータ期間中は無料で開放中)
- 対応クライアント
- Claude Code / Claude Desktop / claude.ai(カスタムコネクタ)など、MCP の Streamable HTTP に対応したクライアント
- エンドポイント
https://backstage.onlive.app/api/mcp- 認証
- OAuth 2.1(ブラウザでの同意が必須)または API キー(Authorization: Bearer)
- ツール
- list_projects / list_tasks / get_task / create_task / update_task / add_comment / archive_task / start_task / create_pull_request / delete_task
- 許可する操作
- 読み取り(tasks:read)・書き込み(tasks:write)が既定。完全削除(tasks:delete)は明示的に許可したときだけ。許可していない操作のツールはエージェントに見せません
- 権限
- 接続したユーザー本人と同じ。Project のロール、読み取り専用の Project、プランの制限は UI と同じように効きます
- レート制限
- API キー / 接続ごとに 1 分あたり 60 リクエスト
- リポジトリ連携
- GitHub / Bitbucket Cloud。Project 設定で紐付け(Project の管理権限が必要)、リポジトリに webhook(Pull requests)を 1 つ登録します。PR の自動作成を使うときだけ、Pull requests の読み書き権限を持つアクセストークンを登録します
- ONLIVE がしないこと
- コードの push、PR のレビュー、マージ。預かるトークンにもコードの書き込み権限は要りません
- 管理
- 「設定 → API キー」で API キーの発行・失効と、接続済みアプリの解除ができます
FAQ
よくある質問
- どの AI クライアントから使えますか。
- Claude Code・Claude Desktop・claude.ai(カスタムコネクタ)など、MCP の Streamable HTTP に対応したクライアントから使えます。Claude Desktop / claude.ai は URL を入れてブラウザで許可し、Claude Code や CI からは API キーで接続します。
- AI エージェントがタスクを消してしまうことはありませんか。
- タスクの完全削除は既定の権限に含めていません。エージェントができるのはアーカイブまでで、完全削除は明示的に許可したときだけ使えます。また、エージェントは接続したユーザー本人の権限を超えて操作できません。
- MCP 連携はどのプランで使えますか。
- Pro / Team の機能です。ベータ期間中は無料で開放しています。
- GitHub 以外のリポジトリにも対応していますか。
- GitHub と Bitbucket Cloud に対応しています。PR が開くと In Review、マージされると Done へタスクが自動で移ります。レビューとマージの判断はリポジトリ側に任せていて、ONLIVE Backstage がマージすることはありません。