メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt

Use this file to discover all available pages before exploring further.

Model Context Protocol (MCP) を使用すると、外部ツールサーバーをAIエージェントに接続できます。MCPツールは組み込みツールを超えてエージェントの機能を拡張します。

組み込みMCPサーバー

bricks-ctor には、bun install 時に自動設定される組み込みの bricks-ctor MCPサーバーが含まれています。コンパイル、プレビュー、アイコンとLottieアニメーションの検索、Hugging Faceモデルの選択、メディアアセットの管理のためのツールを提供します。

bricks-ctor 組み込みMCPサーバー

bricks-ctorドキュメントの完全なツールリファレンスを参照してください。

設定

MCPサーバーはプロジェクトルートの .mcp.json ファイルで設定します:
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "some-mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

トランスポートタイプ

stdio

MCPサーバーを子プロセスとして生成し、標準入出力で通信します。
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "some-mcp-server"],
      "env": {}
    }
  }
}
フィールド説明
command実行するコマンド
argsコマンド引数の配列
envプロセスの環境変数

HTTP

HTTPを介してリモートMCPサーバーに接続します。
{
  "mcpServers": {
    "remote-server": {
      "url": "https://mcp.example.com/sse"
    }
  }
}
フィールド説明
urlサーバーエンドポイントURL

MCPサーバーの管理

サイドバーの MCP をクリックしてMCPパネルを開きます。パネルには以下が表示されます:
  • 設定済みサーバーのリストと接続状態
  • 緑のドット — 接続済み、利用可能なツール数が表示されます
  • 赤のドット — 切断またはエラー
  • 各サーバーの展開可能なツールリスト

設定の編集

MCPパネルには .mcp.json を直接編集できる設定エディターが含まれています。保存をクリックして変更を適用し、再接続でサーバー接続を再確立します。

ツールの統合

接続後、MCPツールは組み込みツールとともに表示されます。エージェントは他のツールと同様にそれらを検出して呼び出せます。ツール呼び出しの結果はテキストと画像コンテンツの両方をサポートします。 MCPサーバーの接続はプロジェクトごとにキャッシュされ、アプリが終了すると自動的にクリーンアップされます。