MCPサーバー

BoardUIはMCPサーバーを提供しているので、AIエージェントにインストールを任せられます。Claude Code、Cursor、VS Code、CodexなどのMCPクライアントから、レジストリの参照、コンポーネントのソースと使用例の確認、新規プロジェクトのセットアップ、ファイルの直接書き込みができます。作りたいものを伝えるだけで、ターミナルとの行き来は不要です。

サーバはstdioを経由してローカルで実行します npxで動作し、外部でのホストは不要です。無料コンポーネントは設定なしで利用でき、エージェントがライセンスキーを有効化すると、同じチャット内でBoardUI Proを利用できます。

以下のすべてのクライアントに共通する点として、MCPツールはセッション開始時に登録されます。セッションの途中でサーバーを追加した場合は、クライアントを再起動するか、新しいチャットを開いてください。そうしないと、接続済みでもツールが使えない状態になります。

セットアップ

お使いのクライアントを選んでください。CursorとVS Codeはワンクリック、Claude CodeとCodexはコマンド1つで導入できます。

プロジェクトディレクトリに 1 つのコマンドを追加します。 --scope user すべてのプロジェクトを有効にし、Claudeコード(または新しいセッションを開く)を再起動すると、ツールがバインドされます。

claude mcp add boardui -- npx -y boardui@latest mcp

Monorepos とカスタムエイリアス

ローカルMCPサーバーは同じオプションを読みます boardui.json CLI として。 宛先パッケージの横にそれを置きます package.json パッケージの絶対パスをそのまま渡して下さい projectDir とりあえず init_boardui, install_components, と install_rules.ファイルとnpm依存関係は、設定されたインポートエイリアスで、そのパッケージにインストールします。

同じパスを渡して下さい projectDir とりあえず get_component そして、 get_usage_examples マッチングソースと例. それなしで, これらの読み取りツールは、元のレジストリのインポートを返します. パッケージのエクスポートと各アプリのスタイルはまだセットアップが必要です.

共有 UI パッケージの設定

あなたのエージェントを尋ねる

接続したら、エージェントをプレーン言語で話します。 いくつかのスターター:

  • “このプロジェクトにBoardUIを導入して、ボタン、セレクト、日付ピッカーを追加してください。”
  • “BoardUI Proを購入しました。ライセンスキーはXXXXです。有効化してAIチャットのテンプレートをインストールしてください。”
  • “BoardUIの認証カードとソーシャルボタンでサインイン画面を作ってください。”
  • “このBoardUIプロジェクトで、Proブロックとテンプレートを含め、アラビア語とヘブライ語のRTLを有効にしてください。”
  • “BoardUIのボタンにはどのようなプロパティがありますか?アイコン付きのバリエーションも見せてください。”
  • “BoardUIのデータテーブルを追加し、/api/ordersのエンドポイントに接続してください。”
  • “BoardUIのテーマトークンを見せて、プライマリボタンをブランドに合うスタイルに変更してください。”
  • “BoardUIの統計カード、エリアチャート、棒リストで売上ダッシュボードを作ってください。”

ツール

サーバがあなたのエージェントに露出するもの:

ツールそれが何をするのか
get_startedOverview of BoardUI, the typical flow, RTL setup, and the Pro licensing rules.
list_componentsEvery installable item with exact names, free and Pro, grouped by type.
get_componentDescription, dependencies, usage example, and full source for one item.
get_usage_examplesWorking code snippets from the item's docs page, Pro items included.
install_componentsWrites component source into the project and installs missing npm deps.
init_boarduiOne-time setup: Tailwind v4, runtime deps, theme and global styles, utils.
install_rulesWrites the always-on design rules into AGENTS.md and .cursor/rules/.
get_skillExplains the agent skill: live SKILL.md, bundled files, install options per client.
install_skillInstalls the BoardUI agent skill (catalog, theming, patterns) into .claude/skills/.
get_themeThe theme tokens, type scale, global stylesheet, and RTL setup guidance.
activate_licenseActivates a BoardUI Pro license key on the machine and stores it.
license_statusWhether a Pro license is active, with the key shown masked.
deactivate_licenseReleases the machine's Pro seat and removes the stored key.

常にデザインルール

MCP ツールがオンデマンド: エージェントは、それが尋ねるとき、あなたのテーマだけを見て、独自の間隔、色、およびタイプを発明しないようにするモデル。だから init_boardui (と) npx boardui init) また、エージェントがすべてのセッションをロードする常にオンの指示ファイルとして設計基盤をインストールします。フェンスされたセクション AGENTS.md Cursorのルール .cursor/rules/boardui.mdc. それらは皮色トークン、合成のタイプ スケール、間隔および半径の大会、暗モードをピンで止め、 cx()ファイルの残りの部分に触れることなく、セクションをリフレッシュして再実行します。

この前にプロジェクトを初期化しましたか? エージェントが実行されるように依頼する install_rules.

フルカタログ、テーマ、ページパターンで、常に知識をロードしたいですか? インストール BoardUIの代理店のスキル MCP と一緒に (MCP と一緒に)install_skill, または npx boardui skill).

MCP を上回るBoardUI Pro

プロのコンポーネントとテンプレートが表示される list_components すべてのユーザーのために。 ライセンスがなければ、エージェントは、ソースの代わりに、説明、パブリック使用例、および購入指示を取得します。 あなたがProを購入すると、購入メールからライセンスキーをチャットに貼り付けます。 エージェントは、エージェントはそれをアクティブにします activate_license (片席、随時発売) deactivate_license), そして、Proの項目から直接無料のもののようにインストールします. キーは、すべてのProのダウンロードでサーバー側検証されます.

すでにログインしている boardui login? MCP サーバーは、同じ保存されたライセンスを使用して、何もやり直しません。

匿名テレメトリー

インストールが成功すると、CLIと同じ匿名のイベント(コンポーネント名、パッケージマネージャー、バージョン)をMCP経由として報告します。プロジェクトのパス、プロンプト、ソースコードは含みません。無効にする設定は BOARDUI_TELEMETRY_DISABLED=1 または DO_NOT_TRACK=1 サーバの環境で。

shadcn の MCP を代わりに使用

BoardUIのレジストリはshadcnのスキーマに対応しています。すでにshadcn MCPサーバーを使っているエージェントからもBoardUIにアクセスできます。次の設定に名前空間を追加してください: components.json お問い合わせ @boardui/button。上記のBoardUIサーバーなら、使用例、プロジェクトのセットアップ、Proライセンスの機能も利用できます。

{ "registries": { "@boardui": "https://www.boardui.com/r/{name}.json" }}

内部の仕組み

npx boardui@latest mcp はCLIと同じエンジンを起動し、stdioでMCP通信を行います。boardui.comから公開レジストリを取得し、コンポーネント間の依存関係を再帰的に解決して、標準の構成または指定した設定に従ってファイルを書き込みます: boardui.json マッピング。 セットアップをチェックするために手動で実行することもできます。

npx boardui@latest mcp