AI エージェントとの連携

bee はターミナルツールとして、AI エージェントの「手足」としても活用できます。LLM ベースのエージェントが Backlog のデータを取得・操作する手段として、大きく 2 つのアプローチがあります。

LLM 向けドキュメントエンドポイント

bee のドキュメントサイトでは、LLM がコマンドの使い方を効率的に取得できるエンドポイントを提供しています。AI エージェントにドキュメントを読み込ませる際に活用してください。

/llms.txt: コマンド一覧のサマリー。全体像の把握に最適。
/llms-full.txt: 全コマンドの完全なリファレンスを 1 ファイルで取得。

各ドキュメントページにも .md エンドポイントがあり、個別のページを Markdown 形式で取得できます。

どちらを使うべきか

bee + Skills

ターミナル操作可能な AI エージェント向け

bee の CLI コマンドを AI エージェントの Skill として登録し、エージェントが直接呼び出せるようにする方法です。

利用環境: Claude Code などターミナル操作可能な環境
シェルパイプラインとの組み合わせなど、柔軟な操作が可能
bee browse や bee api など、CLI 固有の機能でブラウザ操作や任意の API 呼び出しが可能
テーブル / JSON の出力切り替えに対応

Backlog MCP Server

MCP 対応クライアント向け

Backlog MCP Server は、Backlog API をネイティブに MCP（Model Context Protocol）化したサーバーです。

利用環境: Claude Desktop など MCP 対応クライアント
構造化されたツール定義により、エージェントが課題の検索・作成・更新などを直接実行できる
MCP 対応のクライアントからそのまま使える

bee + Skills のセットアップ

bee を AI エージェントの Skill として登録する方法です。

bee をインストールする

はじめにの手順に従って bee をインストールし、bee auth login で認証を完了してください。
Skill を登録する

Skills CLI を使って bee の Skill を登録します。
Terminal window
```
npx skills add nulab/bee --skill using-bee
```
Backlog 記法（Markdown ではなく Backlog 独自の記法）を使うプロジェクトでは、構文リファレンスのスキルも追加できます。
Terminal window
```
npx skills add nulab/bee --skill backlog-notation
```
Backlog ではプロジェクトごとに Markdown か Backlog 記法を選択できるため、backlog-notation はインストールしただけでは自動的に適用されません。使いたいときにプロンプトで /backlog-notation PROJECT-123 の説明文をリファクタリングの内容に合わせて更新して のように明示的に指示するか、Backlog 記法を常に使うプロジェクトであれば AGENTS.md に以下のように記載しておくと毎回指示する必要がなくなります。
```
## Backlog

This project's Backlog project uses Backlog notation (Backlog記法).
When writing issues or comments on Backlog, follow the backlog-notation skill for formatting.
```
エージェントから使う

スキルを登録すると、やりたいことを伝えるだけで bee を使って Backlog を操作してくれます。プロンプトに「Backlog」や課題キーなど、Backlog に関連する単語を含めるとスキルがトリガーされます。

Backlog MCP Server のセットアップ

セットアップ方法は Backlog MCP Server の README を参照してください。

`bee api` で柔軟な API アクセス

bee api コマンドを使うと、Backlog の任意の API エンドポイントを直接呼び出せます。MCP ツールとしてまだカバーされていない API にアクセスする場合に便利です。

# ユーザー情報の取得
bee api users/myself

# 課題の検索（クエリパラメータ付き）
bee api issues -f 'projectId[]=12345' -f count=5

# 課題の作成（POST）
bee api issues -X POST -f projectId=12345 -f summary="API から作成した課題"

# 特定フィールドだけ取得
bee api users/myself --json id,name,mailAddress

`--json` を活用したデータ連携

AI エージェントに構造化データを渡すには、--json フラグが便利です。

# プロジェクトの課題をすべて JSON で取得
bee issue list --project MY_PROJECT --json

# 必要なフィールドだけに絞る
bee issue list --project MY_PROJECT --json id,summary,status,assignee

レシピ

実践的なプロンプトの例を用意しています。

AI エージェントで使えるプロンプト集 bee と AI エージェントを組み合わせた実践的なプロンプト例