busabase

Busabase のスキルとプラグイン

English | 简体中文 | 繁體中文 | 日本語

Busabase 用のエージェントスキルとプラグインです。AI エージェント向けのオープンソースのデータベース兼ワークスペースです。書き込みはすべて、メッセージと差分を含む変更リクエストとして扱われます。書き込み権限がある場合はすぐに反映され、それ以外の場合は人によるレビューを待ちます。

2 つのスキルを 5 通りの方法でインストールできます。エージェントが対応している方法を選んでください。

インストール

skills（Claude Code、Cursor、Codex、… — 常に最新）

npx skills add busabase/skills

Agent Plugins v1（ポータブルパッケージ）

リポジトリのルートは、Agent Plugins Specification v1.0.0 に準拠しています。plugin.json はポータブルマニフェスト、skills/ は Agent Skills を格納し、mcp.json はホスト型の Streamable HTTP MCP サーバーを宣言します。Agent Plugins 形式に対応したクライアントで、このリポジトリのルートをインストールまたは読み込んでください。

Agent Plugins v1 では、OAuth と認証情報の管理をクライアントに委ねています。既存の Claude Code および Codex パッケージは、専用のブラウザー OAuth 動作を引き続き使用します。互換性の対応表と検証については、 docs/agent-plugins.md を参照してください。

Claude Code プラグイン

claude plugin marketplace add https://github.com/busabase/skills.git
claude plugin install busabase@busabase
claude mcp login plugin:busabase:busabase

Claude Code プラグインは、ブラウザー OAuth を使用して https://busabase.com/api/mcp に接続します。Claude は、同梱されたサーバーに plugin:busabase:busabase という名前空間を割り当てます。認証済みのツールカタログを利用できるよう、インストールとログインの後に新しい会話を開始してください。完全な検証および復旧手順については、 docs/claude-code-install.md を参照してください。

メンテナーは、 docs/codex-to-claude-code-port.md でホストごとのマニフェスト、MCP、OAuth、スキル、検証の違いについても確認してください。

Codex プラグイン

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

Codex プラグインは https://busabase.com/api/mcp に接続し、標準のブラウザー OAuth フローを開いて、厳選された 22 個のツールカタログを公開します。API キーの設定は不要です。

プラグインのインストールと MCP の認証は別の状態です。ブラウザーに Authentication complete と表示されたら、Busabase のタスクを開始する前に、接続が保存されたことを確認してください。

codex mcp list

busabase の行で、Auth が OAuth と表示されているはずです。それでも Not logged in と表示される場合は、codex mcp login busabase をもう一度実行し、そのコマンドが実行中の間に新しく開いたブラウザータブで認証を完了してください。ログインに成功したら、新しい Codex タスクを開始し、認証済みのツールカタログを読み込んでください。

MCP（MCP 対応エージェント全般）

エージェントを、ワークスペースの Streamable-HTTP エンドポイントに接続してください。

• デスクトップ／ローカル：http://localhost:15419/api/mcp（認証不要）
• クラウド：https://busabase.com/api/mcp（Authorization: Bearer $BUSABASE_API_KEY を送信）

Codex では、標準の OAuth を使って、クラウド MCP の全機能を直接利用できます。

codex mcp add busabase --url https://busabase.com/api/mcp
codex mcp login busabase

ポータブルなルートの mcp.json は、Agent Plugins v1 形式を使用してホスト型エンドポイントを宣言します。従来のルートの .mcp.json は、一般的な MCP クライアント向けにローカルエンドポイントを引き続き設定します。Claude パッケージは、独自のホスト型 OAuth MCP 設定を使用します。Codex プラグインには、別のリモート MCP 設定があります。

ルートの busabase スキルは、ローカル環境および汎用エージェントへのインストール向けに、CLI と curl の完全なガイドを引き続き提供します。Claude と Codex に同梱されたスキルは、意図的に MCP を優先しています。~/.busabase/.env を読み込む代わりに、OAuth と厳選されたツールカタログを利用します。

まずワークスペースを一から設定するには、Busabase ダッシュボードのオンボーディング用プロンプト（Agent Skills ボタン）を貼り付けてください。このプロンプトに従ってエージェントが接続し、最初の Base を作成してから、上記のインストールコマンドのいずれかを実行します。

スキル

スキル	機能
busabase	HTTP 経由で Busabase ワークスペースを操作します。Bases／レコードの一覧表示、ChangeRequests の提案、承認済みのもののマージができます。
busabase-app-creator	プロダクトのアイデアを、ネイティブリソース、制限付きデータアクセス、レビュー可能な AirApp を備えた完全な Busabase ワークスペースアプリに仕上げます。

インストール可能なテンプレートをお探しですか？ テーブル、AirApp、エージェントが読むマニュアルを含む完成済みアプリは、busabase/templates にあります。 2 つのスキルをインストールする際にすべてのテンプレートのソースとスクリーンショットまでダウンロードされないよう、これらは分離されています。

リポジトリの構成

このリポジトリは、上記すべてのインストール方法に対応しています。

plugin.json                           Agent Plugins v1 portable manifest
mcp.json                              Agent Plugins v1 hosted MCP profile
skills/busabase/SKILL.md              canonical local/general-purpose skill
skills/busabase-app-creator/SKILL.md  guided Busabase workspace and AirApp creator
.claude-plugin/marketplace.json       Claude Code marketplace listing
claude/.claude-plugin/plugin.json     Claude Code plugin manifest
claude/.mcp.json                      hosted OAuth MCP profile for Claude Code
claude/skills/busabase/SKILL.md       Claude-specific MCP-first connection guidance
claude/skills/busabase-app-creator/   symlink to the shared app creator skill
.agents/plugins/marketplace.json      Codex marketplace listing
plugins/busabase/.codex-plugin/plugin.json   Codex plugin manifest
plugins/busabase/.mcp.json                   hosted OAuth MCP profile for Codex
plugins/busabase/skills/busabase/SKILL.md    Codex needs the skill INSIDE the plugin dir
                                             (MCP-first guidance for the curated profile)
plugins/busabase/skills/busabase-app-creator/SKILL.md
                                             app creator bundled beside its Busabase dependency
plugins/busabase/assets/                     icons and light/dark logos bundled with Codex
.mcp.json                             legacy/general-client local MCP profile
server.json                           official MCP Registry entry (remote → busabase.com/api/mcp)
scripts/validate-agent-plugin.mjs     portable and client-package conformance guard

ホスト固有の Busabase スキルがあるのはなぜですか？ プラグインパッケージでは、ローカルのシェル設定ではなく、ホスト型 OAuth と MCP ツールを使用します。Claude Code ではサーバー名が plugin:busabase:busabase としてさらに名前空間化されますが、Codex では busabase が使用されます。共通の busabase-app-creator スキルは、接続、API、ChangeRequest の処理を、ホスト固有の MCP ファーストな依存関係に委譲します。

OpenAI Plugin Directory への公開

OpenAI Plugin Directory と MCP Registry は別々のリリースチャネルです。Platform への提出、ドメインの検証、レビュアーのアクセス、テスト用プロンプト、本番環境のスモークテストについては、docs/openai-plugin-submission.md を参照してください。

公式 MCP Registry への公開

brew install mcp-publisher                       # or grab the binary from the registry releases
mcp-publisher login dns --domain busabase.com --private-key <KEY>   # verifies the com.busabase/* namespace
mcp-publisher publish                            # publishes server.json — live immediately, no review

MCP Registry の更新を公開するときに限り、server.json の version を更新してください。GitHub Marketplace リリース用の Codex プラグインマニフェストは、別途更新してください。