メインコンテンツまでスキップ

MCP クライアント

**Model Context Protocol（MCP）**は、AI モデルにツールを公開するためのオープンスタンダードです。多くのサービスが MCP サーバーを提供しており、独自に作成することもできます。AI MCPクライアントは、MonoChat を 1 つの MCP サーバーに接続します。これにより、そのサーバーが提供するツールを、MonoChat で作成する AIツール関数と並べて、AI ノードや AI エージェントに渡せるようになります。

MCP クライアントは 設定 › オートメーション › AI MCPクライアントで管理します。

仕組み​

  1. MCP サーバーのアドレスを追加して接続します。MonoChat は、サーバーが提供するツール、リソース、リソーステンプレート、プロンプトを読み取ります。
  2. 保存すると、MonoChat はその一覧をクライアントのコンテンツとして保持します。
  3. AI チャット補完を作成ノードまたは AI エージェントノードで、そのノードに持たせたいツールを選びます。各ツールの説明は、モデル向けに書き換えることもできます。
  4. 会話中、モデルがツールをいつ呼び出すかを判断します。MonoChat が MCP サーバーを呼び出し、結果をモデルに返します。

ノードで利用できるのは、そのノードに追加したツールだけです。そのため、各ノードには必要なものだけが見えます。

MCP クライアントを追加する​

  1. 設定 › オートメーション › AI MCPクライアントに移動し、+（作成）をクリックします。

  2. 各フィールドを入力します。

    フィールド説明
    名前サーバーの名前。ノードのドロワーで、各ツールの横に表示されます。
    説明任意のメモ。
    バージョン接続時に MonoChat がサーバーに通知するクライアントのバージョン。例: 1.0.0。
    エンドポイントMCP サーバーのベース URL。MonoChat は <Endpoint>/sse で SSE トランスポートを使って接続するため、/sse を付けずにアドレスを入力してください。
    認証タイプNone、Basic（ユーザー名とパスワードを使用）、または Bearer（トークンを使用）。認証情報はクライアントとともに保存されます。

  3. 接続をクリックします。MonoChat がサーバーに接続し、見つかった内容をタブに表示します。

    • サーバー情報: サーバーの名前、バージョン、プロトコルバージョン、手順。
    • ツール: 各ツールの名前と説明。
    • リソース、リソーステンプレート、プロンプト（サーバーが提供している場合）。

  4. 一覧に問題がなければ、保存をクリックします。アドレスを変更してやり直したい場合は、横にある切断ボタンをクリックします。

ヒント

接続に失敗する場合は、エンドポイントがインターネットから到達できること、サーバーが SSE トランスポートに対応していること、URL がすでに /sse で終わっていないことを確認してください。

ツール一覧を更新する​

MCP サーバーでツールが追加または変更された場合は、更新でクライアントを開きます。MonoChat が再接続して現在の内容を表示します。更新をクリックすると、新しい一覧が保存されます。

クライアントを削除すると、そのコンテンツも削除されるため、ノードはそのクライアント由来のツールを失います。

ノードにツールを渡す​

AI チャット補完を作成ノード​

  1. ノードを開き、AI MCP クライアントコンテンツツールの設定までスクロールします。
  2. AI MCP クライアントコンテンツツールを設定をクリックします。AI MCP クライアントコンテンツツールドロワーに、このノードにすでに追加されているツールが一覧表示されます。
  3. +（作成）をクリックし、AI MCP クライアントコンテンツツールでツールを選択します。ツールは <クライアント名> - <ツール名> の形式で一覧表示されます。
  4. 説明には、ツール自身の説明が入力されています。モデルに、そのツールをいつ使うべきかをより正確に伝えたい場合は、編集してください。たとえば「注文番号で注文を検索するときに使う」のようにします。説明は必須です。
  5. ツールごとに繰り返し、ノードを保存します。

同じドロワーで、ツールの説明を更新したり、ノードからツールを削除したりすることもできます。

AI エージェントノード​

AI エージェントノードのツール設定セクションにも、同じAI MCP クライアントコンテンツツールを設定ボタンがあります。選択した MCP ツールは、どのハーネスでも、ノードの AIスコープや AIツールとともにエージェントに提供されます。AI エージェントをご覧ください。

備考

エージェントの実行では、ノードのすべての MCP ツールがワークスペース内にまだ存在することが確認されます。ノードが使っている MCP クライアントを削除すると、そのノードの実行は、ノードからツールを削除するまで「An AI scope or MCP tool was not found in this workspace.」で失敗します。

権限​

アクセスは、ロールの権限であるオートメーション内の AI MCP クライアントの閲覧 / 作成 / 更新 / 削除と、オートメーション内の AI MCP クライアントコンテンツの閲覧で制御されます。ロールをご覧ください。