> ## 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.

# MCP サーバー

> Model Context Protocol を介して外部ツールサーバーに接続する

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

## 組み込みMCPサーバー

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

<Card title="bricks-ctor 組み込みMCPサーバー" icon="cube" href="/ja/ctor-pkg/mcp-server">
  bricks-ctorドキュメントの完全なツールリファレンスを参照してください。
</Card>

<Info>
  `bricks-ctor` サーバーが CTOR 内で動作するときは、その `preview` ツールが無効化され、代わりに組み込みの[プレビューペイン](/ja/ctor/reference/preview)が使われます — スクリーンショットはペインの表示と一致し、同じシミュレータが可視プレビューとエージェントのキャプチャの両方を担います。他のエージェント（Claude Code、Codex、CLI）はこれまでどおり MCP の `preview` ツールを使用します。
</Info>

## 設定

MCPサーバーはプロジェクトルートの `.mcp.json` ファイルで設定します：

```json theme={null}
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "some-mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}
```

## トランスポートタイプ

### stdio

MCPサーバーを子プロセスとして生成し、標準入出力で通信します。

```json theme={null}
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "some-mcp-server"],
      "env": {}
    }
  }
}
```

| フィールド     | 説明        |
| --------- | --------- |
| `command` | 実行するコマンド  |
| `args`    | コマンド引数の配列 |
| `env`     | プロセスの環境変数 |

### HTTP

HTTPを介してリモートMCPサーバーに接続します。

```json theme={null}
{
  "mcpServers": {
    "remote-server": {
      "url": "https://mcp.example.com/sse"
    }
  }
}
```

| フィールド | 説明             |
| ----- | -------------- |
| `url` | サーバーエンドポイントURL |

## MCPサーバーの管理

サイドバーの **MCP** をクリックしてMCPパネルを開きます。パネルには以下が表示されます：

* 設定済みサーバーのリストと接続状態
* **緑のドット** — 接続済み、利用可能なツール数が表示されます
* **赤のドット** — 切断またはエラー
* 各サーバーの展開可能なツールリスト

### 設定の編集

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

## ツールの統合

接続後、MCPツールは組み込みツールとともに表示されます。エージェントは他のツールと同様にそれらを検出して呼び出せます。ツール呼び出しの結果はテキストと画像コンテンツの両方をサポートします。

MCPサーバーの接続はプロジェクトごとにキャッシュされ、アプリが終了すると自動的にクリーンアップされます。