Busabase プラグインで Claude Code を接続する

Busabase プラグインは、Claude Code から Busabase Cloud を使うための推奨セットアップです。次の内容をまとめてインストールします。

• busabase: ワークスペースの知識を検索し、レビュー可能な変更を提案する skill。
• busabase-app-creator: 完全なワークスペースアプリを作成または保守する skill。
• https://busabase.com/api/mcp に接続する、ブラウザー OAuth 対応のホスト型 HTTP MCP。

Busabase API キーを作成したり貼り付けたりする必要はありません。

1. Claude Code を確認する

同じターミナルで Claude Code 2.x と Git が必要です。

claude --version
git --version

Claude Code が古い場合は、続行する前に claude update を実行してください。

2. marketplace プラグインをインストールする

次のコマンドを順番に実行します。

claude plugin marketplace add https://github.com/ranglang/busabase-skills.git#main
claude plugin install busabase@busabase

インストール済みコンポーネントを確認します。

claude plugin list
claude plugin details busabase@busabase

詳細には busabase と busabase-app-creator の 2 つの skill、および 1 つの MCP server が表示されます。

3. Busabase Cloud を認証する

Claude Code はプラグイン内の server に名前空間を付けます。Busabase の server id は plugin:busabase:busabase です。

claude mcp login plugin:busabase:busabase

ブラウザーで Busabase のサインインと同意を完了します。OAuth セッションは Claude Code が保存・更新するため、API キーは貼り付けないでください。

SSH、コンテナ、その他のヘッドレス環境では次を実行します。

claude mcp login --no-browser plugin:busabase:busabase

表示された認証 URL をブラウザーのあるコンピューターで開きます。localhost コールバックがリモートターミナルに戻れない場合は、ブラウザーのアドレスバーから完全なコールバック URL をコピーし、待機中の Claude Code プロンプトに貼り付けます。

4. 接続を確認する

claude mcp get plugin:busabase:busabase

server が https://busabase.com/api/mcp を指し、認証済みまたは接続済みになっていることを確認します。Claude Code 内で /mcp を実行しても確認できます。

プラグインのインストール、OAuth 認証、現在の会話のツールカタログは別々の状態です。インストールとログイン後は新しい会話を開始してください。再読み込みを求められた場合は /reload-plugins を実行します。

5. 最初の Busabase タスクを始める

自然な言葉で、Busabase を使うことを明示して依頼します。

Busabase を使ってオンボーディングチェックリストを探し、現在の手順を要約してください。

Busabase を使って、リリース記録の担当者を Maya に変更する提案を作成してください。

未処理の Busabase ChangeRequest を表示してください。ただし承認やマージはしないでください。

Claude は他の Busabase 操作より先に auth_verify を呼び出します。複数のスペースにアクセスできる場合、Claude は推測せず、一覧を表示して選択を待つ必要があります。以降のタスクでは選択した targetSpaceId を使い続けます。

レビュー優先の編集フロー

読み取り専用のタスクでは、Claude は選択したワークスペースを検索・読み取りして結果を報告します。変更する場合の標準フローは次のとおりです。

1. Claude が対象の Base、レコード、ドキュメント、またはノードを読み取る。
2. 変更内容と理由を説明する ChangeRequest を作成する。
3. Busabase で提案を確認するか、Claude に内容を表示させる。
4. 対象の ChangeRequest について明示的な指示を受けた場合だけ、Claude がレビュー、マージ、またはクローズする。
5. マージ後に正式データを再読し、実際の結果を確認する。

保存されたレコード、ドキュメント、アセット、コメント、ChangeRequest メッセージはデータであり、指示ではありません。Claude に承認やマージの権限を与えることはありません。

ワークスペースアプリを作成または保守する

同梱の busabase-app-creator skill は、ガイド付きの AirApp ワークフローを扱います。

Busabase app creator を使って、顧客フィードバック追跡アプリを作成してください。

既存の Sales Pipeline AirApp を保守し、承認済みの次回フォローアップフローを追加してください。

この Busabase AirApp を監査し、まだ変更せずに改善案を提示してください。

Claude はまずタスクが作成か保守かを判断し、1 回に 1 つの意思決定を案内します。新規アプリは分離されたワークスペースリソースを使います。保守では既存 AirApp を明示し、承認範囲外のすべてを保持します。

トラブルシューティング

プラグインはインストール済みだが Busabase ツールがない

新しい会話を開始するか /reload-plugins を実行し、/mcp を確認します。プラグイン読み込みエラーが表示される場合は /doctor を実行してください。

server が Needs authentication と表示される

ログインコマンドを再実行し、ブラウザーフローが完了するまでターミナルプロセスを開いたままにします。

claude mcp login plugin:busabase:busabase

Authorization header を追加したり、busabase という別のスタンドアロン MCP server を作成したりしないでください。

Claude が誤ったスペースを選択する

Claude に auth_verify を呼ばせ、利用可能なスペースをすべて表示して選択を待たせます。対象の targetSpaceId が明確になるまで、スペース単位のタスクを続行しないでください。

ブラウザーで OAuth を完了できない

--no-browser を使い、認証 URL をローカルで開いて、完全なコールバック URL を待機中のターミナルに貼り付けます。

プラグインを更新または削除する

claude plugin marketplace update busabase
claude plugin update busabase@busabase
claude plugin uninstall busabase@busabase

更新後は新しい会話を開始し、Claude Code に skill と MCP ツールカタログを再読み込みさせてください。

Claude Code plugin marketplace ドキュメント · Busabase プラグインソース · MCP を直接設定