エージェントで始める
Busabase Cloud または Desktop を選び、エージェントに合う接続方法を設定し、必要な場合だけ MCP を追加します。
このプロンプトをエージェントにコピーして、ワークスペースのオンボーディングスキル（SETUP_SKILL.md）を開きます。接続済みの Busabase MCP があれば再利用し、なければログインします。接続後、常設の Busabase スキルをインストールします。
このページは Codex、Claude Code、Cursor、Gemini CLI、その他のコーディングエージェント 共通の入口です。決めることは 3 つだけです。Busabase をどこで動かすか、クライアントに合うセットアップはどれか、そして任意の MCP 接続が必要かです。
何を即反映してよいかはあなたが決めます
エージェントは ChangeRequest を通じて書き込むため、すべての変更にメッセージ・差分・取り消せる履歴が残ります。その書き込みが即反映されるかレビュー待ちになるかは、使う API キーの権限レベル次第です。changeRequest 権限のキーを発行すれば、書いた内容はすべてあなたの承認を待ちます。いずれの場合も、具体的なレビュー判断をあなたが明示しない限り、承認・マージ・クローズしてはいけません。
Busabase Cloud または Desktop を選ぶ
複数のデバイス、チームメンバー、ホスト型エージェント、ウェブチャット製品からワークスペースへ接続する場合は Busabase Cloud を選びます。Cloud 接続はブラウザー OAuth を使い、ホスト先は https://busabase.com です。
対象ワークスペースを開きます。現在選択中のスペースを含むプロンプトが必要な場合は Dashboard → Agent Skills を使います。
エージェントをセットアップする
横方向のタブからエージェントを選び、パネル右側のドロップダウンから Busabase エディションを選びます。別のエージェントへ切り替えても、現在のエディション選択は維持されます。
専用の Codex プラグインガイドを使います。プラグインには Busabase skills とホスト型 OAuth MCP プロファイルが含まれるため、Cloud では最も簡単な方法です。
このプロンプトをエージェントに渡す
https://busabase.com/ja/docs/codex-plugin を読み、Codex 向け Busabase Plugin のインストールと環境初期化を完了してください。完了後に Busabase 接続を確認してください。任意で MCP を追加する
エージェントや IDE から Busabase tools を直接呼び出す場合に MCP が便利です。Cloud 用 Codex または Claude Code プラグインをすでにインストールした場合、このステップはスキップしてください。正しい MCP server がプラグインに含まれています。
クライアントを設定する
codex mcp add busabase --url https://busabase.com/api/mcp
codex mcp login busabase --scopes mcp
codex mcp list接続する
ブラウザーで OAuth を完了し、/mcp を開いてツールが有効であることを確認します。
ワークスペースを確認する
auth_verify を実行し、複数スペースが返った場合は使用するスペースを確認して、その targetSpaceId で bases_list を実行します。
Base または Skill Node からタスクのプロンプトをコピーする
特定の Base または Skill Node に関する作業なら、そのノードを開いて Agent prompts を選びます。Skill Node はこのタブが最初に開きます。Base では上部の More actions（···）→ Agent prompts、またはサイドバーのノードメニューから開けます。組み込みまたはカスタムのシナリオを選び、Copy を押して、普段使っている外部エージェントに貼り付けます。
公開 Demo の画面です。Space とノードの ID は例なので、自分のワークスペースで対象ノードを開いてからコピーしてください。
コピーされる文面には対象ノードと Space、接続確認の指示、未接続の場合のセットアップガイドが含まれます。Skill Node の Use this skill シナリオは、そのノードの SKILL.md を読むようエージェントに伝えます。既存データに対する具体的な作業を渡すときに便利です。まだ対象ノードを決めていない場合は、Dashboard → Agent Skills から Space 全体の接続を始めます。
外部で実行したタスクの結果を Busabase に戻す
接続したエージェントは、別のツールで作業を終えた後、インストール済みの Busabase Skill を使って結果をチームのレビューへ送れます。Busabase が外部ツールを自動監視するわけではありません。結果ごとにエージェントまたは連携処理から送信します。
- 対象 Space の Agent Skills を開き、その Space を含むセットアッププロンプトをタスクを実行するコーディングエージェントに渡します。セットアップ後、接続先の Space を確認させてください。Cloud では Codex プラグインまたは Claude Code プラグインで Skill と MCP 接続をまとめて導入できます。他のコーディングエージェントはセットアッププロンプトを使います。ブラウザー型のチャット製品では shell で Skill をインストールできないため、MCP 接続を使います。
- Task results Base を作り、外部タスクの固定 ID、元のシステム、直近の実行状態、試行回数、終了時刻、短い結果、証拠への URL、レビュー状態を保存します。詳細ログとファイルは元のシステムに置き、特定の実行を開けるリンクを記録します。各再試行の履歴が必要なら、実行 ID ごとに記録する Task attempts Base を関連付けます。
- 人の確認が必要なら、エージェントに
changeRequestレベルのキーまたは OAuth 権限を渡します。元のシステムとタスク ID で既存レコードを探してから作成・更新を提案させ、再試行で重複を作らないようにします。変更理由と証拠へのリンクも付けます。チームが Inbox → For review で確認、承認、マージして初めて正式なレコードに反映されます。レビュー待ちの提案はライブの進捗には表示されません。ライブ状態が必要なら、別途明示的に許可した書き込み経路を用意します。
接続済みエージェントへの最初の依頼例：
インストール済みの Busabase Skill を使い、接続先の Space を確認してください。Task results Base を作成または探してください。外部タスク SYNC-428 について、元のシステムとタスク ID で既存レコードを探してから変更を提案してください。直近の結果、試行回数、短い要約、該当する実行の証拠リンクを記録し、人のレビューへ提出してください。自分で承認・マージせず、Change Request のリンクを読み返してください。ツールを実行できるエージェントでは Skill が Busabase の操作を案内します。別の製品にコネクターを組み込む場合は、MCP + OAuth または REST API から同じレビュー可能な変更を提出できます。レビューの境界については Change Requests を参照してください。
次に読むページ
エージェントを持ち込む
標準プロンプト、常設 skill、日常の変更リクエストワークフローを理解します。
Codex プラグイン
Codex 用の Busabase Cloud 専用プラグインをインストールします。
Claude Code プラグイン
Claude Code 用 Busabase Cloud プラグインをインストールして確認します。
MCP + OAuth
対応するエージェントやチャットクライアントへ MCP を直接設定します。
その他の接続方法：連携方法の一覧 · CLI · SDK · MCP · OpenAPI / REST · Agent Skills · Webhook