branderux

BranderUX MCP

BranderUX は、エージェント型アプリケーションを数分で構築します。ビジネスについて説明すると、実際のエージェントがアプリケーション全体を構築し、ウェブサイトと MCP アプリとして公開します。すべての画面は、顧客や質問ごとにその場で生成されます。このサーバーを使うと、あらゆる MCP クライアント（Claude、ChatGPT、Cursor、VS Code）から、こうしたアプリケーションを構築・制御できます。

これは BranderUX 公式の MCP サーバーです。AI エージェントが BranderUX のプロジェクト、ブランド、カスタム要素、画面、API キーを実際に制御できるようにします。また、SDK を正しく統合するために必要な、検証済みのリファレンスドキュメントも提供します。

接続先： https://mcp.branderux.com/mcp · ドキュメント： https://branderux.com/mcp

claude mcp add --transport http branderux https://mcp.branderux.com/mcp

API キーは不要です。最初のツール呼び出しでブラウザーが開き、ワンクリックで BranderUX にサインインできます（OAuth 2.1 + PKCE、スコープ設定可能で取り消し可能）。BranderUX アカウントをお持ちの方なら、どなたでも接続できます。構築例は、nova.branderux.app と branderux.com にある5つの公開中の例をご覧ください。

ツール

ナレッジ（スコープは不要ですが、サーバーに接続するにはサインインが必要です）： get_started · read_doc · search_docs · get_integration_snippet · list_templates · get_template。get_integration_snippet の widget スニペットは、通常のウェブサイト（Wix、WordPress、Shopify、静的 HTML）用の1行の script タグです。data-preload="eager" と data-conversions="on" が設定されており（新規リード、予約、注文、問い合わせを、サイトにすでに設置されているタグに通知します）。list_templates と get_template は、参考用の5つの構築例を、コピーするのではなく応用するための実例として読み込みます。

プロジェクト（projects:*）。サインイン中のユーザーが所有または管理するプロジェクトが対象です：whoami · list_projects · get_project · create_project · update_brand_settings · update_project_settings · delete_project

画面（projects:write）：list_screens · get_screen · put_screen · delete_screen。読み取りではプロジェクトの集約データを取得します。書き込みは画面ごとにアトミックに実行されます （サーバー側で行ロックを使ってマージするため、異なる画面の並行保存は安全です）。

カスタム要素（elements:*）：list_elements · get_element · list_element_versions · create_element · publish_element_version · preview_element · delete_element。TSX はエージェントが作成し、サーバーが公開前に事前検証します（コンパイル、サンドボックスのインポート許可リスト、エクスポート契約）。MCP Apps に対応するクライアントでは、create_element、 publish_element_version、preview_element によって、要素がパネルにリアルタイムで表示されます。デモ用のプロパティが適用され、クリックすると送信されるクエリが正確に表示されます。

API キー（keys:manage）：create_api_key · list_api_keys · set_key_origins · revoke_api_key

ホスト型エージェント：upsert_agent_config · get_agent_config。プロジェクト専用のエージェントを設定できます。ペルソナ、ポリシー（言語と時刻、ログイン、アクセス、引き継ぎ、書き込みへの同意）、回答品質、予算を設定します。

ビジネスデータ：define_entity · list_entities · seed_records · update_record · list_entity_records。管理対象のレコード、またはライブストア／API フィードを利用できます。エンティティはすべてエージェント用のクエリツールになり、デフォルトでは追加のみの書き込みが可能です。 オーナーデータ（読み取りには projects:read、変更には projects:write）：query_records · aggregate_records · get_record · list_conversations · aggregate_conversations · get_conversation · list_visitors · get_stats · update_record_workflow · correct_record · add_record · record_opt_out · delete_record · reply_links · get_crm_status · send_record_to_crm。オーナー自身の AI は、ホストされたエージェントが収集した見込み客、予約、注文、リクエストと、その会話、サインイン済みの訪問者、各種数値を読み取り、レコードを1件ずつ処理します。変更内容はすべてレコードに記録され（削除すると、ログとともにレコードが消去されます）、訪問者のテキストはデータとしてマークされて返されます。顧客に何かが送信されることはありません（reply_links は下書きを用意し、オーナーが送信します）。顧客データの送信先は、アプリ内でオーナーまたはマネージャーが選択します。review-my-week プロンプトは、これらのツールを使ってオーナーの1週間または1か月を振り返ります。ドキュメント：read_doc owner-data。

コネクター：set_connector_credential · probe_api。保管庫に保存された認証情報とプローブを使って、実際の API の形式に合わせてツールを接続します。

スキル：upsert_skill · list_skills · delete_skill。すべての会話に適用される SKILL.md の動作パックです。

ホーム画面と固定画面：set_home_screen · set_fixed_screens · list_fixed_screens · verify_canned_screens。デザインされた初期表示と、ビジネスで繰り返し寄せられる質問へのデザイン済み回答を、訪問ごとのモデルコストゼロで、ライブデータバインディングを使って再生します。 verify_canned_screens は、配信時と同じ方法ですべてのバインディングを実行するため、publish_site の前に画面が再生できることを検証できます。

公開：publish_site · get_site。1回の呼び出しでアプリケーション全体を公開できます。人向けのウェブサイトと、AI エージェント向けの MCP アプリが利用可能になります。

プレイグラウンド（プロジェクトは不要）：generate_screen。顧客がインストールする公開済みの @brander/mcp-tools パッケージと同じものを使って、デモデータを含む、実際のブランドに合わせたインタラクティブな画面をパネル内に表示します。ストアフロント、分析、注文フローの画面をリクエストして、何かを構築する前に BranderUX の実際の出力を確認できます。

破壊的操作を行うすべてのツールでは、明示的な confirm: true が必要です。

ローカル開発

npm install
BRANDER_API_BASE=http://localhost:8080/api/v1 npm run dev   # http://localhost:3010/mcp

環境変数	デフォルト	用途
BRANDER_API_BASE	http://localhost:8080/api/v1	BranderUX API のベース URL
BRANDER_APP_BASE	BRANDER_API_BASE に基づく：api-dev の場合は https://dev.branderux.com、api の場合は https://branderux.com、それ以外は http://localhost:3000	BranderUX のウェブアプリ。プレイグラウンドへのリンク、定型画面の検証、ライブカタログに対する query_records に使用します
MCP_RESOURCE_URL	http://localhost:3010	このサーバーの公開 URL（OAuth リソース ID）
OAUTH_ISSUER_URL	BRANDER_API_BASE と同じ	認可サーバーの発行者

サーバーはステートレスです。リクエストごとに1つの MCP サーバーインスタンスが作成され、呼び出し元のベアラートークンに紐づきます。デプロイ先は Vercel です（api/mcp.ts + api/oauth-protected-resource.ts）。

ライセンス

MIT