# MCP連携ノード

### MCPとは？

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

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

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

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

### 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="/files/EqkZa5BZ5g06gxXObpNd" alt=""><figcaption></figcaption></figure>
2. ノードエディタで「MCPサーバーの追加」ボタンを押して、ツール選択画面を開きます。<br>

   <figure><img src="/files/X7wxhQwVvl6yZltoJa4d" alt="" width="370"><figcaption></figcaption></figure>

   <figure><img src="/files/2S2ScHNc8IMUbby9QB4P" alt=""><figcaption></figcaption></figure>
3. 1でサーバーを選択し、2で使用するツールを選択します。3では、MCPツールの説明と必要なパラメータを確認できます。<br>
4. 利用するのツールを選択し、「追加」ボタンを押してノードエディタに戻ります。エージェントビルダーアプリとは異なり、このノードでは指定されたAPIを1回だけ呼び出すため、1つのツールのみ選択できます。<br>
5. ツールを選択した後にノードエディタに戻ると、下記のように大きく3つの領域を確認できます。<br>

   <figure><img src="/files/29vt7zlxcxwUFTphJB9V" 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="/files/BSaamBUPFZcRNJEnixQe" alt="" width="375"><figcaption><p>"？"アイコンのガイド（基本）</p></figcaption></figure>

   <figure><img src="/files/4NpYofvTR02MCcoaiLtV" alt="" width="375"><figcaption><p>"？"アイコンのガイド（例）</p></figcaption></figure>
6. 「適用」ボタンを押し、設定を完了します。

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

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

<figure><img src="/files/Y12DdQnUigcE59XB498t" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/93AKFJb0D7siKeA93ugL" alt=""><figcaption></figcaption></figure>

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

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

  <figure><img src="/files/77AjpjBlwkqudoXvvMke" alt="" width="375"><figcaption></figcaption></figure>

* MCP連携ノード<br>

  <figure><img src="/files/m6vazoUT5RlkWUi2EChM" alt="" width="563"><figcaption></figcaption></figure>

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

  <figure><img src="/files/58R0Kq5jx9u9APsbb54H" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/jIlxg6FH61ie4ZobwZXK" alt="" width="563"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.allganize.ai/alli-llm-app-market/app-management/node/integrate-node-advanced-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.