MCP サーバー

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 サーバーを追加 をクリック。ローカル（stdio）またはリモートモードを選びます。リモートは URL を貼り付けるだけ、ローカルは起動コマンドを入力します。テスト で接続を確認、送信 で保存します：

保存後、カードのスイッチをオンにして接続します。カードをクリックすると詳細を確認できます：

パイプラインで有効化

MCP サーバーを追加したあと、パイプライン拡張設定で Agent から見える MCP を決めます：

「すべての MCP サーバーを有効化」をオン、または
指定した MCP サーバーのみをバインド

バインドしていない MCP のツールはそのパイプラインのツール一覧に入りません。

高度な設定：stdio MCP

stdio MCP は Box Runtime によってホストされます。接続前に LangBot は以下を行います：

共有の MCP Box session を作成または再利用
コマンドからローカルプロジェクトのパスを推測できれば、プロジェクトをワークスペースに staging
プロジェクトに requirements.txt、pyproject.toml、setup.py、setup.cfg がある場合は依存をインストール
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_mode`	`host_path` を staging するときのアクセスモード。デフォルトは `ro`。stdio MCP は通常ワークスペースに staging されます
`startup_timeout_sec`	Box 準備と依存インストールのタイムアウト、デフォルト 120 秒。接続待ちで約 30 秒追加されます
`image`	Docker バックエンドで使用するランタイムイメージ

stdio MCP は Box 内で実行されます。依存インストールとプロセス起動は sandbox profile、ネットワーク権限、リソース制限、マウント許可リストの影響を受けます。

よくある問題

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

クイックスタート

インストール

ボットを設定

AI 設定

運用ガイド

プラグインの利用

MCP サーバー

2 つの通信モード

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

LangBot Space から（推奨）

手動で追加

パイプラインで有効化

高度な設定：stdio MCP

よくある問題

​2 つの通信モード

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

​LangBot Space から（推奨）

​手動で追加

​パイプラインで有効化

​高度な設定：stdio MCP

​よくある問題

2 つの通信モード

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

LangBot Space から（推奨）

手動で追加

パイプラインで有効化

高度な設定：stdio MCP

よくある問題