ja usage mcp readme
LangBot は MCP サーバー由来のツールを利用できます。MCP サーバーを追加すれば、ツール使用を有効にしたモデルを持つ組み込み Agent が会話中にそのツールを呼び出せます。
Note
MCP はローカル（stdio）とリモートの 2 モードに対応しています。 まずは LangBot Space からのインストールを推奨します。掲載されている MCP サーバーは設定済みで、そのまま使えます。
ModelScope、mcp.so、composio.dev から入手して、後述の手動追加で登録することも可能です。
| モード | 適した場面 | 備考 |
|---|---|---|
リモート (mode: "remote") |
リモート MCP サービス。URL を貼り付けるだけ | LangBot がリモート URL に直接接続し、トランスポート（まず Streamable HTTP を試行し、失敗時は SSE にフォールバック）を自動検出します。手動選択は不要 |
ローカル / stdio (mode: "stdio") |
ローカルコマンドで起動する MCP サーバー | Box Runtime が利用可能なときのみサポート |
Note
以前のバージョンではリモートモードを http（Streamable HTTP）と sse の 2 つに分けていましたが、現在は単一の remote に統合され、トランスポートはバックエンドが自動検出します。データベース内の既存 http / sse レコードはアップグレード時に remote へ正規化され、接続パラメータ（URL、ヘッダー、タイムアウト）はそのまま保持されます。
Note
MCP ツールを使うには、パイプラインで組み込み Agent を選択し、ツール使用が有効化されたモデルを使用する必要があります。モデルを参照。Dify、n8n、Langflow、Coze などの外部 Runner は各プラットフォームのツール機構を使います。
LangBot Space は LangBot 公式のマーケットプレイスで、設定済みの MCP サーバーが多数掲載されています。WebUI の プラグイン管理 → MCP 管理 から閲覧して 1 クリックでインストールでき、URL、コマンド、モードなどのパラメータはマーケット側が提供するため、手動入力は不要です。
ほとんどのケースはこれで十分です。掲載されていないサービスを利用する場合は、下記の手動追加を使ってください。
プラグイン管理 → MCP 管理 を開きます：
右上の 追加 → MCP サーバーを追加 をクリック。ローカル（stdio）またはリモートモードを選びます。リモートは URL を貼り付けるだけ、ローカルは起動コマンドを入力します。テスト で接続を確認、送信 で保存します：
保存後、カードのスイッチをオンにして接続します。カードをクリックすると詳細を確認できます：
MCP サーバーを追加したあと、パイプライン拡張設定で Agent から見える MCP を決めます：
- 「すべての MCP サーバーを有効化」をオン、または
- 指定した MCP サーバーのみをバインド
バインドしていない 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 バックエンドで使用するランタイムイメージ |
Warning
stdio MCP は Box 内で実行されます。依存インストールとプロセス起動は sandbox profile、ネットワーク権限、リソース制限、マウント許可リストの影響を受けます。
| 症状 | 確認項目 |
|---|---|
| MCP の接続に失敗 | URL、コマンド、引数、環境変数が正しいか |
| stdio MCP が接続中のまま | Box Runtime の状態、startup_timeout_sec が短すぎないか |
| 依存インストールに失敗 | sandbox がネットワークを許可しているか、依存ファイルが正しいか |
| ローカルファイルにアクセスできない |
host_path が存在し、allowed_mount_roots 内にあるか |
| Agent が MCP ツールを認識しない | パイプラインで組み込み Agent を使っているか、モデルでツール使用を有効にしているか、MCP がパイプラインにバインドされているか |