メインコンテンツへスキップ
LangBot は MCP サーバー由来のツールを利用できます。MCP サーバーを追加すれば、ツール使用を有効にしたモデルを持つ組み込み Agent が会話中にそのツールを呼び出せます。
まずは LangBot Space からのインストールを推奨します。掲載されている MCP サーバーは設定済みで、そのまま使えます。ModelScope、mcp.so、composio.dev から入手して、後述の手動追加で登録することも可能です。

​
2 つの通信モード

モード適した場面備考
リモート (mode: "remote")リモート MCP サービス。URL を貼り付けるだけLangBot がリモート URL に直接接続し、トランスポート（まず Streamable HTTP を試行し、失敗時は SSE にフォールバック）を自動検出します。手動選択は不要
ローカル / stdio (mode: "stdio")ローカルコマンドで起動する MCP サーバーBox Runtime が利用可能なときのみサポート
以前のバージョンではリモートモードを http（Streamable HTTP）と sse の 2 つに分けていましたが、現在は単一の remote に統合され、トランスポートはバックエンドが自動検出します。データベース内の既存 http / sse レコードはアップグレード時に remote へ正規化され、接続パラメータ（URL、ヘッダー、タイムアウト）はそのまま保持されます。
MCP ツールを使うには、パイプラインで組み込み Agent を選択し、ツール使用が有効化されたモデルを使用する必要があります。モデルを参照。Dify、n8n、Langflow、Coze などの外部 Runner は各プラットフォームのツール機構を使います。

​
MCP サーバーをインストール

​
LangBot Space から（推奨）

LangBot Space は LangBot 公式のマーケットプレイスで、設定済みの MCP サーバーが多数掲載されています。WebUI の プラグイン管理 → MCP 管理 から閲覧して 1 クリックでインストールでき、URL、コマンド、モードなどのパラメータはマーケット側が提供するため、手動入力は不要です。 ほとんどのケースはこれで十分です。掲載されていないサービスを利用する場合は、下記の手動追加を使ってください。

​
手動で追加

プラグイン管理 → MCP 管理 を開きます： MCP 管理ページ 右上の 追加 → MCP サーバーを追加 をクリック。ローカル（stdio）またはリモートモードを選びます。リモートは URL を貼り付けるだけ、ローカルは起動コマンドを入力します。テスト で接続を確認、送信 で保存します： MCP サーバー作成 保存後、カードのスイッチをオンにして接続します。カードをクリックすると詳細を確認できます： MCP サーバー詳細

​
パイプラインで有効化

MCP サーバーを追加したあと、パイプライン拡張設定で Agent から見える MCP を決めます：
  • 「すべての MCP サーバーを有効化」をオン、または
  • 指定した MCP サーバーのみをバインド
バインドしていない MCP のツールはそのパイプラインのツール一覧に入りません。

​
高度な設定：stdio MCP

stdio MCP は Box Runtime によってホストされます。接続前に LangBot は以下を行います：
  1. 共有の MCP Box session を作成または再利用
  2. コマンドからローカルプロジェクトのパスを推測できれば、プロジェクトをワークスペースに staging
  3. プロジェクトに requirements.txt、pyproject.toml、setup.py、setup.cfg がある場合は依存をインストール
  4. WebSocket relay 経由で MCP プロセスの stdin/stdout に接続
マウント、ネットワーク、タイムアウトを細かく調整したい場合、MCP 設定の extra_args に box オーバーライドを追加できます： 
{
  "mode": "stdio",
  "extra_args": {
    "command": "python",
    "args": ["server.py"],
    "env": {},
    "box": {
      "host_path": "/path/to/mcp-project",
      "network": "on",
      "host_path_mode": "ro",
      "startup_timeout_sec": 120,
      "image": "python:3.11-slim"
    }
  }
}
主なフィールド：
フィールド説明
host_pathホスト上の MCP プロジェクトディレクトリ。box.local.allowed_mount_roots の許可範囲内である必要があります
networkネットワークを許可するか（依存インストールでよく使う）
host_path_modehost_path を staging するときのアクセスモード。デフォルトは ro。stdio MCP は通常ワークスペースに staging されます
startup_timeout_secBox 準備と依存インストールのタイムアウト、デフォルト 120 秒。接続待ちで約 30 秒追加されます
imageDocker バックエンドで使用するランタイムイメージ
stdio MCP は Box 内で実行されます。依存インストールとプロセス起動は sandbox profile、ネットワーク権限、リソース制限、マウント許可リストの影響を受けます。

​
よくある問題

症状確認項目
MCP の接続に失敗URL、コマンド、引数、環境変数が正しいか
stdio MCP が接続中のままBox Runtime の状態、startup_timeout_sec が短すぎないか
依存インストールに失敗sandbox がネットワークを許可しているか、依存ファイルが正しいか
ローカルファイルにアクセスできないhost_path が存在し、allowed_mount_roots 内にあるか
Agent が MCP ツールを認識しないパイプラインで組み込み Agent を使っているか、モデルでツール使用を有効にしているか、MCP がパイプラインにバインドされているか