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

Busabase プラグインは、Codex から Busabase Cloud を使う最短のセットアップです。ホスト型 OAuth MCP プロファイルと、再利用可能な 2 つの skill をまとめてインストールします。

• $busabase: ワークスペースの確認、Change Request の提案、承認済みデータの利用。
• $busabase-app-creator: 完全な Busabase ワークスペースアプリの作成。

プラグインは公開 busabase/skills リポジトリから配布されます。Busabase API Key の設定は不要です。

1. Marketplace とプラグインを追加する

ターミナルで実行します。

codex plugin marketplace add busabase/skills
codex plugin add busabase@busabase

最初のコマンドは GitHub リポジトリを busabase marketplace として登録し、2 つ目はそこから busabase プラグインをインストールします。

両方の状態を確認します。

codex plugin marketplace list
codex plugin list

Codex を起動して /plugins を入力し、インストール済みプラグインと内蔵 skill を確認することもできます。

2. Cloud MCP 接続を認可する

プラグインのインストールと MCP の認可は別の状態です。Busabase OAuth を開始します。

codex mcp login busabase --scopes mcp
codex mcp list

対象ワークスペースを所有する Busabase アカウントでブラウザー認可を完了します。必要最小限の権限と有限の有効期限を選び、通常のエージェント作業では changeRequest を優先してください。

codex mcp list の busabase 行は OAuth 認証を表示する必要があります。Not logged in のままなら login コマンドを再実行し、そのコマンドが待機中の間に新しく開いたブラウザー画面を完了してください。

3. 新しい Codex タスクを開始する

インストールとログイン後に新しいタスクを開始し、プラグインの skill と認証済みツールカタログを読み込みます。新しいタスクで:

1. /plugins を開き、Busabase がインストール済みで有効なことを確認する。
2. /mcp を開き、busabase サーバーが接続済みなことを確認する。
3. Codex に auth_verify を呼ばせる。
4. 複数のスペースが返った場合は 1 つ選び、その ID を targetSpaceId として使う。
5. 読み取り専用の接続確認として bases_list を呼ばせる。

Busabase は曖昧な複数スペースへの呼び出しを推測せず拒否します。

4. 内蔵 skill を使う

目的を直接伝えるか、skill を明示的に呼び出します。

$busabase 選択したワークスペースの Base を一覧にして、それぞれの用途を要約してください。

$busabase-app-creator Busabase に軽量なコンテンツカレンダーアプリを作成してください。

プラグインは Busabase の approval-first workflow に従います。Change Request を提案できますが、明示的な指示なしにレビュー、マージ、クローズしてはいけません。

更新または再接続

Git marketplace を更新します。

codex plugin marketplace upgrade busabase

更新後は新しい Codex タスクを開始して、更新された bundle を読み込んでください。

Busabase アカウントの切り替えや期限切れ grant の置き換え:

codex mcp logout busabase
codex mcp login busabase --scopes mcp
codex mcp list

組織ポリシーが Git marketplace を禁止している場合は、管理者に https://github.com/busabase/skills の許可を依頼するか、MCP を直接設定してください。

どのセットアップを使うべきですか？

Codex プラグイン公式ドキュメント · Busabase skill とプラグインのソース