# MCP連携ノード

### MCPとは？

MCPとは、AIアプリケーションを外部システムと接続するためのオープンソース標準規格です。

MCPを使用することで、Alli、ChatGPT、ClaudeなどのAIアプリケーションは、以下のリソースと安全に連携できるようになります。

* データソース（ローカルファイル、データベースなど）
* ツール（検索エンジン、計算機など）
* ワークフロー（特化されたプロンプトベースの処理）

これにより、AIは単なる会話だけでなく、必要な情報を自ら検索し、実務的な作業を実行することが可能になります。&#x20;

### Alliでは、MCPをどのように活用できるか？

Alliでは、LLMを使用したワークフローを作成する際にMCPを利用することができます。

アプリ内でLLMと「Alli MCP Hub」に登録されているサーバーツールを接続することで、ユーザーの要求に応じてLLMが適切なMCPツールを自ら選択・活用するワークフローを作成できます。

このプロセスの詳細については、[エージェント型アプリのユーザーガイド](https://docs.allganize.ai/alli_for_llm/agent-builder/about-agent-builder)を参照してください。

### MCPノードとは？ <a href="#url-and-headers" id="url-and-headers"></a>

MCPノードを利用することで、LLMを介さずにMCPツールをAPIのように直接活用し、より豊富な自動化ワークフローを構成できるようになりました。事前に連携しているMCPツールを直接呼び出すことで、さらに洗練された自動化ロジックとワークフローが構築可能です。

### 使用方法

1. カンバセーションアプリ作成画面に入り、MCP連携ノードを選択します。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FWSOvb96SLB3u6b9zH0cM%2Fimage.png?alt=media&#x26;token=d3b391a2-8bde-4364-9b69-24613db5c38b" alt=""><figcaption></figcaption></figure>
2. ノードエディタで「MCPサーバーの追加」ボタンを押して、ツール選択画面を開きます。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FPZwHeKejl9R6rIWi2f8X%2Fimage.png?alt=media&#x26;token=2454badc-f4b2-4636-814f-f14661d63d3f" alt="" width="370"><figcaption></figcaption></figure>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FFyUaLfxAxyuS7eJSSO6S%2Fimage.png?alt=media&#x26;token=ce8c21d2-15c5-4a74-be1a-40264c311aa3" alt=""><figcaption></figcaption></figure>
3. 1でサーバーを選択し、2で使用するツールを選択します。3では、MCPツールの説明と必要なパラメータを確認できます。<br>
4. 利用するのツールを選択し、「追加」ボタンを押してノードエディタに戻ります。エージェントビルダーアプリとは異なり、このノードでは指定されたAPIを1回だけ呼び出すため、1つのツールのみ選択できます。<br>
5. ツールを選択した後にノードエディタに戻ると、下記のように大きく3つの領域を確認できます。<br>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FHMlxSZ8lliPz4RVpGnnl%2Fimage.png?alt=media&#x26;token=0cdef00f-e542-43da-be32-8cc9faac1148" alt=""><figcaption></figcaption></figure>

   1. 1はMCPサーバー設定項目です。クリップアイコンを押すと、認証に必要な情報（API Key、OAuth認証など）を入力してサーバーと連動するなど、サーバーから要求するフィールドを入力できます。
   2. 2はMCPツール設定項目です。ここでは、ツールを変更したり、ツールを呼び出すときに必要なパラメータの入力ができます。フィールドの左側にあるドロップダウンアイコン（@、Tt）を変更して変数/一般テキストを入力することができます。
   3. 3は受け取った結果を変数に割り当てる項目です。受け取る変数>「変数の追加」ボタンをクリックすると、呼び出した結果の値をどの変数に代入するかを設定できます。 MCPの仕様上、すべてのresponseがJSON形式で送信されるため、対応するJSONから必要な値を抽出して変数に入れる必要があります。詳細なガイドはJSONパス入力項目の"？"アイコンから表示することができます。\
      \
      ※MCPの呼び出しが失敗した場合、エラーメッセージは、@MCP\_ERROR\_MESSAGE変数（文字列）に格納されます。エラーの原因を確認する際にご利用いただけます。

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2F8nZ1M7I8Qh7PuEkxvGNi%2Fimage.png?alt=media&#x26;token=74752b9f-8143-468c-89a5-f08af747e104" alt="" width="375"><figcaption><p>"？"アイコンのガイド（基本）</p></figcaption></figure>

   <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FYWBO4wsXp3MnGjW5qGC3%2Fimage.png?alt=media&#x26;token=7d9b67c1-f4f6-4202-a45d-03724da50969" alt="" width="375"><figcaption><p>"？"アイコンのガイド（例）</p></figcaption></figure>
6. 「適用」ボタンを押し、設定を完了します。

### 簡単なサンプルアプリの作成

入力されたタイムゾーンの現在時刻を呼び出すMCPを連携し、成功と失敗時に結果を出力します。実行結果は以下の通りです。

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FSQYVOF1HIwWaYPN1lvm0%2Fimage.png?alt=media&#x26;token=771f7f83-3f5e-4ce1-a1aa-d1f1d649b26e" alt=""><figcaption></figcaption></figure>

フローは以下の通りです。

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FWP22ONAG9SrrBoiipyDN%2Fimage.png?alt=media&#x26;token=b46fe04e-eeb0-423d-a286-fc11782b2c48" alt=""><figcaption></figcaption></figure>

ノードの詳細設定は以下の通りです。

* 会話応答ノード（地域選択）<br>

  <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FC007p76LuHpyOq4B5W7G%2Fimage.png?alt=media&#x26;token=da8b0e3b-2a48-4fb3-9968-5d0fe740b7ba" alt="" width="375"><figcaption></figcaption></figure>

* MCP連携ノード<br>

  <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2FYVp3vfCN5kfaxZzFliKe%2Fimage.png?alt=media&#x26;token=5e95e5cb-0e20-457b-ba9b-c297c5bdda30" alt="" width="563"><figcaption></figcaption></figure>

* 会話応答ノード（MCP連携成功時）<br>

  <figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2Fi4foOVorRZXjqplvtUrS%2Fimage.png?alt=media&#x26;token=a48d30eb-e3db-4863-b319-8fcc73b4217e" alt="" width="563"><figcaption></figcaption></figure>

* 会話応答ノード（MCP連携失敗時）

<figure><img src="https://3244404108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR2CRA2CisD1pVQUgqd1g%2Fuploads%2F07UJuoj7thqyDPJsCAjD%2Fimage.png?alt=media&#x26;token=29e13556-a57d-464b-a0ac-8d0f62655cff" alt="" width="563"><figcaption></figcaption></figure>
