# mulesoft Mcp Connector - Full Documentation # Anypoint Code Builder を使用した MCP Connector 0.1.0-BETA の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#新しいインテグレーションプロジェクトを作成する)新しいインテグレーションプロジェクトを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#インテグレーションプロジェクトにコネクタを追加する)インテグレーションプロジェクトにコネクタを追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#フローのソースを設定する)フローのソースを設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#プロジェクトにコンポーネントを追加する)プロジェクトにコンポーネントを追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#コンポーネント属性を設定する)コンポーネント属性を設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#新しい設定-xml-ファイルを作成する)新しい設定 XML ファイルを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#debug)アプリケーションをデバッグする Anypoint Code Builder の埋め込みデバッガーを使用して Mule アプリケーションをデバッグします。 アプリケーションをデバッグする前に、​`-Dmule.http.service.implementation=NETTY`​ プロパティをデバッグ設定に追加します。 [Mule アプリケーションのデバッグ](https://docs.mulesoft.com/jp/anypoint-code-builder/int-debug-mule-apps)を参照してください。 ## [](#deploy)アプリケーションをデプロイする Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] \* [デプロイメントオプション](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies) # Anypoint Code Builder を使用した MCP Connector 1.0 の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#新しいインテグレーションプロジェクトを作成する)新しいインテグレーションプロジェクトを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#インテグレーションプロジェクトにコネクタを追加する)インテグレーションプロジェクトにコネクタを追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#フローのソースを設定する)フローのソースを設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#プロジェクトにコンポーネントを追加する)プロジェクトにコンポーネントを追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#コンポーネント属性を設定する)コンポーネント属性を設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#新しい設定-xml-ファイルを作成する)新しい設定 XML ファイルを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#debug)アプリケーションをデバッグする Anypoint Code Builder の埋め込みデバッガーを使用して Mule アプリケーションをデバッグします。 [Mule アプリケーションのデバッグ](https://docs.mulesoft.com/jp/anypoint-code-builder/int-debug-mule-apps)を参照してください。 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] # Anypoint Code Builder を使用した MCP Connector 1.1 の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#新しいインテグレーションプロジェクトを作成する)新しいインテグレーションプロジェクトを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#インテグレーションプロジェクトにコネクタを追加する)インテグレーションプロジェクトにコネクタを追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#フローのソースを設定する)フローのソースを設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#プロジェクトにコンポーネントを追加する)プロジェクトにコンポーネントを追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#コンポーネント属性を設定する)コンポーネント属性を設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#新しい設定-xml-ファイルを作成する)新しい設定 XML ファイルを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#debug)アプリケーションをデバッグする Anypoint Code Builder の埋め込みデバッガーを使用して Mule アプリケーションをデバッグします。 [Mule アプリケーションのデバッグ](https://docs.mulesoft.com/jp/anypoint-code-builder/int-debug-mule-apps)を参照してください。 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] # Anypoint Code Builder を使用した MCP Connector 1.2 の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#新しいインテグレーションプロジェクトを作成する)新しいインテグレーションプロジェクトを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#インテグレーションプロジェクトにコネクタを追加する)インテグレーションプロジェクトにコネクタを追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#フローのソースを設定する)フローのソースを設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#プロジェクトにコンポーネントを追加する)プロジェクトにコンポーネントを追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#コンポーネント属性を設定する)コンポーネント属性を設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#新しい設定-xml-ファイルを作成する)新しい設定 XML ファイルを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] ## [](#debug)アプリケーションをデバッグする Anypoint Code Builder の埋め込みデバッガーを使用して Mule アプリケーションをデバッグします。 [Mule アプリケーションのデバッグ](https://docs.mulesoft.com/jp/anypoint-code-builder/int-debug-mule-apps)を参照してください。 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc\[\] # Anypoint Studio を使用した MCP Connector 0.1.0-BETA の設定 Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。 Studio でコネクタを追加および設定する手順は、次のとおりです。 1. [Mule プロジェクトを作成します](#create-mule-project)​。 2. [コネクタを Mule プロジェクトに追加します](#add-connector-to-project)​。 3. [コネクタのフローのソースを設定します](#configure-source)​。 4. [フローにコネクタの操作を追加します](#add-connector-operation)​。 5. [コネクタのグローバル要素を設定します](#configure-global-element)​。 6. [その他のコネクタ項目を設定します](#configure-other-fields)​。 7. [アプリケーションをデバッグします](#debug)​。 8. [アプリケーションログを表示します](#view-app-log)​。 9. [アプリケーションをデプロイします](#deploy)​。 Studio で初めてコネクタを設定する場合は、​[「Anypoint Studio を使用したコネクタの設定」](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio)​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​[「MCP Connector リファレンス」](https://docs.mulesoft.com/jp/mcp-connector/0.1/mcp-connector-reference)​を参照してください。 ## [](#始める前に)始める前に `-Dmule.http.service.implementation=NETTY`​ プロパティを ​`AnypointStudio.ini`​ ファイルに追加します。 Mac OS: 1. `/Applications`​ フォルダーに移動して、​**AnypointStudio**​ パッケージを右クリックして、​**\[Show Package Contents (パッケージコンテンツを表示)\]**​ を選択します。 2. **\[Contents (コンテンツ)\] > \[Eclipse\]**​ に移動して、​`AnypointStudio.ini`​ ファイルを開きます。 3. `-Dmule.http.service.implementation=NETTY`​ プロパティを追加します。 ```text -Dorg.mule.tooling.runtime.args=-XX:-UseBiasedLocking,-Dfile.encoding=UTF-8,-XX:+UseG1GC,-XX:+UseStringDeduplication,-Dmule.deployment.forceParseConfigXmls=true,-Dmule.http.service.implementation=NETTY ``` Windows: 1. Anypoint Studio のインストールディレクトリ内で ​`AnypointStudio.ini`​ ファイルを探します。 2. `-Dmule.http.service.implementation=NETTY`​ プロパティを追加します。 ```text -Dorg.mule.tooling.runtime.args=-XX:-UseBiasedLocking,-Dfile.encoding=UTF-8,-XX:+UseG1GC,-XX:+UseStringDeduplication,-Dmule.deployment.forceParseConfigXmls=true,-Dmule.http.service.implementation=NETTY ``` ## [](#create-mule-project)Mule プロジェクトを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#configure-source)ソースの設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] 次のソースのいずれかを MCP Connector で使用するように設定できます。 - [On New Session Listener](https://docs.mulesoft.com/jp/mcp-connector/0.1/mcp-connector-reference#OnNewSessionListener) - [Resource Listener](https://docs.mulesoft.com/jp/mcp-connector/0.1/mcp-connector-reference#ResourceListener) - [Tool Listener](https://docs.mulesoft.com/jp/mcp-connector/0.1/mcp-connector-reference#ToolListener) Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#add-connector-operation)フローにコネクタの操作を追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#configure-global-element)コネクタのグローバル要素を設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] 1. **\[General (一般)\]**​ タブの ​**\[Connection (接続)\]**​ で、設定する認証方式を選択します。MCP プロトコルのセキュリティは主に OAuth 認証コードフローに基づきます。さまざまなシステムや使用法との互換性を維持するため、コネクタでは次を含めその他の認証方法もサポートされます。 - [基本認証](#basic-authentication) - [OAuth 認証コード](#oauth-auth-code) - [OAuth Client Credentials (OAuth クライアントログイン情報)](#oauth-client-credentials) - [ダイジェスト](#digest) - [NTLM](#ntlm) Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ### [](#basic-authentication)基本認証 **\[Global Element Properties (グローバル要素のプロパティ)\]**​ 画面の ​**\[General (一般)\]**​ タブで認証情報を入力し、基本認証を設定します。 1. **\[Connection (接続)\] > \[Basic (基本)\]**​ を選択し、次の項目の値を入力または設定します。
項目 ユーザーアクション

Name (名前)

設定名を入力します。

Username (ユーザー名)

セッションの初期化に使用するユーザー名。

Password (パスワード)

ユーザーの認証に使用するパスワード。

Preemptive (プリエンプティブ)

true に設定すると、クライアントはサーバーがクライアントにチャレンジ (401 未承認) するのを待たずに、認証ログイン情報 (ユーザー名とパスワード) をサーバーへの初期 HTTP 要求と共に送信します。

### [](#oauth-auth-code)OAuth 認証コード クライアントがエンドユーザー (人間) の代理となる場合に使用されます。たとえば、エージェントは SaaS システムによって実装された MCP ツールをコールします。 ### [](#oauth-client-credentials)OAuth Client Credentials (OAuth クライアントログイン情報) マシン間の認証で使用されます。クライアントアプリケーションは、そのクライアント ID とクライアントシークレットを使用して自身を認証サーバーで直接認証し、アクセストークンを受け取ります。 これは、アプリケーションがユーザーの代理ではなく自身のためにリソースにアクセスしている場合に使用されます。 ### [](#digest)ダイジェスト パスワードをプレーンテキストで送信することを避けるためにチャレンジ/レスポンスメカニズムを使用する HTTP 認証スキーム。このスキームでは、パスワードとその他の情報をハッシュ化してクライアントの ID を検証します。 ### [](#ntlm)NTLM 主に Windows 環境で使用される Microsoft 認証プロトコル。チャレンジレスポンスメカニズムを使用し、ネットワーク認証で一般的に使用されます。 ## [](#configure-other-fields)その他のコネクタ項目の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#debug)アプリケーションをデバッグする Studio の埋め込みデバッガーを使用して Mule アプリケーションをデバッグします。 アプリケーションをデバッグする前に、​`-Dmule.http.service.implementation=NETTY`​ プロパティをデバッグ設定に追加します。 [Logging and Debugging](https://docs.mulesoft.com/mule-runtime/latest/logging-and-debugging)を参照してください。 ## [](#view-app-log)アプリケーションログの表示 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#deploy)アプリケーションをデプロイする Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#次のステップ)次のステップ - [MCP Connector の例を試します](https://docs.mulesoft.com/jp/mcp-connector/0.1/mcp-connector-examples)​。 - [MCP サーバーにセキュリティを適用します](https://docs.mulesoft.com/jp/mcp-connector/0.1/mcp-connector-config-topics)​。 ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] \* [デプロイメントオプション](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies) # Anypoint Studio を使用した MCP Connector 1.0 の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#create-mule-project)Mule プロジェクトを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#configure-source)ソースの設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] 次のソースのいずれかを MCP Connector で使用するように設定できます。 - [On New Session Listener](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-reference#OnNewSessionListener) - [Resource Listener](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-reference#ResourceListener) - [Tool Listener](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-reference#ToolListener) Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#add-connector-operation)フローにコネクタの操作を追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#configure-global-element)コネクタのグローバル要素を設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] 1. **\[General (一般)\]**​ タブの ​**\[Connection (接続)\]**​ で、設定する認証方式を選択します。MCP プロトコルのセキュリティは主に OAuth 認証コードフローに基づきます。さまざまなシステムや使用法との互換性を維持するため、コネクタでは次を含めその他の認証方法もサポートされます。 - [基本認証](#basic-authentication) - [OAuth 認証コード](#oauth-auth-code) - [OAuth Client Credentials (OAuth クライアントログイン情報)](#oauth-client-credentials) - [ダイジェスト](#digest) - [NTLM](#ntlm) Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ### [](#basic-authentication)基本認証 **\[Global Element Properties (グローバル要素のプロパティ)\]**​ 画面の ​**\[General (一般)\]**​ タブで認証情報を入力し、基本認証を設定します。 1. **\[Connection (接続)\] > \[Basic (基本)\]**​ を選択し、次の項目の値を入力または設定します。
項目 ユーザーアクション

Name (名前)

設定名を入力します。

Username (ユーザー名)

セッションの初期化に使用するユーザー名。

Password (パスワード)

ユーザーの認証に使用するパスワード。

Preemptive (プリエンプティブ)

true に設定すると、クライアントはサーバーがクライアントにチャレンジ (401 未承認) するのを待たずに、認証ログイン情報 (ユーザー名とパスワード) をサーバーへの初期 HTTP 要求と共に送信します。

### [](#oauth-auth-code)OAuth 認証コード クライアントがエンドユーザー (人間) の代理となる場合に使用されます。たとえば、エージェントは SaaS システムによって実装された MCP ツールをコールします。 ### [](#oauth-client-credentials)OAuth Client Credentials (OAuth クライアントログイン情報) マシン間の認証で使用されます。クライアントアプリケーションは、そのクライアント ID とクライアントシークレットを使用して自身を認証サーバーで直接認証し、アクセストークンを受け取ります。 これは、アプリケーションがユーザーの代理ではなく自身のためにリソースにアクセスしている場合に使用されます。 ### [](#digest)ダイジェスト パスワードをプレーンテキストで送信することを避けるためにチャレンジ/レスポンスメカニズムを使用する HTTP 認証スキーム。このスキームでは、パスワードとその他の情報をハッシュ化してクライアントの ID を検証します。 ### [](#ntlm)NTLM 主に Windows 環境で使用される Microsoft 認証プロトコル。チャレンジレスポンスメカニズムを使用し、ネットワーク認証で一般的に使用されます。 ## [](#configure-other-fields)その他のコネクタ項目の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#debug)アプリケーションをデバッグする Studio の埋め込みデバッガーを使用して Mule アプリケーションをデバッグします。 [Logging and Debugging](https://docs.mulesoft.com/mule-runtime/latest/logging-and-debugging)を参照してください。 ## [](#view-app-log)アプリケーションログの表示 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#apply-mcp-policies)MCP ポリシーの適用 MCP Connector では、MCP サーバーエンドポイントのセキュリティ、監視、ガバナンスを強化するポリシーがサポートされます。アクセスの制御、認証の追加、レート制限の実装、セキュリティの一層の強化を行うためのポリシーを適用できます。 使用可能な MCP ポリシー: - **MCP Support Policy (MCP サポートポリシー)** MCP サポートを Flex Gateway MCP サーバーインスタンスに追加します。MCP サーバーインスタンスを適切に機能させるには、このポリシーが必要です。 - **MCP Schema Validation Policy (MCP スキーマ検証ポリシー)**​ MCP 要求を検証して MCP 仕様に準拠していることを確認します。 - **MCP Attribute-Based Access Control Policy (MCP 属性ベースのアクセス制御ポリシー)** 層、IP、ヘッダー、クレームなどのユーザー情報に基づいてツール、リソース、プロンプトへのアクセスを制御します。 ### [](#mcp-ポリシーのベストプラクティス)MCP ポリシーのベストプラクティス - 本番 MCP サーバーには認証ポリシーを必ず適用します。 - ログポリシーを使用して MCP クライアントのアクティビティを追跡します。 - レート制限を実装して、悪用を防止し、公正な使用を確保します。 - 開発環境、ステージング環境、本番環境で異なるポリシーを設定します。 - ポリシー設定を定期的に見直して更新します。 使用可能なポリシーと設定についての詳細は、x[Inbound Policies Directory](https://docs.mulesoft.com/gateway/latest/policies-included-directory)を参照してください。 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#次のステップ)次のステップ - [MCP Connector の例を試します](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-examples)​。 - [MCP サーバーにセキュリティを適用します](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-config-topics)​。 ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] # Anypoint Studio を使用した MCP Connector 1.1 の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#create-mule-project)Mule プロジェクトを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#configure-source)ソースの設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] 次のソースのいずれかを MCP Connector で使用するように設定できます。 - [On New Session Listener](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-reference#OnNewSessionListener) - [Resource Listener](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-reference#ResourceListener) - [Tool Listener](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-reference#ToolListener) Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#add-connector-operation)フローにコネクタの操作を追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#configure-global-element)コネクタのグローバル要素を設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] 1. **\[General (一般)\]**​ タブの ​**\[Connection (接続)\]**​ で、設定する認証方式を選択します。MCP プロトコルのセキュリティは主に OAuth 認証コードフローに基づきます。さまざまなシステムや使用法との互換性を維持するため、コネクタでは次を含めその他の認証方法もサポートされます。 - [基本認証](#basic-authentication) - [OAuth 認証コード](#oauth-auth-code) - [OAuth Client Credentials (OAuth クライアントログイン情報)](#oauth-client-credentials) - [ダイジェスト](#digest) - [NTLM](#ntlm) Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ### [](#basic-authentication)基本認証 **\[Global Element Properties (グローバル要素のプロパティ)\]**​ 画面の ​**\[General (一般)\]**​ タブで認証情報を入力し、基本認証を設定します。 1. **\[Connection (接続)\] > \[Basic (基本)\]**​ を選択し、次の項目の値を入力または設定します。
項目 ユーザーアクション

Name (名前)

設定名を入力します。

Username (ユーザー名)

セッションの初期化に使用するユーザー名。

Password (パスワード)

ユーザーの認証に使用するパスワード。

Preemptive (プリエンプティブ)

true に設定すると、クライアントはサーバーがクライアントにチャレンジ (401 未承認) するのを待たずに、認証ログイン情報 (ユーザー名とパスワード) をサーバーへの初期 HTTP 要求と共に送信します。

### [](#oauth-auth-code)OAuth 認証コード クライアントがエンドユーザー (人間) の代理となる場合に使用されます。たとえば、エージェントは SaaS システムによって実装された MCP ツールをコールします。 ### [](#oauth-client-credentials)OAuth Client Credentials (OAuth クライアントログイン情報) マシン間の認証で使用されます。クライアントアプリケーションは、そのクライアント ID とクライアントシークレットを使用して自身を認証サーバーで直接認証し、アクセストークンを受け取ります。 これは、アプリケーションがユーザーの代理ではなく自身のためにリソースにアクセスしている場合に使用されます。 ### [](#digest)ダイジェスト パスワードをプレーンテキストで送信することを避けるためにチャレンジ/レスポンスメカニズムを使用する HTTP 認証スキーム。このスキームでは、パスワードとその他の情報をハッシュ化してクライアントの ID を検証します。 ### [](#ntlm)NTLM 主に Windows 環境で使用される Microsoft 認証プロトコル。チャレンジレスポンスメカニズムを使用し、ネットワーク認証で一般的に使用されます。 ## [](#configure-other-fields)その他のコネクタ項目の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#debug)アプリケーションをデバッグする Studio の埋め込みデバッガーを使用して Mule アプリケーションをデバッグします。 [Logging and Debugging](https://docs.mulesoft.com/mule-runtime/latest/logging-and-debugging)を参照してください。 ## [](#view-app-log)アプリケーションログの表示 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#apply-mcp-policies)MCP ポリシーの適用 MCP Connector では、MCP サーバーエンドポイントのセキュリティ、監視、ガバナンスを強化するポリシーがサポートされます。アクセスの制御、認証の追加、レート制限の実装、セキュリティの一層の強化を行うためのポリシーを適用できます。 使用可能な MCP ポリシー: - **MCP Support Policy (MCP サポートポリシー)** MCP サポートを Flex Gateway MCP サーバーインスタンスに追加します。MCP サーバーインスタンスを適切に機能させるには、このポリシーが必要です。 - **MCP Schema Validation Policy (MCP スキーマ検証ポリシー)**​ MCP 要求を検証して MCP 仕様に準拠していることを確認します。 - **MCP Attribute-Based Access Control Policy (MCP 属性ベースのアクセス制御ポリシー)** 層、IP、ヘッダー、クレームなどのユーザー情報に基づいてツール、リソース、プロンプトへのアクセスを制御します。 ### [](#mcp-ポリシーのベストプラクティス)MCP ポリシーのベストプラクティス - 本番 MCP サーバーには認証ポリシーを必ず適用します。 - ログポリシーを使用して MCP クライアントのアクティビティを追跡します。 - レート制限を実装して、悪用を防止し、公正な使用を確保します。 - 開発環境、ステージング環境、本番環境で異なるポリシーを設定します。 - ポリシー設定を定期的に見直して更新します。 使用可能なポリシーと設定についての詳細は、x[Inbound Policies Directory](https://docs.mulesoft.com/gateway/latest/policies-included-directory)を参照してください。 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#次のステップ)次のステップ - [MCP Connector の例を試します](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-examples)​。 - [MCP サーバーにセキュリティを適用します](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-config-topics)​。 ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] # Anypoint Studio を使用した MCP Connector 1.2 の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#create-mule-project)Mule プロジェクトを作成する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#add-connector-to-project)コネクタを Mule プロジェクトに追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#configure-source)ソースの設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] 次のソースのいずれかを MCP Connector で使用するように設定できます。 - [On New Session Listener](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-reference#OnNewSessionListener) - [Resource Listener](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-reference#ResourceListener) - [Tool Listener](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-reference#ToolListener) Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#add-connector-operation)フローにコネクタの操作を追加する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#configure-global-element)コネクタのグローバル要素を設定する Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] 1. **\[General (一般)\]**​ タブの ​**\[Connection (接続)\]**​ で、設定する認証方式を選択します。MCP プロトコルのセキュリティは主に OAuth 認証コードフローに基づきます。さまざまなシステムや使用法との互換性を維持するため、コネクタでは次を含めその他の認証方法もサポートされます。 - [基本認証](#basic-authentication) - [OAuth 認証コード](#oauth-auth-code) - [OAuth Client Credentials (OAuth クライアントログイン情報)](#oauth-client-credentials) - [ダイジェスト](#digest) - [NTLM](#ntlm) Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ### [](#basic-authentication)基本認証 **\[Global Element Properties (グローバル要素のプロパティ)\]**​ 画面の ​**\[General (一般)\]**​ タブで認証情報を入力し、基本認証を設定します。 1. **\[Connection (接続)\] > \[Basic (基本)\]**​ を選択し、次の項目の値を入力または設定します。
項目 ユーザーアクション

Name (名前)

設定名を入力します。

Username (ユーザー名)

セッションの初期化に使用するユーザー名。

Password (パスワード)

ユーザーの認証に使用するパスワード。

Preemptive (プリエンプティブ)

true に設定すると、クライアントはサーバーがクライアントにチャレンジ (401 未承認) するのを待たずに、認証ログイン情報 (ユーザー名とパスワード) をサーバーへの初期 HTTP 要求と共に送信します。

### [](#oauth-auth-code)OAuth 認証コード クライアントがエンドユーザー (人間) の代理となる場合に使用されます。たとえば、エージェントは SaaS システムによって実装された MCP ツールをコールします。 ### [](#oauth-client-credentials)OAuth Client Credentials (OAuth クライアントログイン情報) マシン間の認証で使用されます。クライアントアプリケーションは、そのクライアント ID とクライアントシークレットを使用して自身を認証サーバーで直接認証し、アクセストークンを受け取ります。 これは、アプリケーションがユーザーの代理ではなく自身のためにリソースにアクセスしている場合に使用されます。 ### [](#digest)ダイジェスト パスワードをプレーンテキストで送信することを避けるためにチャレンジ/レスポンスメカニズムを使用する HTTP 認証スキーム。このスキームでは、パスワードとその他の情報をハッシュ化してクライアントの ID を検証します。 ### [](#ntlm)NTLM 主に Windows 環境で使用される Microsoft 認証プロトコル。チャレンジレスポンスメカニズムを使用し、ネットワーク認証で一般的に使用されます。 ## [](#configure-other-fields)その他のコネクタ項目の設定 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#debug)アプリケーションをデバッグする Studio の埋め込みデバッガーを使用して Mule アプリケーションをデバッグします。 [Logging and Debugging](https://docs.mulesoft.com/mule-runtime/latest/logging-and-debugging)を参照してください。 ## [](#view-app-log)アプリケーションログの表示 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] ## [](#apply-mcp-policies)MCP ポリシーの適用 MCP Connector では、MCP サーバーエンドポイントのセキュリティ、監視、ガバナンスを強化するポリシーがサポートされます。アクセスの制御、認証の追加、レート制限の実装、セキュリティの一層の強化を行うためのポリシーを適用できます。 使用可能な MCP ポリシー: - **MCP Support Policy (MCP サポートポリシー)** MCP サポートを Flex Gateway MCP サーバーインスタンスに追加します。MCP サーバーインスタンスを適切に機能させるには、このポリシーが必要です。 - **MCP Schema Validation Policy (MCP スキーマ検証ポリシー)**​ MCP 要求を検証して MCP 仕様に準拠していることを確認します。 - **MCP Attribute-Based Access Control Policy (MCP 属性ベースのアクセス制御ポリシー)** 層、IP、ヘッダー、クレームなどのユーザー情報に基づいてツール、リソース、プロンプトへのアクセスを制御します。 ### [](#mcp-ポリシーのベストプラクティス)MCP ポリシーのベストプラクティス - 本番 MCP サーバーには認証ポリシーを必ず適用します。 - ログポリシーを使用して MCP クライアントのアクティビティを追跡します。 - レート制限を実装して、悪用を防止し、公正な使用を確保します。 - 開発環境、ステージング環境、本番環境で異なるポリシーを設定します。 - ポリシー設定を定期的に見直して更新します。 使用可能なポリシーと設定についての詳細は、x[Inbound Policies Directory](https://docs.mulesoft.com/gateway/latest/policies-included-directory)を参照してください。 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$mcp-connector-partial.adoc\[\] ## [](#次のステップ)次のステップ - [MCP Connector の例を試します](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-examples)​。 - [MCP サーバーにセキュリティを適用します](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-config-topics)​。 ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-studio.adoc - include::connectors::partial$t-studio-partial.adoc\[\] # MCP Connector 0.1.0-BETA MCP 用 Anypoint Connector (MCP Connector) では、Model Context Protocol (MCP) を使用して、MCP をサポートする AI クライアントが API、コネクタ、アプリケーションを呼び出して、それらと通信できるようにします。

MCP Connector は、 Salesforce.com の契約に関するページ​のベータサービス規約か、お客様が署名された Unified Pilot Agreement、および 「製品規約ディレクトリ」​の非正式リリースの生成 AI と非正式リリースのクレジット消費条件に従うベータコネクタです。外部システムまたはサービスでこのベータコネクタを使用すると Mule メッセージがコンシュームされます。このベータコネクタは、お客様独自の裁量で使用するものとします。

MCP Connector を使用して LLM アプリケーションを API に接続します。複雑なエンドポイントを持つ API は、エージェントクライアントに適した簡単かつアトミックなツールまたはリソースとして公開できます。重要なことは、エージェントのアクションにとって何が簡単で、繰り返し可能で、最適であるかを決定し、そこから始めることです。 MCP は、LLM アプリケーションと外部データ、サービス、およびツール間のシームレスなインテグレーションを可能にするオープンプロトコルです。MCP は、LLM とエージェントアプリケーションが一貫した方法で相互に (および既存のシステムと) 通信できるようにする新しい標準です。 MCP プロトコル: - AI に関連情報を提供することで AI の精度を強化し、応答の正確さを向上します。 - 外部データまたはサービスへのアクセスを必要とする複雑なタスクを AI が管理できるようにします。 - AI モデルと外部システム間の相互運用性を促進し、ワークフローへの統合を簡略化します。 MCP Connector: - Mule アプリケーション、コネクタ、カスタム API を、MCP をサポートする AI クライアント (Claude、Cursor、Windsurf など) で使用できるようにします。これにより、エージェントインターフェースを迅速かつシームレスに作成し、Mule API をこれらのクライアントに公開することができます。 - MCP サーバーとクライアントの両方の機能を果たすことができる Mule アプリケーションを作成できます。結果の Mule MCP サーバーは Mule の内部で実行されます。つまり、独自のホスト環境を設定する必要はありません。Mule はエージェントのニーズにエンドツーエンドで対応します。 - MCP サーバーとして機能する場合、MuleSoft を使用すると、AI クライアントは、MCP をネイティブにサポートしない既存の API 主導の投資、従来のシステム、SaaS アプリケーションを活用できます、 - MCP クライアントとして機能する場合、MuleSoft では、エージェントが単にコレオグラフィ内の別のシステムになっているインテグレーションやオーケストレーションを構築できます。 - Mule をオーケストレーションレイヤーとして使用することで、AI エージェントを既存のエンタープライズエコシステムに導入できます。 これにより、増大している AI エージェントエコシステムで Mule API とアプリケーションの機能を使用できます。 互換性と修正された問題については、「MCP Connector リリースノート」を参照してください。 ## [](#始める前に)始める前に このコネクタを使用するには、以下に精通している必要があります。 - Anypoint Connector - Mule Runtime Engine (Mule) - Mule フローの要素とグローバル要素 - Anypoint Code Builder または Anypoint Studio を使用して Mule アプリケーションを作成する方法 アプリケーションを作成する前に、以下が必要です。 - Java 17 - Apache Maven - Anypoint Platform - 対象リソースに接続するためのログイン情報 - Anypoint Code Builder または Anypoint Studio の最新バージョン ## [](#コネクタの一般的なユースケース)コネクタの一般的なユースケース 次に、コネクタの一般的なユースケースを示します。 - カスタマーサービス AI エージェントを使用して、時間のかかるタスク (ケース履歴の確認、報告された問題の分析、関連情報の取得など) を処理することで、人間のエージェントの効率を高めます。 - セールス プロスペクトの調査を加速し、カスタマイズした資料を生成し、契約書を作成することで、営業チームの成功を促進します。 - マーケティング ソーシャルメディアコンテンツのドラフトの作成、市場調査の実施、キャンペーンパフォーマンスの分析に AI 主導のサポートを提供することでマーケティングチームを強化します。 ## [](#接続種別)接続種別 - SSE クライアント サーバー送信イベント (SSE) 標準を使用して、MCP Connector が MCP サーバーへの永続的な一方向 (サーバー送信) 接続を確立できるようにします。この種別の接続を使用すると、MCP サーバーはリアルタイム更新およびメッセージをクライアントにプッシュすることができ、クライアントは新しい情報を常にポーリングする必要がなくなります。 - SSE Server サーバー送信イベント (SSE) トランスポートを使用して、MCP サーバーを公開します。これにより、MCP クライアントはこのサーバーへの永続的な一方向接続を確立し、リアルタイム更新およびメッセージを受信できます。 ## [](#次のステップ)次のステップ Unresolved include directive in modules/ROOT/pages/index.adoc - include::connectors::partial$t-index-partial.adoc\[\] ## [](#関連情報)関連情報 - [Anypoint Connectors Overview](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Using Anypoint Code Builder to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb) - [Using Anypoint Studio to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/0.1/mcp-connector-reference) - [MuleSoft MCP サポート: Model Context Protocol の使用開始](https://blogs.mulesoft.com/news/model-context-protocol/) - [Model Context Protocol](https://modelcontextprotocol.io/introduction) - [HTTP With SSE](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#http-with-sse) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 0.1.0-BETA - MCP サーバーへのセキュリティの適用 MCP Connector により MCP クライアントのサーバー側認証が可能になります。これらの例では、ステートフルなサーバー送信イベント (SSE) 接続と ​**On New Session Listener**​ ソースを使用して、OAuth アクセストークンの検証を含むカスタムセキュリティロジックを実装します。 ## [](#on-new-session-listener-を使用したサーバー側認証)On New Session Listener を使用したサーバー側認証 MCP 仕様ではセッション管理を強調し、SSE 接続では状態を維持します。​**On New Session Listener**​ ソースでは、サーバー側認証を実装するための重要なポイントが提供されます。この例は、このリスナーでトリガーされる基本フローを示しており、自動生成された ​`sessionId`​ と、接続しているクライアントにより送信された HTTP ヘッダーへのアクセス方法を示しています。これらはその後、カスタム認証ロジックで使用できます。 これは、​**On New Session Listener**​ ソースを使用するサンプルフローです。 ```xml ``` このフローは、新しいクライアントが MCP サーバーアプリケーションに接続するたびに実行されます。ペイロードには自動生成された ​`sessionId`​ と ​`additionalProperties`​ が含まれています。SSE 接続種別を使用する場合、これらは HTTP リクエストヘッダーにマッピングされます。 この時点で独自の認証ロジックを実装できます。たとえば、​`#[payload.additionalProperties.authorization]`​ 式で HTTP 認証ヘッダーを取得し、後で検証することができます。 ### [](#oauth-アクセストークンの検証)OAuth アクセストークンの検証 必要に応じて、​[Mule OAuth 2.0 プロバイダー](https://docs.mulesoft.com/jp/api-manager/latest/mule-oauth-provider-landing-page)​を使用して、OAuth アクセストークンの実装と検証を行うことができます。 このサンプルフローでは、OAuth プロバイダーを使用してアクセストークンが検証され、トークンが無効な場合はセッションが拒否されます。 ```xml ``` 次の 2 つのいずれかに該当する場合、新しいセッションは拒否されます。 - `rejectWithStatusCode`​ パラメーターに null 以外の値 (または null 以外の値に解決する式) が割り当てられている、または - フローが失敗した場合、状況コード 500 が報告される この例では、状況コードが ​`401 - UNAUTHORIZED`​ コードにマッピングされるように OAuth 検証エラーが処理されます。 ## [](#クライアント側認証)クライアント側認証 クライアントでは、認証パラメーターは、HTTP Connector と ​[OAuth Module](https://docs.mulesoft.com/jp/oauth-module/latest/)​ (これもプロジェクトに追加されている場合) で定義されたすべての認証戦略を受け入れます。 **Call Tool**​ などの操作は追加のプロパティも受け入れます。SSE の場合、このプロパティはリクエストヘッダーにマッピングされます。これにより、API キーなどのカスタム認証ヘッダーを追加することができます。次に例を示します。 ```xml ``` ## [](#次のステップ)次のステップ コネクタの設定が完了したら、​[例](https://docs.mulesoft.com/jp/mcp-connector/0.1/mcp-connector-examples)​を試すことができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 0.1.0-BETA - 例 既存の API を使用して、MCP Connector を使用してエージェントを作成する方法の例を次にいくつか示します。 ## [](#mcp-サーバーとツールの作成)MCP サーバーとツールの作成 これらの例は、Mule アプリケーション内で MCP サーバーを作成し、MCP サーバーで公開される 2 つの個別のツールを定義するプロセスを示しています。1 つは、承認済みベンダーの動的リストを各ベンダーの商品カテゴリとともに取得するツールで、もう 1 つは、指定された詳細で購入注文の作成を開始するツールです。 これらの例は、MCP ツールの概念を呼び出し可能なリモートプロシージャーコール (RPC) として示しています。 ### [](#mcp-サーバー設定の作成)MCP サーバー設定の作成 この例は、サーバー送信イベント (SSE) トランスポートを使用して Mule アプリケーション内で MCP サーバーを設定する方法を示しています。この設定は既存の HTTP リスナー設定に基づいて作成されているため、Mule インスタンスでは MCP エンドポイントと従来の HTTP ベース API を同じポートで同時に提供することができます。 ```xml ``` ### [](#ベンダーのリストを提供するツールの作成)ベンダーのリストを提供するツールの作成 この例は、外部システム (この例では SAP Concur) から承認済みベンダーの動的リストを取得する MCP ツールを作成する方法を示しています.この例は、​``​ を使用してコール可能なツールを定義する方法と、データを処理し、​`Custom19`​ 項目からの割り当て済み商品カテゴリを含め、関連ベンダー情報をエージェントに提供する方法を示しています。 ```xml #(1) Get all approved vendors #(2) #(4) ```
1ツールは、​<mcp:tool-listener>​ からトリガーされる Mule フローを介して実装されます。
2<mcp:description>​ では、ツールの目的についての説明が自然言語で提供されるため、LLM はツールを使用するタイミングを理解することができます。
3<mcp:parameters-schema>​ では、ツールの入力引数を定義します。この簡単な例では、これは空の JSON スキーマであり、入力パラメーターが不要であることを示しています。
4<mcp:responses>​ セクションでは、ツールの出力を定義します。ここでは、フローで生成された未加工の JSON ペイロードが含まれるテキスト応答をツールで返すことが指定されています。
このフローでは、最初に専用のコネクタを使用して SAP Concur からベンダーのリストを取得します。次に DataWeave を使用してデータを変換して承認済みベンダーを絞り込み、カスタム項目からの商品カテゴリを含め、関連項目をマップします。結果の JSON 出力では、ベンダーを選択するために必要な情報が LLM に提供されます。 ### [](#購入注文を作成するツールの作成)購入注文を作成するツールの作成 この例は、エージェントが SAP Concur で購入注文の作成を開始するために使用できる MCP ツールの作成方法を示しています。この例では、JSON スキーマを使用してツールの入力パラメーターを定義する方法が強調されています。パラメーターごとに自然言語の説明が含まれており、これにより LLM は必要な情報を理解して入力することができます。 ```xml ``` その後、フローはコネクタを使用して注文を作成し、注文の ID を含む 1 行のテキストを返します。書式設定された応答は不要です。 ## [](#サードパーティ-mcp-サーバーを使用する-mcp-クライアントの設定)サードパーティ MCP サーバーを使用する MCP クライアントの設定 前の例では、既存の Anypoint Connector から情報を取得するツールの作成方法が示されました。 すでに実装され、使用準備が整っているサードパーティ MCP サーバーを使用することもできます。これらの例は、MCP クライアントを設定し、​**Call Tool**​ 操作を使用することで、Mule アプリケーションを既存のサードパーティ MCP サーバーと統合する方法を示しています。 次に、Heroku にデプロイされた Google マップ MCP サーバーを使用して設定された MCP クライアントの例を示します。 ```xml ``` クライアント接続を設定する機能により、サードパーティ MCP サーバーが解放され、アプリケーションネットワークへの扉が開かれます。 MCP クライアント設定が定義されたら、​**Call tool**​ (​`mcp-call-tool`​) 操作を使用して、MCP サーバーで公開されている特定のツールを呼び出すことができます。​**Call Tool**​ 操作では、対象 MCP サーバーからメタデータ (使用可能なツールとその引数を含む) を動的に取得して、Mule フロー内で DataSense のオートコンプリートを提供します。 この例では、特定の座標での予報を返す簡単な天気ツールを作成します。 ```xml Provides the weather at given coordinates expressed as latitude and longitude> ``` このツールでは、OpenMeteo API を使用して、特定の座標での予報を返します。 座標ではなく住所で天気ルックアップを処理するには、Google マップ MCP サーバー (前半に設定済み) を活用して座標を取得した後、​`get-weather-by-coordinates`​ ツール (内部的に OpenMeteo API をコールする) を使用する新しい MCP ツールを作成します。 ```xml Provides the weather at a specific address ``` この例では、LLM にすべてのツールを個別に提供するのではなく、構成を手動で記述しています。その理由を次に示します。 - LLM にはすべての MCP サーバーへのアクセス権が必要です。 - LLM はすべての MCP サーバーを安全に認証できる必要があります。 - LLM でオーケストレーションを行う場合、ガバナンスやトレースなどが複雑になります。 一部のユースケースでは、LLM でオーケストレーション全体を行うことが理にかなっていますが、それ以外では手動構成が適しています。 ## [](#関連情報)関連情報 - [MCP サーバーへのセキュリティの適用](https://docs.mulesoft.com/jp/mcp-connector/0.1/mcp-connector-config-topics) - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/0.1/mcp-connector-reference) - [MuleSoft MCP サポート: Model Context Protocol の使用開始](https://blogs.mulesoft.com/news/model-context-protocol/) - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 0.1.0-BETA XML と Maven のサポート Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#コネクタの名前空間の追加)コネクタの名前空間の追加 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#次のステップ)次のステップ Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] # MCP Connector 0.1.0-BETA リファレンス MCP 用 Anypoint Connector (MCP Connector) を使用すると、Mule アプリケーションは MCP サーバーとクライアントの両方の機能を果たすことができます。このベータバージョンにはツールとリソースのサポートも含まれます。 ## [](#設定)設定 ### [](#Client)クライアント クライアントとして機能し、MCP サーバーに接続される設定要素。 #### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Client Name (クライアント名)

String (文字列)

プロトコル初期化フェーズ中にクライアントが自身を識別するために使用する名前。これは、この設定要素に指定される名前 (後で config-ref パラメーターを介して参照される) とは異なります。この名前は一意である必要はありません。

x

Client Version (クライアントバージョン)

String (文字列)

プロトコル初期化フェーズ中にクライアントが自身を識別するために使用するバージョン。これは、コネクタまたは Mule アプリケーションのバージョンに一致する必要はありません。

x

Name (名前)

String (文字列)

この設定の参照に使用される ID。

x

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

#### [](#接続種別)接続種別 ##### [](#Client_SseClient)SSE クライアント SSE (サーバー送信イベント) クライアント接続種別を使用すると、SSE 標準を使用して、MCP Connector が MCP サーバーへの永続的な一方向 (サーバー送信) 接続を確立できます。この種別の接続を使用すると、MCP サーバーはリアルタイム更新およびメッセージをクライアントにプッシュすることができ、クライアントは新しい情報を常にポーリングする必要がなくなります。 ###### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Server Url (サーバー URL)

String (文字列)

対象 MCP サーバーのベース URL。

x

Sse Endpoint Path (SSE エンドポイントパス)

String (文字列)

/sse

Request Timeout (要求タイムアウト)

Number

要求がタイムアウトする前に、サーバーの応答を待機する期間を設定します。

30

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Request Timeout (要求タイムアウト)] パラメーターの時間単位。

SECONDS

Reconnection Delay (再接続遅延)

Number (数値)

SSE 接続がタイムアウトまたは終了した場合に SSE 接続を再初期化するまで待機する時間を指定します。

500

Reconnection Delay Unit (再接続遅延単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Reconnection Delay (再接続遅延)] の時間単位。

MILLISECONDS

Authentication (認証)

HttpRequestAuthentication

Tls Context Factory (TLS コンテキストファクトリー)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

## [](#サポートされている操作)サポートされている操作 - [Call Tool](#CallTool)​ - [List Resources](#ListResources)​ - [List Tools](#ListTools)​ - [Ping](#Ping)​ - [Read Resource](#ReadResource)​ ### [](#Server)サーバー MCP サーバーとして機能する設定要素。 #### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続種別。

x

Server Name (サーバー名)

String (文字列)

プロトコル初期化フェーズ中にこのサーバーが自身を識別するために使用する名前。これは、この設定要素に指定される名前 (後で config-ref パラメーターを介して参照される) とは異なります。この名前は一意である必要はありません。

x

Server Version (サーバーバージョン)

String (文字列)

プロトコル初期化フェーズ中にこのクライアントが自身を識別するために使用するバージョン。これは、コネクタまたは Mule アプリケーションのバージョンに一致する必要はありません。

x

Name (名前)

String (文字列)

この設定の参照に使用される ID。

x

Subscribe

Boolean (ブール)

クライアントでリソースの更新をサブスクライブすることを許可するかどうか。

true

List Changed (リスト変更済み)

Boolean (ブール)

ツールリストの変更に対する通知を有効にするかどうか。

true

#### [](#接続種別-2)接続種別 ##### [](#Server_SseServer)SSE Server [「HTTP With SSE」](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#http-with-sse)​で定義されているとおりに、サーバー送信イベント (SSE) トランスポートを使用して、MCP サーバーを公開します。これにより、MCP クライアントはこのサーバーへの永続的な一方向接続を確立し、リアルタイム更新およびメッセージを受信できます。
この接続種別は、Mule が ​mule.http.service.implementation=NETTY​ システムプロパティを使用して開始されている場合のみ機能します。
###### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Listener Config (リスナー設定)

String (文字列)

SSE とメッセージングエンドポイントを公開するために使用する <http:listener-config> への参照。

x

Sse Endpoint Path (SSE エンドポイントパス)

String (文字列)

クライアントが SSE 接続を開始するために使用するエンドポイントパス。

/sse

Messages Path (メッセージパス)

String (文字列)

メッセージングエンドポイント要求の送信先となるパス。

/message

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

## [](#サポートされている操作-2)サポートされている操作 - [Add Static Resource](#AddStaticResource)​ ## [](#関連付けられたソース)関連付けられたソース - [On New Session Listener](#OnNewSessionListener)​ - [Resource listener](#ResourceListener)​ - [Tool Listener](#ToolListener)​ ## [](#操作)操作 ## [](#CallTool)Call Tool `` リモート MCP サーバー内でツールを呼び出します。 ### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Tool Name (ツール名)

String (文字列)

呼び出すツールの名前。

x

Arguments (引数)

Object (オブジェクト)

ツールの入力引数。

#[payload]

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Additional Properties (追加プロパティ)

Object (オブジェクト)

#[null]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力)出力

型

Call Tool Response (Call Tool 応答)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー)スロー - MCP:CONNECTIVITY - MCP:RETRY\_EXHAUSTED​ ## [](#ListResources)List Resources `` リモート MCP サーバー内のすべての使用可能なリソースをリストします。 ### [](#パラメーター-6)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。反復可能ストリームは、デフォルトの動作です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-2)出力

型

Resource Metadata (リソースメタデータ)​ の配列

### [](#次の設定の場合-2)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-2)スロー - MCP:CONNECTIVITY - MCP:RETRY\_EXHAUSTED​ ## [](#ListTools)List Tools `` リモート MCP サーバー内のすべての使用可能なツールをリストします。 ### [](#パラメーター-7)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。反復可能ストリームは、デフォルトの動作です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-3)出力

型

Tool Metadata (ツールメタデータ)​ の配列

### [](#次の設定の場合-3)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-3)スロー - MCP:CONNECTIVITY - MCP:RETRY\_EXHAUSTED​ ## [](#Ping)Ping `` リモートサーバーを ping します。 ### [](#パラメーター-8)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-4)出力

型

Any (任意)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合-4)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-4)スロー - MCP:CONNECTIVITY - MCP:RETRY\_EXHAUSTED​ ## [](#ReadResource)Read Resource `` URI で参照されるリソースを読み取ります。 ### [](#パラメーター-9)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Uri

String (文字列)

x

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Additional Properties (追加プロパティ)

Object (オブジェクト)

#[null]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-5)出力

型

Resource Content (リソースコンテンツ)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合-5)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-5)スロー - MCP:CONNECTIVITY - MCP:RETRY\_EXHAUSTED​ ## [](#AddStaticResource)Add Static Resource `` メタデータと静的コンテンツを指定して、リソースを動的に追加します。 ### [](#パラメーター-10)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Name (名前)

String (文字列)

リソース名。

x

Uri

String (文字列)

リソース URI。

x

Description (説明)

String (文字列)

リソースの説明。

x

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

x

Resource Content (リソースコンテンツ)

次のいずれかになります。

リソース定義。

x

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#次の設定の場合-6)次の設定の場合 - [サーバー](#Server)​ ### [](#スロー-6)スロー - MCP:CONNECTIVITY - MCP:RETRY\_EXHAUSTED​ ## [](#ソース)ソース ## [](#OnNewSessionListener)On New Session Listener `` ### [](#パラメーター-11)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reject With Status Code (状況コード付き拒否)

Number (数値)

Reject With Message (メッセージ付き拒否)

String (文字列)

### [](#出力-6)出力

型

New Session Request (新規セッション要求)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合-7)次の設定の場合 - [サーバー](#Server)​ ## [](#ResourceListener)Resource listener `` 所有フローの実行によりコンテンツが生成されたリソースを公開します。このフローは、受信したリソース/読み取り要求ごとに実行されます。ユーザーは、リソースコンテンツが静的になるようにフローを実装するか、リソースコンテンツを動的にするかを選択できます。たとえば、動的リソースには、実際はライブ DB クエリの実行結果である expenses.csv ファイルを使用できます。また、静的リソースには、Amazon S3 を介して取得され、 コンポーネントを使用してローカルにキャッシュされたファイルを使用できます。 ### [](#パラメーター-12)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Name (名前)

String (文字列)

リソースの名前。

x

Description (説明)

String (文字列)

このリソースを読み取るタイミングを LLM が判断するのに十分な詳細な説明。

x

Uri

String (文字列)

リソース URI。

x

Resource Mime Type (リソースの MIME タイプ)

String (文字列)

リソースの MIME タイプ。

x

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Resource Content (リソースコンテンツ)

次のいずれかになります。

リソースのコンテンツと種別を定義します。これらのパラメーターは、フローが正常に完了した場合 (ペイロードと変数が使用可能な場合) に評価されます。

x

### [](#出力-7)出力

型

Resource Request (リソース要求)

Attributes Type (属性型)

### [](#次の設定の場合-8)次の設定の場合 - [サーバー](#Server)​ ## [](#ToolListener)Tool Listener `` 所有フローの実行により結果が生成されたツールを公開します。このフローは、受信したツール/コール要求ごとに実行されます。トリガーされると、フローは、入力引数を保持する Java マップがペイロードとなっているメッセージを使用して実行されます。ツールの応答は、フローが正常に完了するかエラーで完了した場合に生成されます。いずれの場合も、応答には種別が異なるいくつかのコンテンツ項目が含まれている可能性があります。エラー応答が定義されていない場合、エラーの説明を含むテキストコンテンツ項目が自動的に生成されます。 ### [](#パラメーター-13)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Name (名前)

String (文字列)

ツールの名前

x

Description (説明)

String (文字列)

このツールをコールするタイミングを LLM が判断するのに十分な詳細な説明。

x

Parameters Schema (パラメータースキーマ)

String (文字列)

項目がツールの入力引数として機能するオブジェクトを定義する JSON スキーマ

x

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

x

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Responses (応答)

フローが正常に完了した場合の応答項目。

x

On Error Responses (エラー時の応答)

フローがエラーで完了した場合のコンテンツ項目。

### [](#出力-8)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request Attributes (要求属性)

### [](#次の設定の場合-9)次の設定の場合 - [サーバー](#Server)​ ## [](#型)型 ### [](#Tls)TLS Mule アプリケーションのセキュアな通信を提供するように TLS を設定します。
項目 型 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

TLS トラストストアを設定します。

Key Store (キーストア)

TLS キーストアを設定します。

Revocation Check (取り消し確認)

取り消し確認メカニズムを設定します。

### [](#TrustStore)Truststore (トラストストア) TLS 用のトラストストアを設定します。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

ストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用する暗号化アルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、Mule では証明書の検証の実行を停止します。これを ​true​ に設定すると、接続が攻撃に対して脆弱になる可能性があります。

### [](#KeyStore)Keystore (キーストア) TLS プロトコル用のキーストアを設定します。生成したキーストアには、非公開鍵と公開証明書が格納されます。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Type (型)

String (文字列)

ストアの型。

Alias (別名)

String (文字列)

キーストアに複数の非公開キーが含まれている場合に使用するキーの別名。デフォルトでは、Mule はファイル内の最初のキーを使用します。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用する暗号化アルゴリズム。

### [](#StandardRevocationCheck)Standard Revocation Check (標準の取り消し確認) TLS 証明書の標準取り消し確認を設定します。
項目 型 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーン内で確認する要素:

  • true​

証明書チェーンの最後の要素のみを確認します。

  • false​

証明書チェーンのすべての要素を確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

証明書の有効性を確認する方法:

  • true​

証明書失効リスト (CRL) で証明書の有効性を確認します。

  • false​

オンライン証明書状況プロトコル (OCSP) を使用して証明書の有効性を確認します。

No Fallback (代替なし)

Boolean (ブール)

証明書の有効性を確認するための第 2 の方法を使用するかどうか:

  • true​

[Prefer Crls (CRL を優先)]​ 項目で指定されていない方法 (第 2 の方法) を使用して証明書の有効性を確認します。

  • false​

証明書の有効性を確認するための第 2 の方法を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合の処理:

  • true​

検証エラーを回避します。

  • false​

検証の失敗を許可します。

### [](#CustomOcspResponder)Custom OCSP Responder (カスタム OCSP レスポンダー) 証明書の取り消し確認のカスタム OCSP レスポンダーを設定します。
項目 型 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

OCSP 応答の署名証明書の別名。指定した場合、別名はトラストストアに存在する必要があります。

### [](#CrlFile)CRL File (CRL ファイル) 証明書失効リスト (CRL) ファイルの場所を指定します。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。

### [](#reconnection-再接続)Reconnection (再接続) 操作の再接続戦略を設定します。
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイメントに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

### [](#reconnect-再接続)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#ReconnectForever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー) 有効期限ポリシー戦略を設定します。
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

動的設定インスタンスがアイドル状態を続けられる最大時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ 項目の時間単位。

### [](#CallToolResponse)Call Tool Response (Call Tool 応答)
項目 型 説明 デフォルト値 必須

Content (コンテンツ)

x

Error (エラー)

Boolean (ブール)

false

### [](#CallToolResponseContent)Call Tool Response Content (Call Tool 応答コンテンツ)
項目 型 説明 デフォルト値 必須

Type (型)

Enumeration (列挙)。次のいずれかになります。

  • text (テキスト)

  • Image (画像)

  • resource (リソース)

コンテンツタイプ。

x

Text (テキスト)

String (文字列)

型が ​text (テキスト)​ の場合のコンテンツのペイロード。

Mime Type (MIME タイプ)

String (文字列)

コンテンツの MIME タイプ。

Data (データ)

Binary (バイナリ)

型が ​image (画像)​ の場合のコンテンツのペイロード。

Resource (リソース)

型が ​resource (リソース)​ の場合のコンテンツのペイロード。

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

### [](#ResourceContent)Resource Content (リソースコンテンツ)
項目 型 説明 デフォルト値 必須

Uri

String (文字列)

リソース URI

x

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

x

Text (テキスト)

String (文字列)

テキストリソースのコンテンツ。BLOB データ型の場合は null。

Blob

Binary (バイナリ)

BLOB リソースのコンテンツ。テキストデータ型の場合は null。

### [](#ErrorMapping)エラーのマッピング
項目 型 説明 デフォルト値 必須

Source (ソース)

Enumeration (列挙)。次のいずれかになります。

  • ANY

  • REDELIVERY_EXHAUSTED​

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY​

  • SERVER_SECURITY​

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED​

  • TIMEOUT

変換先

String (文字列)

x

### [](#ResourceMetadata)Resource Metadata (リソースメタデータ)
項目 型 説明 デフォルト値 必須

Uri

String (文字列)

リソース URI。

x

Name (名前)

String (文字列)

リソースの名前。

x

Description (説明)

String (文字列)

リソースの説明。

x

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

x

### [](#RepeatableInMemoryIterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームをコンシュームしてランダムにアクセスするために割り当てられるメモリ量。ストリームのデータ量がこのバッファサイズを超える場合は、[Buffer Size Increment (バッファサイズ増分)] 値に従って、[Max In Memory Size (最大メモリ内サイズ)] 値を上限としてバッファが拡張されます。

100

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、拡張する量。値を ​0​ またはそれ以下に設定すると、バッファは拡張されません。

100

Max Buffer Size (最大バッファサイズ)

Number (数値)

バッファの最大サイズ。バッファサイズがこの値を超える場合、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。​0​ 以下の値は無制限を意味します。

### [](#RepeatableFileStoreIterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)
項目 型 説明 デフォルト値 必須

In Memory Objects (メモリ内オブジェクト)

Number (数値)

メモリ内に保持されるインスタンスの最大数。この最大数を超えるインスタンスが必要な場合、ディスク上のコンテンツがバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE

  • KB

  • MB

  • GB

[In Memory Objects (メモリ内オブジェクト)]​ 項目の単位。

### [](#ToolMetadata)Tool Metadata (ツールメタデータ)
項目 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

ツールの名前。

x

Description (説明)

String (文字列)

このツールをコールするタイミングを LLM が判断するのに十分な詳細な説明。

x

Input Schema (入力スキーマ)

String (文字列)

ツールの入力パラメーターを説明する JSON スキーマ。

x

### [](#NewSessionRequest)New Session Request (新規セッション要求)
項目 型 説明 デフォルト値 必須

Session Id (セッション ID)

String (文字列)

x

Additional Properties (追加プロパティ)

Object (オブジェクト)

x

### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー) エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。
項目 型 説明 デフォルト値 必須

Max Redelivery Count (最大再配信数)

Number (数値)

REDELIVERY_EXHAUSTED​ エラーが返されるまでに、再配信された要求が処理に失敗できる最大回数。

Message Digest Algorithm (メッセージダイジェストアルゴリズム)

String (文字列)

[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​true​ の場合に使用するセキュアハッシュアルゴリズム。メッセージのペイロードが Java オブジェクトの場合、Mule ではこの値が無視され、ペイロードの ​hashCode()​ が返した値が返されます。

Message Identifier (メッセージ識別子)

メッセージが再配信されたかどうかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。

Object Store (オブジェクトストア)

ObjectStore

各メッセージの再配信カウンターが保存されるオブジェクトストアを設定します。

### [](#RedeliveryPolicyMessageIdentifier)Redelivery Policy Message Identifier (再配信ポリシーメッセージ識別子) 再配信されたメッセージを識別する方法と、メッセージがいつ再配信されたのかを見つける方法を設定します。
項目 型 説明 デフォルト値 必須

Use Secure Hash (セキュアハッシュを使用)

Boolean (ブール)

true​ の場合、再配信されたメッセージの識別にセキュアハッシュアルゴリズムが使用されます。

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。

### [](#ResourceRequest)Resource Request (リソース要求)
項目 型 説明 デフォルト値 必須

Requested Uri (要求済み URI)

String (文字列)

x

### [](#RequestAttributes)Request Attributes (要求属性)
項目 型 説明 デフォルト値 必須

Session Id (セッション ID)

String (文字列)

x

Request Id (要求 ID)

String (文字列)

x

Additional Properties (追加プロパティ)

Object (オブジェクト)

x

### [](#TextToolResponseContent)Text Tool Response Content (テキストツール応答コンテンツ)
項目 型 説明 デフォルト値 必須

Text (テキスト)

String (文字列)

x

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

### [](#ImageToolResponseContent)Image Tool Response Content (画像ツール応答コンテンツ)
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Data (データ)

Binary (バイナリ)

Base64 でエンコードされていない未加工の画像コンテンツ。

Mime Type (MIME タイプ)

String (文字列)

画像の MIME タイプ。

### [](#TextResourceToolResponseContent)Text Resource Tool Response Content (テキストリソースツール応答コンテンツ)
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Uri

String (文字列)

リソース URI。

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

Text (テキスト)

String (文字列)

リソースのテキスト。

### [](#BlobResourceToolResponseContent)Blob Resource Tool Response Content (Blob リソースツール応答コンテンツ)
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Blob

Binary (バイナリ)

Base64 でエンコードされていない未加工のリソースコンテンツ。

x

Uri

String (文字列)

リソース URI。

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

### [](#TextResource)テキストリソース
項目 型 説明 デフォルト値 必須

Text (テキスト)

String (文字列)

テキストコンテンツ。

x

### [](#BlobResource)Blob リソース
項目 型 説明 デフォルト値 必須

Blob

Binary (バイナリ)

Base64 でエンコードされていない未加工のリソースコンテンツ。

x

## [](#関連情報)関連情報 - [Using Anypoint Code Builder to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb) - [Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [MCP Connector の概要](https://docs.mulesoft.com/jp/mcp-connector/0.1/) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.0 MCP 用 Anypoint Connector (MCP Connector) では、Model Context Protocol (MCP) を使用して、MCP をサポートする AI クライアントが API、コネクタ、アプリケーションを呼び出して、それらと通信できるようにします。 MCP Connector を使用して LLM アプリケーションを API に接続します。複雑なエンドポイントを持つ API を、エージェントクライアントに適した簡単かつアトミックなツールまたはリソースとして公開します。エージェントのアクションにとって何が簡単で、繰り返し可能で、最適であるかを決定し、そこから始めます。 MCP は、LLM アプリケーションと外部データ、サービス、およびツール間のインテグレーションを可能にするオープンプロトコルです。 MCP プロトコル: - AI に関連情報を提供することで AI の精度を強化し、応答の正確さを向上します。 - 外部データまたはサービスへのアクセスを必要とする複雑なタスクを AI が管理できるようにします。 - AI モデルと外部システム間の相互運用性を促進し、ワークフローへの統合を簡略化します。 MCP Connector: - MCP プロトコルを使用して Mule アプリケーション、コネクタ、カスタム API を公開し、さらに Claude、Cursor、Windsurf のエージェントや独自のエージェントからのエージェント環境を有効にすることができます。 - MCP サーバーとクライアントの両方の機能を果たすことができる Mule アプリケーションを作成できます。結果の MCP サーバーまたはクライアントは Mule の内部で実行されます。つまり、独自のホスト環境を設定する必要はありません。 - MCP サーバーとして機能する場合、Mule を使用すると、AI クライアントで、MCP をネイティブにサポートしない既存の API 主導の投資、従来のシステム、SaaS アプリケーションを使用できます、 - MCP クライアントとして機能する場合、Mule は、AI エージェントがワークフロー内で単に別のシステムとして追加される接続とオーケストレーションを作成するのに役立ちます。 - Mule をオーケストレーションレイヤーとして使用することで、AI エージェントを既存のエンタープライズエコシステムに組み込むことができます。 - サーバー用とクライアント用の両方の Streamable HTTP (推奨) と、SSE (サーバー用とクライアント用の両方) ​[トランスポート方式](#connection-types)​をサポートします。 - `/sse`​、​`/messages`​、​`/mcp`​ を含め、すべての公開されたエンドポイントでカスタムレスポンスヘッダーをサポートします。カスタムレスポンスヘッダーを使用して、セキュリティ、運用、インテグレーション、ガバナンスのメリットを得ます。 これにより、増大している AI エージェントエコシステムで Mule API とアプリケーションの機能を使用できます。 互換性と修正された問題については、「MCP Connector リリースノート」を参照してください。 ## [](#prerequisites)始める前に このコネクタを使用するには、以下に精通している必要があります。 - Anypoint Connector - Mule Runtime Engine (Mule) - Mule フローの要素とグローバル要素 - Anypoint Code Builder または Anypoint Studio を使用して Mule アプリケーションを作成する方法 アプリケーションを作成する前に、以下が必要です。 - Java 17 - Apache Maven - Anypoint Platform - 対象リソースに接続するためのログイン情報 - Anypoint Code Builder または Anypoint Studio の最新バージョン ## [](#use-cases)コネクタの一般的なユースケース 次に、コネクタの一般的なユースケースを示します。 - カスタマーサービス AI エージェントを使用して、時間のかかるタスク (ケース履歴の確認、報告された問題の分析、関連情報の取得など) を処理することで、人間のエージェントの効率を高めます。 - セールス プロスペクトの調査を加速し、カスタマイズした資料を生成し、契約書を作成することで、営業チームの成功を促進します。 - マーケティング ソーシャルメディアコンテンツのドラフトの作成、市場調査の実施、キャンペーンパフォーマンスの分析に AI 主導のサポートを提供することでマーケティングチームを強化します。 ## [](#connection-types)接続種別 - Streamable HTTP クライアントが個々のサーバー URL を認識することなく、MCP サーバーの複数のインスタンスをロードバランサーの背後で実行するようにデプロイできます。クライアントは 1 つのエンドポイント (​`/mcp`​ など) に接続され、ロードバランサーは要求をすべての MCP サーバーインスタンスに分散します。これは、Mule アプリケーションの複数のレプリカを実行する可能性があるクラウド環境の拡張性を確保するうえで特に役立ちます。 MCP クライアントとして機能する場合、Streamable HTTP を使用すると、Mule アプリケーションは、拡張性の高い同じ負荷分散方法を使用してリモート MCP サーバーに接続できます。 - SSE クライアント サーバー送信イベント (SSE) 標準を使用して、MCP Connector が MCP サーバーへの永続的な一方向 (サーバー送信) 接続を確立できるようにします。この種別の接続を使用すると、MCP サーバーはリアルタイム更新およびメッセージをクライアントにプッシュすることができ、クライアントは新しい情報を常にポーリングする必要がなくなります。 - SSE Server サーバー送信イベント (SSE) トランスポートを使用して、MCP サーバーを公開します。これにより、MCP クライアントはこのサーバーへの永続的な一方向接続を確立し、リアルタイム更新およびメッセージを受信できます。 ### [](#streamable-http-の制限)Streamable HTTP の制限 Streamable HTTP 接続種別では以下はサポートされません。 - 通知を取得するために GET ​`/mcp`​ エンドポイントをコールする - 再開可能性と再配信 ## [](#次のステップ)次のステップ Unresolved include directive in modules/ROOT/pages/index.adoc - include::connectors::partial$t-index-partial.adoc\[\] ## [](#関連情報)関連情報 - [Anypoint Connectors Overview](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Using Anypoint Code Builder to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb) - [Using Anypoint Studio to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-reference) - [MuleSoft MCP サポート: Model Context Protocol の使用開始](https://blogs.mulesoft.com/news/model-context-protocol/) - [Model Context Protocol](https://modelcontextprotocol.io/introduction) - [HTTP With SSE](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#http-with-sse) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.0 - MCP サーバーへのセキュリティの適用 MCP Connector により MCP クライアントのサーバー側認証が可能になります。これらの例では、ステートフルなサーバー送信イベント (SSE) 接続と ​**On New Session Listener**​ ソースを使用して、OAuth アクセストークンの検証を含むカスタムセキュリティロジックを実装します。 ## [](#on-new-session-listener-を使用したサーバー側認証)On New Session Listener を使用したサーバー側認証 MCP 仕様ではセッション管理を強調し、SSE 接続では状態を維持します。​**On New Session Listener**​ ソースでは、サーバー側認証を実装するための重要なポイントが提供されます。この例は、このリスナーでトリガーされる基本フローを示しており、自動生成された ​`sessionId`​ と、接続しているクライアントにより送信された HTTP ヘッダーへのアクセス方法を示しています。これらはその後、カスタム認証ロジックで使用できます。 これは、​**On New Session Listener**​ ソースを使用するサンプルフローです。 ```xml ``` このフローは、新しいクライアントが MCP サーバーアプリケーションに接続するたびに実行されます。ペイロードには自動生成された ​`sessionId`​ と ​`additionalProperties`​ が含まれています。SSE 接続種別を使用する場合、これらは HTTP リクエストヘッダーにマッピングされます。 この時点で独自の認証ロジックを実装できます。たとえば、​`#[payload.additionalProperties.authorization]`​ 式で HTTP 認証ヘッダーを取得し、後で検証することができます。 ### [](#oauth-アクセストークンの検証)OAuth アクセストークンの検証 必要に応じて、​[Mule OAuth 2.0 プロバイダー](https://docs.mulesoft.com/jp/api-manager/latest/mule-oauth-provider-landing-page)​を使用して、OAuth アクセストークンの実装と検証を行うことができます。 このサンプルフローでは、OAuth プロバイダーを使用してアクセストークンが検証され、トークンが無効な場合はセッションが拒否されます。 ```xml ``` 次のいずれかに該当する場合、新しいセッションは拒否されます。 - `rejectWithStatusCode`​ パラメーターに null 以外の値 (または null 以外の値に解決する式) が割り当てられている、または - フローが失敗した場合、状況コード 500 が報告される この例では、状況コードが ​`401 - UNAUTHORIZED`​ コードにマッピングされるように OAuth 検証エラーが処理されます。 ## [](#クライアント側認証)クライアント側認証 クライアントでは、認証パラメーターは、HTTP Connector と ​[OAuth Module](https://docs.mulesoft.com/jp/oauth-module/latest/)​ (これもプロジェクトに追加されている場合) で定義されたすべての認証戦略を受け入れます。 **Call Tool**​ などの操作は追加のプロパティも受け入れます。SSE の場合、このプロパティはリクエストヘッダーにマッピングされます。これにより、API キーなどのカスタム認証ヘッダーを追加することができます。次に例を示します。 ```xml ``` ## [](#次のステップ)次のステップ コネクタを設定したら、​[例](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-examples)​を試すことができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.0 - 例 既存の API を使用して、MCP Connector を使用してエージェントを作成する方法の例を次にいくつか示します。 ## [](#mcp-サーバーとツールの作成)MCP サーバーとツールの作成 これらの例は、Mule アプリケーション内で MCP サーバーを作成し、MCP サーバーで公開される 2 つの個別のツールを定義するプロセスを示しています。1 つは、承認済みベンダーの動的リストを各ベンダーの商品カテゴリとともに取得するツールで、もう 1 つは、指定された詳細で購入注文の作成を開始するツールです。 これらの例は、MCP ツールの概念を呼び出し可能なリモートプロシージャーコール (RPC) として示しています。 ### [](#mcp-サーバー設定の作成)MCP サーバー設定の作成 この例は、Streamable HTTP トランスポートを使用して Mule アプリケーション内で MCP サーバーを設定する方法を示しています。MCP クライアントとして機能する場合、MuleSoft では、AI エージェントがワークフロー内で単に別のシステムとして統合されるインテグレーションとオーケストレーションを容易に作成できます。 ```xml <<1>> <<2>> <<3>> <<4>> ```
1HTTP リスナー設定では、MCP サーバーが公開されるエンドポイントを定義します。
2MCP サーバー設定では、Streamable HTTP トランスポートを使用します。
3ヘッダーは、バージョン追跡とサーバー識別用にすべての応答に追加されます。
4さまざまな環境をサポートするためにプロパティプレースホルダーが設定値で使用されます。
### [](#ベンダーのリストを提供するツールの作成)ベンダーのリストを提供するツールの作成 この例は、外部システム (この例では SAP Concur) から承認済みベンダーの動的リストを取得する MCP ツールを作成する方法を示しています.この例は、​``​ を使用してコール可能なツールを定義する方法と、データを処理し、​`Custom19`​ 項目からの割り当て済み商品カテゴリを含め、関連ベンダー情報をエージェントに提供する方法を示しています。 まず、再試行およびタイムアウト設定を使用して SAP Concur 設定を定義します。 ```xml <<1>> <<2>> 30 <<3>> SECONDS <<4>> 3600000 MILLISECONDS ```
1SAP Concur 設定には、OAuth 認証設定が含まれます。
2一時的な接続の問題を処理するために再接続戦略を設定します。
3要求タイムアウトは、要求がハングしないように 30 秒に設定します。
4キャッシュ設定を追加して、1 時間の TTL でパフォーマンスを向上します。
次に、ページネーションとキャッシュを使用してベンダーの取得を処理するメインフローを作成します。 ```xml <<1>> Get all approved vendors with optional pagination > "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "pageSize": { "type": "integer", "description": "Number of vendors to return per page", "minimum": 1, "maximum": 100, "default": 50 }, "pageNumber": { "type": "integer", "description": "Page number to retrieve", "minimum": 1, "default": 1 } }, "required": [] }]]> <<3>> <<4>> <<5>> ```
1<mcp:tool-listener>​ では、ページネーションをサポートするベンダー取得ツールのインターフェースを定義します。
2<mcp:parameters-schema>​ スキーマには、ページサイズとページ番号の検証が含まれます。
3キャッシュコンポーネントは、結果を 1 時間保存することでパフォーマンスを向上します。
4DataWeave 変換では、承認されたベンダーを絞り込み、ページネーションメタデータを追加します。
5エラー処理では、接続エラー、認証エラー、予期しないエラーが対象となります。
### [](#購入注文を作成するツールの作成)購入注文を作成するツールの作成 この例は、エージェントが SAP Concur で購入注文の作成を開始するために使用できる MCP ツールの作成方法を示しています。この例では、JSON スキーマを使用してツールの入力パラメーターを定義する方法が強調されています。パラメーターごとに自然言語の説明が含まれており、これにより LLM は必要な情報を理解して入力することができます。 ```xml <<1>> Create a new purchase order in SAP Concur with validation > "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "name": { "type": "string", "description": "Name for the purchase order.", "minLength": 1, "maxLength": 100 }, "description": { "type": "string", "description": "Purchase order description.", "minLength": 1, "maxLength": 500 }, "vendorCode": { "type": "string", "description": "Code that identifies the vendor.", "pattern": "^[A-Z0-9]{3,10}$" }, "itemDescription": { "type": "string", "description": "Description of the item purchased in this order.", "minLength": 1, "maxLength": 200 }, "price": { "type": "number", "description": "Monetary amount of the purchase order.", "minimum": 0.01, "maximum": 999999.99 }, "currency": { "type": "string", "description": "Currency code for the purchase order monetary amount.", "pattern": "^[A-Z]{3}$" } }, "required": ["name", "description", "vendorCode", "itemDescription", "price", "currency"] }]]> <<3>> <<4>> <<5>> ```
1Tool Listener では、包括的な入力規則を含む購入注文作成インターフェースを定義します。
2パラメータースキーマには、長さ制限やパターンなど、すべての項目の入力規則が含まれます。
3ベンダー存在チェックが購入注文の作成前に実行されます。
4DataWeave 変換ではベンダーチェックの応答を検証します。
5エラー処理では、接続エラー、認証エラー、検証エラー、予期しないエラーが対象となります。
## [](#サードパーティ-mcp-サーバーを使用する-mcp-クライアントの設定)サードパーティ MCP サーバーを使用する MCP クライアントの設定 前の例では、既存の Anypoint Connector から情報を取得するツールの作成方法が示されました。ここでは、サードパーティ MCP サーバーを使用する方法を見てみましょう。 ### [](#複数の-mcp-サーバーを使用した天気サービスの作成)複数の MCP サーバーを使用した天気サービスの作成 この例は、MCP クライアントを設定し、​**Call Tool**​ 操作を使用することで、Streamable HTTP トランスポートを使用して Mule アプリケーションを既存のサードパーティ MCP サーバーと統合する方法を示しています。

サードパーティ MCP サーバーに接続する場合、その MCP サーバーで Streamable HTTP トランスポートがサポートされることを確認してください。サードパーティサーバーで SSE トランスポートのみがサポートされる場合、SSE クライアント接続を使用するか、サービスプロバイダーに連絡して Streamable HTTP についてのサポートを受ける必要があります。

まず、タイムアウトおよび再試行設定を使用してクライアント設定を定義します。 ```xml <<1>> 30 SECONDS <<2>> <<3>> ```
1HTTP 要求の設定には、天気 API のタイムアウト設定と再試行設定が含まれます。
2Google マップ MCP クライアントの設定では、カスタムヘッダーと再接続設定と共に Streamable HTTP トランスポートを使用します。
3天気 MCP サーバーの設定では、Streamable HTTP トランスポートを使用し、カスタムヘッダーを使用して天気サービスエンドポイントを公開します。
次に、エラー処理とキャッシュを含む天気サービスフローを作成します。 ```xml <<1>> 900000 MILLISECONDS <<2>> Provides the weather at given coordinates expressed as latitude and longitude <<3>> <<4>> Provides the weather at a specific address <<5>> ```
1 キャッシュ設定では、API コールを減らすために天気データを 15 分保存します。
2 座標ベースの天気フローには、入力規則とキャッシュが含まれます。
3 住所ベースの天気フローではツールの構成が示されています。
  • まず、Google マップを使用して住所を座標に変換します。

  • 次に、その座標を使用して天気を取得します。

4 両方のフローに、さまざまなシナリオの包括的なエラー処理が含まれます。
5 DataWeave 変換では、続行する前に Google マップの応答を検証します。
LLM でこれらのツールを直接オーケストレーションできますが、Mule での手動構成が望まれる次のような場合もあります。 - すべての MCP サーバーへの保証されたアクセスが必要な場合 - 認証をセキュアに処理する必要がある場合 - 強力なガバナンス機能とトレース機能が必要な場合 ## [](#関連情報)関連情報 - [MCP サーバーへのセキュリティの適用](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-config-topics) - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-reference) - [MuleSoft MCP サポート: Model Context Protocol の使用開始](https://blogs.mulesoft.com/news/model-context-protocol/) - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.0 XML と Maven のサポート Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#コネクタの名前空間の追加)コネクタの名前空間の追加 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#次のステップ)次のステップ Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] # MCP Connector 1.0 リファレンス MCP 用 Anypoint Connector (MCP Connector) を使用すると、Mule アプリケーションは MCP サーバーとクライアントの両方の機能を果たすことができます。MCP クライアントとして機能する場合、MuleSoft では、AI エージェントがワークフロー内で単に別のシステムとして統合されるインテグレーションとオーケストレーションを容易に作成できます。 ## [](#設定)設定 ### [](#Client)クライアント クライアントとして機能し、MCP サーバーに接続される設定要素。 #### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

はい

Connection (接続)

この設定に指定する接続型。

はい

Client Name (クライアント名)

String (文字列)

プロトコル初期化フェーズ中にクライアントが自身を識別するために使用する名前。これは、この設定要素に指定される名前 (後で config-ref パラメーターを介して参照される) とは異なります。この名前は一意である必要はありません。

はい

Client Version (クライアントバージョン)

String (文字列)

プロトコル初期化フェーズ中にクライアントが自身を識別するために使用するバージョン。これは、コネクタまたは Mule アプリケーションのバージョンに一致する必要はありません。

はい

Name (名前)

String (文字列)

この設定の参照に使用される ID。

はい

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

#### [](#接続種別)接続種別 ##### [](#Client_SseClient)SSE クライアント Streamable HTTP トランスポートをお勧めします。 SSE (サーバー送信イベント) クライアント接続種別を使用すると、SSE 標準を使用して、MCP Connector が MCP サーバーへの永続的な一方向 (サーバー送信) 接続を確立できます。この種別の接続を使用すると、MCP サーバーはリアルタイム更新およびメッセージをクライアントにプッシュすることができ、クライアントは新しい情報を常にポーリングする必要がなくなります。 ###### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

要求がタイムアウトする前に、サーバーの応答を待機する期間を設定します。

30

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

requestTimeout パラメーターの時間単位

SECONDS

Authentication (認証)

HttpRequestAuthentication

Server Url (サーバー URL)

String (文字列)

対象 MCP サーバーのベース URL

はい

Sse Endpoint Path (SSE エンドポイントパス)

String (文字列)

/sse

Reconnection Delay (再接続遅延)

Number (数値)

SSE 接続がタイムアウトまたは終了した場合に SSE 接続を再初期化するまで待機する時間を指定します。

500

Reconnection Delay Unit (再接続遅延単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

reconnectionDelay パラメーターの時間単位

MILLISECONDS

Tls Context (TLS コンテキスト)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

##### [](#Client_StreamableHttpClient)Streamable HTTP クライアント ###### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

要求がタイムアウトする前に、サーバーの応答を待機する期間を設定します。

30

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

requestTimeout パラメーターの時間単位

SECONDS

Authentication (認証)

HttpRequestAuthentication

Server Url (サーバー URL)

String (文字列)

対象 MCP サーバーのベース URL

はい

Mcp Endpoint Path (MCP エンドポイントパス)

String (文字列)

/mcp

Tls Context (TLS コンテキスト)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

## [](#サポートされている操作)サポートされている操作 - [MCP Client - Call Tool](#CallTool)​ - [MCP Client - List Resources](#ListResources)​ - [MCP Client - List Tools](#ListTools)​ - [MCP Client - Ping](#Ping)​ - [MCP Client - Read Resource](#ReadResource)​ ### [](#Server)サーバー MCP サーバーとして機能する設定要素。 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

はい

Connection (接続)

この設定に指定する接続型。

はい

Server Name (サーバー名)

String (文字列)

プロトコル初期化フェーズ中にこのサーバーが自身を識別するために使用する名前。これは、この設定要素に指定される名前 (後で config-ref パラメーターを介して参照される) とは異なります。この名前は一意である必要はありません。

はい

Server Version (サーバーバージョン)

String (文字列)

プロトコル初期化フェーズ中にこのサーバーが自身を識別するために使用するバージョン。これは、コネクタまたは Mule アプリケーションのバージョンに一致する必要はありません。

はい

Name (名前)

String (文字列)

この設定の参照に使用される ID。

はい

#### [](#接続種別-2)接続種別 ##### [](#Server_SseServer)SSE Server [「HTTP with SSE」](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#http-with-sse)​で定義されているとおりに、SSE トランスポートを使用して、MCP サーバーを公開します。 ###### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

Request Timeout (要求タイムアウト)

10

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

Request Timeout unit (要求タイムアウト単位)

SECONDS

Listener Config (リスナー設定)

String (文字列)

SSE とメッセージングエンドポイントを公開するために使用する HTTP リスナー設定への参照。

はい

Sse Endpoint Path (SSE エンドポイントパス)

String (文字列)

クライアントが SSE 接続を開始するために使用するエンドポイントパス。

/sse

Messages Path (メッセージパス)

String (文字列)

メッセージングエンドポイント要求の送信先のパス。

/message

Default Sse Response Headers (デフォルト SSE レスポンスヘッダー)

Object (オブジェクト)

Default Message Response Headers (デフォルトメッセージレスポンスヘッダー)

Object (オブジェクト)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

##### [](#Server_StreamableHttpServer)Streamable HTTP サーバー [「Streamable HTTP」](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)​で定義されているとおりに、Streamable HTTP トランスポートを使用して、MCP サーバーを公開します。 ###### [](#パラメーター-6)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

Request Timeout (要求タイムアウト)

10

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

Request Timeout unit (要求タイムアウト単位)

SECONDS

Listener Config (リスナー設定)

String (文字列)

SSE とメッセージングエンドポイントを公開するために使用する http:listener-config への参照。

はい

Mcp Endpoint Path (MCP エンドポイントパス)

String (文字列)

クライアントが SSE 接続を開始するために使用するエンドポイントパス

/mcp

Response Content Type (応答コンテンツタイプ)

Enumeration (列挙)。次のいずれかになります。

  • JSON

  • SSE

SSE ストリームの開始により応答を送信するか、1 つの application/json ボディの戻りにより応答を送信するか。

SSE

Default Response Headers (デフォルトレスポンスヘッダー)

Object (オブジェクト)

すべての有効な応答に含めるカスタムヘッダー (拒否された無効な要求は含めません)。

Session Idle Timeout (セッションアイドルタイムアウト)

Number (数値)

アイドルセッションのタイムアウト

5

Session Idle Timeout Unit (セッションアイドルタイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

sessionIdleTimeout を評価する時間単位。

MINUTES

Sessions Object Store (セッションオブジェクトストア)

ObjectStore

セッション情報を保存するために使用する ObjectStore。複数のレプリカにデプロイする場合、Hazelcast または OSv2 のいずれかを介してすべてのレプリカに分散される特定のオブジェクトストアを定義することをお勧めします。指定しない場合、デフォルトの一時的なインスタンスが作成されます。

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

## [](#関連付けられたソース)関連付けられたソース - [MCP Server - On New Session Listener](#OnNewSessionListener)​ - [MCP Server - Resource listener](#ResourceListener)​ - [MCP Server - Tool Listener](#ToolListener)​ ## [](#操作)操作 ## [](#CallTool)MCP Client - Call Tool `` リモート MCP サーバー内でツールを呼び出します。 ### [](#パラメーター-7)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Tool Name (ツール名)

String (文字列)

呼び出すツールの名前。

はい

Arguments (引数)

Object (オブジェクト)

ツールの入力引数。

#[payload]

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

#[null]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力)出力

型

Call Tool Response (Call Tool 応答)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:JSON\_RPC\_ERROR​ - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#ListResources)MCP Client - List Resources `` リモート MCP サーバー内のすべての使用可能なリソースをリストします。 ### [](#パラメーター-8)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。反復可能ストリームは、デフォルトの動作です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-2)出力

型

Resource Metadata (リソースメタデータ)​ の配列

### [](#次の設定の場合-2)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-2)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:INVALID\_URI​ - MCP:JSON\_RPC\_ERROR​ - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#ListTools)MCP Client - List Tools `` リモート MCP サーバー内のすべての使用可能なツールをリストします。 ### [](#パラメーター-9)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。反復可能ストリームは、デフォルトの動作です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-3)出力

型

Tool Metadata (ツールメタデータ)​ の配列

### [](#次の設定の場合-3)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-3)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:JSON\_RPC\_ERROR​ - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#Ping)MCP Client - Ping `` リモートサーバーを ping します。 ### [](#パラメーター-10)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-4)出力

型

Any (任意)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合-4)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-4)スロー - MCP:CONNECTIVITY - MCP:RETRY\_EXHAUSTED​ ## [](#ReadResource)MCP Client - Read Resource `` URI で参照されるリソースを読み取ります。 ### [](#パラメーター-11)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Uri

String (文字列)

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

#[null]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-5)出力

型

Resource Content (リソースコンテンツ)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合-5)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-5)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:INVALID\_URI​ - MCP:JSON\_RPC\_ERROR - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#ソース)ソース ## [](#OnNewSessionListener)MCP Server - On New Session Listener `` ### [](#パラメーター-12)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reject With Status Code (状況コード付き拒否)

Number (数値)

Reject With Message (メッセージ付き拒否)

String (文字列)

### [](#出力-6)出力

型

New Session Request (新規セッション要求)

### [](#次の設定の場合-6)次の設定の場合 - [サーバー](#Server)​ ## [](#ResourceListener)MCP Server - Resource listener `` 所有フローの実行によりコンテンツが生成されたリソースを公開します。このフローは、受信したリソース/読み取り要求ごとに実行されます。ユーザーは、リソースコンテンツが静的になるようにフローを実装するか、リソースコンテンツを動的にするかを選択できます。たとえば、動的リソースには、実際はライブ DB クエリの実行結果である expenses.csv ファイルを使用できます。また、静的リソースには、Amazon S3 を介して取得され、​`ee:cache`​ コンポーネントを使用してローカルにキャッシュされたファイルを使用できます。 ### [](#パラメーター-13)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Name (名前)

String (文字列)

リソースの名前。

はい

Description (説明)

String (文字列)

このリソースを読み取るタイミングを LLM が判断するのに十分な詳細な説明。

はい

Uri

String (文字列)

リソース URI。

はい

Resource Mime Type (リソースの MIME タイプ)

String (文字列)

リソースの MIME タイプ。

はい

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Resource Listener

次のいずれかになります。

リソースのコンテンツと種別を定義します。これらのパラメーターは、フローが正常に完了した場合 (ペイロードと変数が使用可能な場合) に評価されます。

はい

### [](#出力-7)出力

型

Resource Request (リソース要求)

Attributes Type (属性型)

### [](#次の設定の場合-7)次の設定の場合 - [サーバー](#Server)​ ## [](#ToolListener)MCP Server - Tool Listener `` 所有フローの実行により結果が生成されたツールを公開します。このフローは、受信したツール/コール要求ごとに実行されます。トリガーされると、フローは、入力引数を保持する Java マップがペイロードとなっているメッセージを使用して実行されます。ツールの応答は、フローが正常に完了するかエラーで完了した場合に生成されます。いずれの場合も、応答には種別が異なるいくつかのコンテンツ項目が含まれている可能性があります。エラー応答が定義されていない場合、エラーの説明を含むテキストコンテンツ項目が自動的に生成されます。 ### [](#パラメーター-14)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Name (名前)

String (文字列)

ツールの名前

はい

Description (説明)

String (文字列)

このツールをコールするタイミングを LLM が判断するのに十分な詳細な説明。

はい

Parameters Schema (パラメータースキーマ)

String (文字列)

項目がツールの入力引数として機能するオブジェクトを定義する JSON スキーマ

はい

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Responses (応答)

フローが正常に完了した場合の応答項目。

はい

On Error Responses (エラー時の応答)

フローがエラーで完了した場合のコンテンツ項目。

### [](#出力-8)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request Attributes (要求属性)

### [](#次の設定の場合-8)次の設定の場合 - [サーバー](#Server)​ ## [](#型)型 ### [](#Tls)TLS Mule アプリケーションのセキュアな通信を提供するように TLS を設定します。
項目 型 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

TLS トラストストアを設定します。

Key Store (キーストア)

TLS キーストアを設定します。

Revocation Check (取り消し確認)

取り消し確認メカニズムを設定します。

### [](#TrustStore)Truststore (トラストストア) TLS 用のトラストストアを設定します。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

ストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用する暗号化アルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、Mule では証明書の検証の実行を停止します。これを ​true​ に設定すると、接続が攻撃に対して脆弱になる可能性があります。

### [](#KeyStore)Keystore (キーストア) TLS プロトコル用のキーストアを設定します。生成したキーストアには、非公開鍵と公開証明書が格納されます。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Type (型)

String (文字列)

ストアの型。

Alias (別名)

String (文字列)

キーストアに複数の非公開キーが含まれている場合に使用するキーの別名。デフォルトでは、Mule はファイル内の最初のキーを使用します。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用する暗号化アルゴリズム。

### [](#StandardRevocationCheck)Standard Revocation Check (標準の取り消し確認) TLS 証明書の標準取り消し確認を設定します。
項目 型 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーン内で確認する要素:

  • true​

証明書チェーンの最後の要素のみを確認します。

  • false​

証明書チェーンのすべての要素を確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

証明書の有効性を確認する方法:

  • true​

証明書失効リスト (CRL) で証明書の有効性を確認します。

  • false​

オンライン証明書状況プロトコル (OCSP) を使用して証明書の有効性を確認します。

No Fallback (代替なし)

Boolean (ブール)

証明書の有効性を確認するための第 2 の方法を使用するかどうか:

  • true​

[Prefer Crls (CRL を優先)]​ 項目で指定されていない方法 (第 2 の方法) を使用して証明書の有効性を確認します。

  • false​

証明書の有効性を確認するための第 2 の方法を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合の処理:

  • true​

検証エラーを回避します。

  • false​

検証の失敗を許可します。

### [](#CustomOcspResponder)Custom OCSP Responder (カスタム OCSP レスポンダー) 証明書の取り消し確認のカスタム OCSP レスポンダーを設定します。
項目 型 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

OCSP 応答の署名証明書の別名。指定した場合、別名はトラストストアに存在する必要があります。

### [](#CrlFile)CRL File (CRL ファイル) 証明書失効リスト (CRL) ファイルの場所を指定します。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。

### [](#reconnection-再接続)Reconnection (再接続) 操作の再接続戦略を設定します。
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイメントに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

### [](#reconnect-再接続)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#ReconnectForever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー) 有効期限ポリシー戦略を設定します。
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

動的設定インスタンスがアイドル状態を続けられる最大時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ 項目の時間単位。

### [](#CallToolResponse)Call Tool Response (Call Tool 応答) クライアントとしてのツールのコールから取得した応答。
項目 型 説明 デフォルト値 必須

Content (コンテンツ)

ツールにより生成されたコンテンツ

はい

Error (エラー)

Boolean (ブール)

ツールの実行が成功したか、エラーになったか。エラーの場合でもコンテンツが生成されることがあります。

false

### [](#CallToolResponseContent)Call Tool Response Content (Call Tool 応答コンテンツ)
項目 型 説明 デフォルト値 必須

Type (型)

Enumeration (列挙)。次のいずれかになります。

  • text (テキスト)

  • Image (画像)

  • resource (リソース)

コンテンツタイプ。

はい

Text (テキスト)

String (文字列)

型が ​text (テキスト)​ の場合のコンテンツのペイロード。

Mime Type (MIME タイプ)

String (文字列)

コンテンツの MIME タイプ。

Data (データ)

Binary (バイナリ)

型が ​image (画像)​ の場合のコンテンツのペイロード。

Resource (リソース)

型が ​resource (リソース)​ の場合のコンテンツのペイロード。

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

### [](#ResourceContent)Resource Content (リソースコンテンツ) リソースコンテンツのフラット化表現。リソースには、text (テキスト) または blob 型を使用できます。テキストリソースではテキストプロパティが設定され、後者では blob 型が使用されます。
項目 型 説明 デフォルト値 必須

Uri

String (文字列)

リソース URI

はい

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

はい

Text (テキスト)

String (文字列)

テキストリソースのコンテンツ。BLOB データ型の場合は null。

Blob

Binary (バイナリ)

BLOB リソースのコンテンツ。テキストデータ型の場合は null。

### [](#ErrorMapping)エラーのマッピング
項目 型 説明 デフォルト値 必須

Source (ソース)

Enumeration (列挙)。次のいずれかになります。

  • ANY

  • REDELIVERY_EXHAUSTED​

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY​

  • SERVER_SECURITY​

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED​

  • TIMEOUT

変換先

String (文字列)

はい

### [](#ResourceMetadata)Resource Metadata (リソースメタデータ)
項目 型 説明 デフォルト値 必須

Uri

String (文字列)

リソース URI。

はい

Name (名前)

String (文字列)

リソースの名前。

はい

Description (説明)

String (文字列)

リソースの説明。

はい

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

はい

### [](#RepeatableInMemoryIterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームをコンシュームしてランダムにアクセスするために割り当てられるメモリ量。ストリームのデータ量がこのバッファサイズを超える場合は、[Buffer Size Increment (バッファサイズ増分)] 値に従って、[Max In Memory Size (最大メモリ内サイズ)] 値を上限としてバッファが拡張されます。

100

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、拡張する量。値を ​0​ またはそれ以下に設定すると、バッファは拡張されません。

100

Max Buffer Size (最大バッファサイズ)

Number (数値)

バッファの最大サイズ。バッファサイズがこの値を超える場合、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。​0​ 以下の値は無制限を意味します。

### [](#RepeatableFileStoreIterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)
項目 型 説明 デフォルト値 必須

In Memory Objects (メモリ内オブジェクト)

Number (数値)

メモリ内に保持されるインスタンスの最大数。この最大数を超えるインスタンスが必要な場合、ディスク上のコンテンツがバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE

  • KB

  • MB

  • GB

[In Memory Objects (メモリ内オブジェクト)]​ 項目の単位。

### [](#ToolMetadata)Tool Metadata (ツールメタデータ) ツールをそのプロパティを介して説明します。
項目 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

ツールの名前。

はい

Description (説明)

String (文字列)

このツールをコールするタイミングを LLM が判断するのに十分な詳細な説明。

はい

Input Schema (入力スキーマ)

String (文字列)

ツールの入力パラメーターを説明する JSON スキーマ。

はい

### [](#NewSessionRequest)New Session Request (新規セッション要求) 新規サーバーセッションの作成を要求するクライアントに関連付けられたデータが含まれます。
項目 型 説明 デフォルト値 必須

Session Id (セッション ID)

String (文字列)

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

はい

Client Certificate (クライアント証明書)

### [](#CertificateData)Certificate Data (証明書データ)
項目 型 説明 デフォルト値 必須

Basic Constraints (基本制約)

Number (数値)

Critical Extension OIDs (重要な拡張機能 OID)

Array of String (文字列の配列)

Encoded (エンコード)

Binary (バイナリ)

Extended Key Usage (拡張キー使用)

Array of String (文字列の配列)

Extensions (拡張機能)

Issuer Alternative Names (発行者別名)

Issuer DN (発行者 DN)

Issuer Unique ID (発行者の一意の ID)

Boolean (ブール) の配列

Issuer X500 Principal (発行者 X500 プリンシパル)

Key Usage (キー使用)

Boolean (ブール) の配列

Name (名前)

String (文字列)

Non Critical Extension OIDs (重要でない拡張機能 OID)

Array of String (文字列の配列)

Not After (以前)

Date (日付)

Not Before (以降)

Date (日付)

Public Key (公開キー)

Serial Number (シリアル番号)

Number (数値)

Serial Number Object (シリアル番号オブジェクト)

Sig Alg Name (署名アルゴリズム名)

String (文字列)

Sig Alg OID (署名アルゴリズム OID)

String (文字列)

Sig Alg Params (署名アルゴリズムパラメーター)

Binary (バイナリ)

Signature (署名)

Binary (バイナリ)

Subject Alternative Names (サブジェクトの別名)

Subject DN (サブジェクト DN)

Subject X500 Principal (サブジェクト X500 プリンシパル)

Type (型)

String (文字列)

バージョン

Number (数値)

### [](#CertificateExtension)Certificate Extension (証明書拡張機能)
項目 型 説明 デフォルト値 必須

Criticality (重要性)

Boolean (ブール)

OID

String (文字列)

Value (値)

Binary (バイナリ)

### [](#AlternativeNameData)Alternative Name Data (別名データ)
項目 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

Type (型)

Number (数値)

### [](#PrincipalData)Principal Data (プリンシパルデータ)
項目 型 説明 デフォルト値 必須

Common Name (一般名)

String (文字列)

Name (名前)

String (文字列)

### [](#X500PrincipalData)X500 Principal Data (X500 プリンシパルデータ)
項目 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

### [](#PublicKeyData)Public Key Data (公開キーデータ)
項目 型 説明 デフォルト値 必須

Algorithm (アルゴリズム)

String (文字列)

Encoded (エンコード)

Binary (バイナリ)

Modulus (モジュール)

Number (数値)

Params (パラメーター)

Number (数値)

Public Key (公開キー)

String (文字列)

### [](#SerialNumberData)Serial Number Data (シリアル番号データ)
項目 型 説明 デフォルト値 必須

Serial Number (シリアル番号)

Number (数値)

### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー) エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。
項目 型 説明 デフォルト値 必須

Max Redelivery Count (最大再配信数)

Number (数値)

REDELIVERY_EXHAUSTED​ エラーが返されるまでに、再配信された要求が処理に失敗できる最大回数。

Message Digest Algorithm (メッセージダイジェストアルゴリズム)

String (文字列)

[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​true​ の場合に使用するセキュアハッシュアルゴリズム。メッセージのペイロードが Java オブジェクトの場合、Mule ではこの値が無視され、ペイロードの ​hashCode()​ が返した値が返されます。

Message Identifier (メッセージ識別子)

メッセージが再配信されたかどうかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。

Object Store (オブジェクトストア)

ObjectStore

各メッセージの再配信カウンターが保存されるオブジェクトストアを設定します。

### [](#RedeliveryPolicyMessageIdentifier)Redelivery Policy Message Identifier (再配信ポリシーメッセージ識別子) 再配信されたメッセージを識別する方法と、メッセージがいつ再配信されたのかを見つける方法を設定します。
項目 型 説明 デフォルト値 必須

Use Secure Hash (セキュアハッシュを使用)

Boolean (ブール)

true​ の場合、再配信されたメッセージの識別にセキュアハッシュアルゴリズムが使用されます。

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。

### [](#ResourceRequest)Resource Request (リソース要求) リソースのインバウンド要求。コネクタが MCP サーバーとして機能している場合に使用されます。
項目 型 説明 デフォルト値 必須

Requested Uri (要求済み URI)

String (文字列)

はい

### [](#RequestAttributes)Request Attributes (要求属性)
項目 型 説明 デフォルト値 必須

Session Id (セッション ID)

String (文字列)

はい

Request Id (要求 ID)

String (文字列)

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

はい

### [](#TextToolResponseContent)Text Tool Response Content (テキストツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部であるテキストコンテンツを定義します。
項目 型 説明 デフォルト値 必須

Text (テキスト)

String (文字列)

はい

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

### [](#ImageToolResponseContent)Image Tool Response Content (画像ツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部である画像コンテンツを定義します。
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Data (データ)

Binary (バイナリ)

Base64 でエンコードされていない未加工の画像コンテンツ。

Mime Type (MIME タイプ)

String (文字列)

画像の MIME タイプ。

### [](#TextResourceToolResponseContent)Text Resource Tool Response Content (テキストリソースツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部である埋め込みテキストリソースを定義します。
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Uri

String (文字列)

リソース URI。

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

Text (テキスト)

String (文字列)

リソースのテキスト。

### [](#BlobResourceToolResponseContent)Blob Resource Tool Response Content (Blob リソースツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部である埋め込み blob リソースを定義します。
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Blob

Binary (バイナリ)

Base64 でエンコードされていない未加工のリソースコンテンツ。

はい

Uri

String (文字列)

リソース URI。

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

### [](#TextResource)テキストリソース テキストリソースを定義します。
項目 型 説明 デフォルト値 必須

Text (テキスト)

String (文字列)

テキストコンテンツ。

はい

### [](#BlobResource)Blob リソース Blob リソースのコンテンツを定義します。
項目 型 説明 デフォルト値 必須

Blob

Binary (バイナリ)

Base64 でエンコードされていない未加工の blob コンテンツ。

はい

### [](#CustomHeader)カスタムヘッダー 要求または応答に含めるカスタムヘッダーを設定します。
名前 型 説明 デフォルト値 必須

Key (キー)

String (文字列)

ヘッダー名。

はい

Value (値)

String (文字列)

ヘッダー値。プロパティプレースホルダーと DataWeave 式をサポートします。

はい

## [](#関連情報)関連情報 - [Using Anypoint Code Builder to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb) - [Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [MCP Connector の概要](https://docs.mulesoft.com/jp/mcp-connector/1.0/) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.1 MCP 用 Anypoint Connector (MCP Connector) では、Model Context Protocol (MCP) を使用して、MCP をサポートする AI クライアントが API、コネクタ、アプリケーションを呼び出して、それらと通信できるようにします。 MCP Connector を使用して LLM アプリケーションを API に接続します。複雑なエンドポイントを持つ API を、エージェントクライアントに適した簡単かつアトミックなツールまたはリソースとして公開します。エージェントのアクションにとって何が簡単で、繰り返し可能で、最適であるかを決定し、そこから始めます。 MCP は、LLM アプリケーションと外部データ、サービス、およびツール間のインテグレーションを可能にするオープンプロトコルです。 MCP プロトコル: - AI に関連情報を提供することで AI の精度を強化し、応答の正確さを向上します。 - 外部データまたはサービスへのアクセスを必要とする複雑なタスクを AI が管理できるようにします。 - AI モデルと外部システム間の相互運用性を促進し、ワークフローへの統合を簡略化します。 MCP Connector: - MCP プロトコルを使用して Mule アプリケーション、コネクタ、カスタム API を公開し、さらに Claude、Cursor、Windsurf のエージェントや独自のエージェントからのエージェント環境を有効にすることができます。 - MCP サーバーとクライアントの両方の機能を果たすことができる Mule アプリケーションを作成できます。結果の MCP サーバーまたはクライアントは Mule の内部で実行されます。つまり、独自のホスト環境を設定する必要はありません。 - MCP サーバーとして機能する場合、Mule を使用すると、AI クライアントで、MCP をネイティブにサポートしない既存の API 主導の投資、従来のシステム、SaaS アプリケーションを使用できます、 - MCP クライアントとして機能する場合、Mule は、AI エージェントがワークフロー内で単に別のシステムとして追加される接続とオーケストレーションを作成するのに役立ちます。 - Mule をオーケストレーションレイヤーとして使用することで、AI エージェントを既存のエンタープライズエコシステムに組み込むことができます。 - サーバー用とクライアント用の両方の Streamable HTTP (推奨) と、SSE (サーバー用とクライアント用の両方) ​[トランスポート方式](#connection-types)​をサポートします。 - `/sse`​、​`/messages`​、​`/mcp`​ を含め、すべての公開されたエンドポイントでカスタムレスポンスヘッダーをサポートします。カスタムレスポンスヘッダーを使用して、セキュリティ、運用、インテグレーション、ガバナンスのメリットを得ます。 これにより、増大している AI エージェントエコシステムで Mule API とアプリケーションの機能を使用できます。 互換性と修正された問題については、「MCP Connector リリースノート」を参照してください。 ## [](#prerequisites)始める前に このコネクタを使用するには、以下に精通している必要があります。 - Anypoint Connector - Mule Runtime Engine (Mule) - Mule フローの要素とグローバル要素 - Anypoint Code Builder または Anypoint Studio を使用して Mule アプリケーションを作成する方法 アプリケーションを作成する前に、以下が必要です。 - Java 17 - Apache Maven - Anypoint Platform - 対象リソースに接続するためのログイン情報 - Anypoint Code Builder または Anypoint Studio の最新バージョン ## [](#use-cases)コネクタの一般的なユースケース 次に、コネクタの一般的なユースケースを示します。 - カスタマーサービス AI エージェントを使用して、時間のかかるタスク (ケース履歴の確認、報告された問題の分析、関連情報の取得など) を処理することで、人間のエージェントの効率を高めます。 - セールス プロスペクトの調査を加速し、カスタマイズした資料を生成し、契約書を作成することで、営業チームの成功を促進します。 - マーケティング ソーシャルメディアコンテンツのドラフトの作成、市場調査の実施、キャンペーンパフォーマンスの分析に AI 主導のサポートを提供することでマーケティングチームを強化します。 ## [](#connection-types)接続種別 - Streamable HTTP クライアントが個々のサーバー URL を認識することなく、MCP サーバーの複数のインスタンスをロードバランサーの背後で実行するようにデプロイできます。クライアントは 1 つのエンドポイント (​`/mcp`​ など) に接続され、ロードバランサーは要求をすべての MCP サーバーインスタンスに分散します。これは、Mule アプリケーションの複数のレプリカを実行する可能性があるクラウド環境の拡張性を確保するうえで特に役立ちます。 MCP クライアントとして機能する場合、Streamable HTTP を使用すると、Mule アプリケーションは、拡張性の高い同じ負荷分散方法を使用してリモート MCP サーバーに接続できます。 - SSE クライアント サーバー送信イベント (SSE) 標準を使用して、MCP Connector が MCP サーバーへの永続的な一方向 (サーバー送信) 接続を確立できるようにします。この種別の接続を使用すると、MCP サーバーはリアルタイム更新およびメッセージをクライアントにプッシュすることができ、クライアントは新しい情報を常にポーリングする必要がなくなります。 - SSE Server サーバー送信イベント (SSE) トランスポートを使用して、MCP サーバーを公開します。これにより、MCP クライアントはこのサーバーへの永続的な一方向接続を確立し、リアルタイム更新およびメッセージを受信できます。 ### [](#streamable-http-の制限)Streamable HTTP の制限 Streamable HTTP 接続種別では以下はサポートされません。 - 通知を取得するために GET ​`/mcp`​ エンドポイントをコールする - 再開可能性と再配信 ## [](#次のステップ)次のステップ Unresolved include directive in modules/ROOT/pages/index.adoc - include::connectors::partial$t-index-partial.adoc\[\] ## [](#関連情報)関連情報 - [Anypoint Connectors Overview](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Using Anypoint Code Builder to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb) - [Using Anypoint Studio to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-reference) - [MuleSoft MCP サポート: Model Context Protocol の使用開始](https://blogs.mulesoft.com/news/model-context-protocol/) - [Model Context Protocol](https://modelcontextprotocol.io/introduction) - [HTTP With SSE](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#http-with-sse) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.1 - MCP サーバーへのセキュリティの適用 MCP Connector により MCP クライアントのサーバー側認証が可能になります。これらの例では、ステートフルなサーバー送信イベント (SSE) 接続と ​**On New Session Listener**​ ソースを使用して、OAuth アクセストークンの検証を含むカスタムセキュリティロジックを実装します。 ## [](#on-new-session-listener-を使用したサーバー側認証)On New Session Listener を使用したサーバー側認証 MCP 仕様ではセッション管理を強調し、SSE 接続では状態を維持します。​**On New Session Listener**​ ソースでは、サーバー側認証を実装するための重要なポイントが提供されます。この例は、このリスナーでトリガーされる基本フローを示しており、自動生成された ​`sessionId`​ と、接続しているクライアントにより送信された HTTP ヘッダーへのアクセス方法を示しています。これらはその後、カスタム認証ロジックで使用できます。 これは、​**On New Session Listener**​ ソースを使用するサンプルフローです。 ```xml ``` このフローは、新しいクライアントが MCP サーバーアプリケーションに接続するたびに実行されます。ペイロードには自動生成された ​`sessionId`​ と ​`additionalProperties`​ が含まれています。SSE 接続種別を使用する場合、これらは HTTP リクエストヘッダーにマッピングされます。 この時点で独自の認証ロジックを実装できます。たとえば、​`#[payload.additionalProperties.authorization]`​ 式で HTTP 認証ヘッダーを取得し、後で検証することができます。 ### [](#oauth-アクセストークンの検証)OAuth アクセストークンの検証 必要に応じて、​[Mule OAuth 2.0 プロバイダー](https://docs.mulesoft.com/jp/api-manager/latest/mule-oauth-provider-landing-page)​を使用して、OAuth アクセストークンの実装と検証を行うことができます。 このサンプルフローでは、OAuth プロバイダーを使用してアクセストークンが検証され、トークンが無効な場合はセッションが拒否されます。 ```xml ``` 次のいずれかに該当する場合、新しいセッションは拒否されます。 - `rejectWithStatusCode`​ パラメーターに null 以外の値 (または null 以外の値に解決する式) が割り当てられている、または - フローが失敗した場合、状況コード 500 が報告される この例では、状況コードが ​`401 - UNAUTHORIZED`​ コードにマッピングされるように OAuth 検証エラーが処理されます。 ## [](#クライアント側認証)クライアント側認証 クライアントでは、認証パラメーターは、HTTP Connector と ​[OAuth Module](https://docs.mulesoft.com/jp/oauth-module/latest/)​ (これもプロジェクトに追加されている場合) で定義されたすべての認証戦略を受け入れます。 **Call Tool**​ などの操作は追加のプロパティも受け入れます。SSE の場合、このプロパティはリクエストヘッダーにマッピングされます。これにより、API キーなどのカスタム認証ヘッダーを追加することができます。次に例を示します。 ```xml ``` ## [](#次のステップ)次のステップ コネクタを設定したら、​[例](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-examples)​を試すことができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.1 - 例 既存の API を使用して、MCP Connector を使用してエージェントを作成する方法の例を次にいくつか示します。 ## [](#mcp-サーバーとツールの作成)MCP サーバーとツールの作成 これらの例は、Mule アプリケーション内で MCP サーバーを作成し、MCP サーバーで公開される 2 つの個別のツールを定義するプロセスを示しています。1 つは、承認済みベンダーの動的リストを各ベンダーの商品カテゴリとともに取得するツールで、もう 1 つは、指定された詳細で購入注文の作成を開始するツールです。 これらの例は、MCP ツールの概念を呼び出し可能なリモートプロシージャーコール (RPC) として示しています。 ### [](#mcp-サーバー設定の作成)MCP サーバー設定の作成 この例は、Streamable HTTP トランスポートを使用して Mule アプリケーション内で MCP サーバーを設定する方法を示しています。MCP クライアントとして機能する場合、MuleSoft では、AI エージェントがワークフロー内で単に別のシステムとして統合されるインテグレーションとオーケストレーションを容易に作成できます。 ```xml <<1>> <<2>> <<3>> <<4>> ```
1HTTP リスナー設定では、MCP サーバーが公開されるエンドポイントを定義します。
2MCP サーバー設定では、Streamable HTTP トランスポートを使用します。
3ヘッダーは、バージョン追跡とサーバー識別用にすべての応答に追加されます。
4さまざまな環境をサポートするためにプロパティプレースホルダーが設定値で使用されます。
### [](#ベンダーのリストを提供するツールの作成)ベンダーのリストを提供するツールの作成 この例は、外部システム (この例では SAP Concur) から承認済みベンダーの動的リストを取得する MCP ツールを作成する方法を示しています.この例は、​``​ を使用してコール可能なツールを定義する方法と、データを処理し、​`Custom19`​ 項目からの割り当て済み商品カテゴリを含め、関連ベンダー情報をエージェントに提供する方法を示しています。 まず、再試行およびタイムアウト設定を使用して SAP Concur 設定を定義します。 ```xml <<1>> <<2>> 30 <<3>> SECONDS <<4>> 3600000 MILLISECONDS ```
1SAP Concur 設定には、OAuth 認証設定が含まれます。
2一時的な接続の問題を処理するために再接続戦略を設定します。
3要求タイムアウトは、要求がハングしないように 30 秒に設定します。
4キャッシュ設定を追加して、1 時間の TTL でパフォーマンスを向上します。
次に、ページネーションとキャッシュを使用してベンダーの取得を処理するメインフローを作成します。 ```xml <<1>> Get all approved vendors with optional pagination > "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "pageSize": { "type": "integer", "description": "Number of vendors to return per page", "minimum": 1, "maximum": 100, "default": 50 }, "pageNumber": { "type": "integer", "description": "Page number to retrieve", "minimum": 1, "default": 1 } }, "required": [] }]]> <<3>> <<4>> <<5>> ```
1<mcp:tool-listener>​ では、ページネーションをサポートするベンダー取得ツールのインターフェースを定義します。
2<mcp:parameters-schema>​ スキーマには、ページサイズとページ番号の検証が含まれます。
3キャッシュコンポーネントは、結果を 1 時間保存することでパフォーマンスを向上します。
4DataWeave 変換では、承認されたベンダーを絞り込み、ページネーションメタデータを追加します。
5エラー処理では、接続エラー、認証エラー、予期しないエラーが対象となります。
### [](#購入注文を作成するツールの作成)購入注文を作成するツールの作成 この例は、エージェントが SAP Concur で購入注文の作成を開始するために使用できる MCP ツールの作成方法を示しています。この例では、JSON スキーマを使用してツールの入力パラメーターを定義する方法が強調されています。パラメーターごとに自然言語の説明が含まれており、これにより LLM は必要な情報を理解して入力することができます。 ```xml <<1>> Create a new purchase order in SAP Concur with validation > "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "name": { "type": "string", "description": "Name for the purchase order.", "minLength": 1, "maxLength": 100 }, "description": { "type": "string", "description": "Purchase order description.", "minLength": 1, "maxLength": 500 }, "vendorCode": { "type": "string", "description": "Code that identifies the vendor.", "pattern": "^[A-Z0-9]{3,10}$" }, "itemDescription": { "type": "string", "description": "Description of the item purchased in this order.", "minLength": 1, "maxLength": 200 }, "price": { "type": "number", "description": "Monetary amount of the purchase order.", "minimum": 0.01, "maximum": 999999.99 }, "currency": { "type": "string", "description": "Currency code for the purchase order monetary amount.", "pattern": "^[A-Z]{3}$" } }, "required": ["name", "description", "vendorCode", "itemDescription", "price", "currency"] }]]> <<3>> <<4>> <<5>> ```
1Tool Listener では、包括的な入力規則を含む購入注文作成インターフェースを定義します。
2パラメータースキーマには、長さ制限やパターンなど、すべての項目の入力規則が含まれます。
3ベンダー存在チェックが購入注文の作成前に実行されます。
4DataWeave 変換ではベンダーチェックの応答を検証します。
5エラー処理では、接続エラー、認証エラー、検証エラー、予期しないエラーが対象となります。
## [](#サードパーティ-mcp-サーバーを使用する-mcp-クライアントの設定)サードパーティ MCP サーバーを使用する MCP クライアントの設定 前の例では、既存の Anypoint Connector から情報を取得するツールの作成方法が示されました。ここでは、サードパーティ MCP サーバーを使用する方法を見てみましょう。 ### [](#複数の-mcp-サーバーを使用した天気サービスの作成)複数の MCP サーバーを使用した天気サービスの作成 この例は、MCP クライアントを設定し、​**Call Tool**​ 操作を使用することで、Streamable HTTP トランスポートを使用して Mule アプリケーションを既存のサードパーティ MCP サーバーと統合する方法を示しています。

サードパーティ MCP サーバーに接続する場合、その MCP サーバーで Streamable HTTP トランスポートがサポートされることを確認してください。サードパーティサーバーで SSE トランスポートのみがサポートされる場合、SSE クライアント接続を使用するか、サービスプロバイダーに連絡して Streamable HTTP についてのサポートを受ける必要があります。

まず、タイムアウトおよび再試行設定を使用してクライアント設定を定義します。 ```xml <<1>> 30 SECONDS <<2>> <<3>> ```
1HTTP 要求の設定には、天気 API のタイムアウト設定と再試行設定が含まれます。
2Google マップ MCP クライアントの設定では、カスタムヘッダーと再接続設定と共に Streamable HTTP トランスポートを使用します。
3天気 MCP サーバーの設定では、Streamable HTTP トランスポートを使用し、カスタムヘッダーを使用して天気サービスエンドポイントを公開します。
次に、エラー処理とキャッシュを含む天気サービスフローを作成します。 ```xml <<1>> 900000 MILLISECONDS <<2>> Provides the weather at given coordinates expressed as latitude and longitude <<3>> <<4>> Provides the weather at a specific address <<5>> ```
1 キャッシュ設定では、API コールを減らすために天気データを 15 分保存します。
2 座標ベースの天気フローには、入力規則とキャッシュが含まれます。
3 住所ベースの天気フローではツールの構成が示されています。
  • まず、Google マップを使用して住所を座標に変換します。

  • 次に、その座標を使用して天気を取得します。

4 両方のフローに、さまざまなシナリオの包括的なエラー処理が含まれます。
5 DataWeave 変換では、続行する前に Google マップの応答を検証します。
LLM でこれらのツールを直接オーケストレーションできますが、Mule での手動構成が望まれる次のような場合もあります。 - すべての MCP サーバーへの保証されたアクセスが必要な場合 - 認証をセキュアに処理する必要がある場合 - 強力なガバナンス機能とトレース機能が必要な場合 ## [](#関連情報)関連情報 - [MCP サーバーへのセキュリティの適用](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-config-topics) - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-reference) - [MuleSoft MCP サポート: Model Context Protocol の使用開始](https://blogs.mulesoft.com/news/model-context-protocol/) - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.1 XML と Maven のサポート Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#コネクタの名前空間の追加)コネクタの名前空間の追加 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#次のステップ)次のステップ Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] # MCP Connector 1.1 リファレンス MCP 用 Anypoint Connector (MCP Connector) を使用すると、Mule アプリケーションは MCP サーバーとクライアントの両方の機能を果たすことができます。MCP クライアントとして機能する場合、MuleSoft では、AI エージェントがワークフロー内で単に別のシステムとして統合されるインテグレーションとオーケストレーションを容易に作成できます。 ## [](#設定)設定 ### [](#Client)クライアント クライアントとして機能し、MCP サーバーに接続される設定要素。 #### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

はい

Connection (接続)

この設定に指定する接続型。

はい

Client Name (クライアント名)

String (文字列)

プロトコル初期化フェーズ中にクライアントが自身を識別するために使用する名前。これは、この設定要素に指定される名前 (後で config-ref パラメーターを介して参照される) とは異なります。この名前は一意である必要はありません。

はい

Client Version (クライアントバージョン)

String (文字列)

プロトコル初期化フェーズ中にクライアントが自身を識別するために使用するバージョン。これは、コネクタまたは Mule アプリケーションのバージョンに一致する必要はありません。

はい

Name (名前)

String (文字列)

この設定の参照に使用される ID。

はい

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

#### [](#接続種別)接続種別 ##### [](#Client_SseClient)SSE クライアント Streamable HTTP トランスポートをお勧めします。 SSE (サーバー送信イベント) クライアント接続種別を使用すると、SSE 標準を使用して、MCP Connector が MCP サーバーへの永続的な一方向 (サーバー送信) 接続を確立できます。この種別の接続を使用すると、MCP サーバーはリアルタイム更新およびメッセージをクライアントにプッシュすることができ、クライアントは新しい情報を常にポーリングする必要がなくなります。 ###### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

要求がタイムアウトする前に、サーバーの応答を待機する期間を設定します。

30

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

requestTimeout パラメーターの時間単位

SECONDS

Authentication (認証)

HttpRequestAuthentication

Default Request Headers (デフォルトリクエストヘッダー)

Object (オブジェクト)

MCP サーバーに各要求と共に送信するカスタムヘッダーを定義します。

Server Url (サーバー URL)

String (文字列)

対象 MCP サーバーのベース URL

はい

Sse Endpoint Path (SSE エンドポイントパス)

String (文字列)

/sse

Reconnection Delay (再接続遅延)

Number (数値)

SSE 接続がタイムアウトまたは終了した場合に SSE 接続を再初期化するまで待機する時間を指定します。

500

Reconnection Delay Unit (再接続遅延単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

reconnectionDelay パラメーターの時間単位

MILLISECONDS

Tls Context (TLS コンテキスト)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

##### [](#Client_StreamableHttpClient)Streamable HTTP クライアント ###### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

要求がタイムアウトする前に、サーバーの応答を待機する期間を設定します。

30

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

requestTimeout パラメーターの時間単位

SECONDS

Authentication (認証)

HttpRequestAuthentication

Default Request Headers (デフォルトリクエストヘッダー)

Object (オブジェクト)

MCP サーバーに各要求と共に送信するカスタムヘッダーを定義します。

Server Url (サーバー URL)

String (文字列)

対象 MCP サーバーのベース URL

はい

Mcp Endpoint Path (MCP エンドポイントパス)

String (文字列)

/mcp

Tls Context (TLS コンテキスト)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

## [](#サポートされている操作)サポートされている操作 - [MCP Client - Call Tool](#CallTool)​ - [MCP Client - List Resources](#ListResources)​ - [MCP Client - List Tools](#ListTools)​ - [MCP Client - Ping](#Ping)​ - [MCP Client - Read Resource](#ReadResource)​ ### [](#Server)サーバー MCP サーバーとして機能する設定要素。 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

はい

Connection (接続)

この設定に指定する接続型。

はい

Server Name (サーバー名)

String (文字列)

プロトコル初期化フェーズ中にこのサーバーが自身を識別するために使用する名前。これは、この設定要素に指定される名前 (後で config-ref パラメーターを介して参照される) とは異なります。この名前は一意である必要はありません。

はい

Server Version (サーバーバージョン)

String (文字列)

プロトコル初期化フェーズ中にこのサーバーが自身を識別するために使用するバージョン。これは、コネクタまたは Mule アプリケーションのバージョンに一致する必要はありません。

はい

Name (名前)

String (文字列)

この設定の参照に使用される ID。

はい

#### [](#接続種別-2)接続種別 ##### [](#Server_SseServer)SSE Server [「HTTP with SSE」](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#http-with-sse)​で定義されているとおりに、SSE トランスポートを使用して、MCP サーバーを公開します。 ###### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

Request Timeout (要求タイムアウト)

10

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

Request Timeout unit (要求タイムアウト単位)

SECONDS

Listener Config (リスナー設定)

String (文字列)

SSE とメッセージングエンドポイントを公開するために使用する HTTP リスナー設定への参照。

はい

Sse Endpoint Path (SSE エンドポイントパス)

String (文字列)

クライアントが SSE 接続を開始するために使用するエンドポイントパス。

/sse

Messages Path (メッセージパス)

String (文字列)

メッセージングエンドポイント要求の送信先のパス。

/message

Default Sse Response Headers (デフォルト SSE レスポンスヘッダー)

Object (オブジェクト)

Default Message Response Headers (デフォルトメッセージレスポンスヘッダー)

Object (オブジェクト)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

##### [](#Server_StreamableHttpServer)Streamable HTTP サーバー [「Streamable HTTP」](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)​で定義されているとおりに、Streamable HTTP トランスポートを使用して、MCP サーバーを公開します。 ###### [](#パラメーター-6)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

Request Timeout (要求タイムアウト)

10

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

Request Timeout unit (要求タイムアウト単位)

SECONDS

Listener Config (リスナー設定)

String (文字列)

SSE とメッセージングエンドポイントを公開するために使用する http:listener-config への参照。

はい

Mcp Endpoint Path (MCP エンドポイントパス)

String (文字列)

クライアントが SSE 接続を開始するために使用するエンドポイントパス

/mcp

Response Content Type (応答コンテンツタイプ)

Enumeration (列挙)。次のいずれかになります。

  • JSON

  • SSE

SSE ストリームの開始により応答を送信するか、1 つの application/json ボディの戻りにより応答を送信するか。

SSE

Default Response Headers (デフォルトレスポンスヘッダー)

Object (オブジェクト)

すべての有効な応答に含めるカスタムヘッダー (拒否された無効な要求は含めません)。

Session Idle Timeout (セッションアイドルタイムアウト)

Number (数値)

アイドルセッションのタイムアウト

5

Session Idle Timeout Unit (セッションアイドルタイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

sessionIdleTimeout を評価する時間単位。

MINUTES

Sessions Object Store (セッションオブジェクトストア)

ObjectStore

セッション情報を保存するために使用する ObjectStore。複数のレプリカにデプロイする場合、Hazelcast または OSv2 のいずれかを介してすべてのレプリカに分散される特定のオブジェクトストアを定義することをお勧めします。指定しない場合、デフォルトの一時的なインスタンスが作成されます。

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

## [](#関連付けられたソース)関連付けられたソース - [MCP Server - On New Session Listener](#OnNewSessionListener)​ - [MCP Server - Resource listener](#ResourceListener)​ - [MCP Server - Tool Listener](#ToolListener)​ ## [](#操作)操作 ## [](#CallTool)MCP Client - Call Tool `` リモート MCP サーバー内でツールを呼び出します。 ### [](#パラメーター-7)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Tool Name (ツール名)

String (文字列)

呼び出すツールの名前。

はい

Arguments (引数)

Object (オブジェクト)

ツールの入力引数。

#[payload]

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

#[null]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力)出力

型

Call Tool Response (Call Tool 応答)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:JSON\_RPC\_ERROR​ - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#ListResources)MCP Client - List Resources `` リモート MCP サーバー内のすべての使用可能なリソースをリストします。 ### [](#パラメーター-8)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。反復可能ストリームは、デフォルトの動作です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-2)出力

型

Resource Metadata (リソースメタデータ)​ の配列

### [](#次の設定の場合-2)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-2)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:INVALID\_URI​ - MCP:JSON\_RPC\_ERROR​ - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#ListTools)MCP Client - List Tools `` リモート MCP サーバー内のすべての使用可能なツールをリストします。 ### [](#パラメーター-9)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。反復可能ストリームは、デフォルトの動作です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-3)出力

型

Tool Metadata (ツールメタデータ)​ の配列

### [](#次の設定の場合-3)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-3)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:JSON\_RPC\_ERROR​ - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#Ping)MCP Client - Ping `` リモートサーバーを ping します。 ### [](#パラメーター-10)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-4)出力

型

Any (任意)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合-4)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-4)スロー - MCP:CONNECTIVITY - MCP:RETRY\_EXHAUSTED​ ## [](#ReadResource)MCP Client - Read Resource `` URI で参照されるリソースを読み取ります。 ### [](#パラメーター-11)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Uri

String (文字列)

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

#[null]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-5)出力

型

Resource Content (リソースコンテンツ)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合-5)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-5)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:INVALID\_URI​ - MCP:JSON\_RPC\_ERROR - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#ソース)ソース ## [](#OnNewSessionListener)MCP Server - On New Session Listener `` ### [](#パラメーター-12)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Reject With Status Code (状況コード付き拒否)

Number (数値)

Reject With Message (メッセージ付き拒否)

String (文字列)

### [](#出力-6)出力

型

New Session Request (新規セッション要求)

### [](#次の設定の場合-6)次の設定の場合 - [サーバー](#Server)​ ## [](#ResourceListener)MCP Server - Resource listener `` 所有フローの実行によりコンテンツが生成されたリソースを公開します。このフローは、受信したリソース/読み取り要求ごとに実行されます。ユーザーは、リソースコンテンツが静的になるようにフローを実装するか、リソースコンテンツを動的にするかを選択できます。たとえば、動的リソースには、実際はライブ DB クエリの実行結果である expenses.csv ファイルを使用できます。また、静的リソースには、Amazon S3 を介して取得され、​`ee:cache`​ コンポーネントを使用してローカルにキャッシュされたファイルを使用できます。 ### [](#パラメーター-13)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Name (名前)

String (文字列)

リソースの名前。

はい

Description (説明)

String (文字列)

このリソースを読み取るタイミングを LLM が判断するのに十分な詳細な説明。

はい

Uri

String (文字列)

リソース URI。

はい

Resource Mime Type (リソースの MIME タイプ)

String (文字列)

リソースの MIME タイプ。

はい

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Resource Listener

次のいずれかになります。

リソースのコンテンツと種別を定義します。これらのパラメーターは、フローが正常に完了した場合 (ペイロードと変数が使用可能な場合) に評価されます。

はい

### [](#出力-7)出力

型

Resource Request (リソース要求)

Attributes Type (属性型)

### [](#次の設定の場合-7)次の設定の場合 - [サーバー](#Server)​ ## [](#ToolListener)MCP Server - Tool Listener `` 所有フローの実行により結果が生成されたツールを公開します。このフローは、受信したツール/コール要求ごとに実行されます。トリガーされると、フローは、入力引数を保持する Java マップがペイロードとなっているメッセージを使用して実行されます。ツールの応答は、フローが正常に完了するかエラーで完了した場合に生成されます。いずれの場合も、応答には種別が異なるいくつかのコンテンツ項目が含まれている可能性があります。エラー応答が定義されていない場合、エラーの説明を含むテキストコンテンツ項目が自動的に生成されます。 ### [](#パラメーター-14)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Name (名前)

String (文字列)

ツールの名前

はい

Description (説明)

String (文字列)

このツールをコールするタイミングを LLM が判断するのに十分な詳細な説明。

はい

Parameters Schema (パラメータースキーマ)

String (文字列)

項目がツールの入力引数として機能するオブジェクトを定義する JSON スキーマ

はい

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Responses (応答)

フローが正常に完了した場合の応答項目。

はい

On Error Responses (エラー時の応答)

フローがエラーで完了した場合のコンテンツ項目。

### [](#出力-8)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request Attributes (要求属性)

### [](#次の設定の場合-8)次の設定の場合 - [サーバー](#Server)​ ## [](#型)型 ### [](#Tls)TLS Mule アプリケーションのセキュアな通信を提供するように TLS を設定します。
項目 型 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

TLS トラストストアを設定します。

Key Store (キーストア)

TLS キーストアを設定します。

Revocation Check (取り消し確認)

取り消し確認メカニズムを設定します。

### [](#TrustStore)Truststore (トラストストア) TLS 用のトラストストアを設定します。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

ストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用する暗号化アルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、Mule では証明書の検証の実行を停止します。これを ​true​ に設定すると、接続が攻撃に対して脆弱になる可能性があります。

### [](#KeyStore)Keystore (キーストア) TLS プロトコル用のキーストアを設定します。生成したキーストアには、非公開鍵と公開証明書が格納されます。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Type (型)

String (文字列)

ストアの型。

Alias (別名)

String (文字列)

キーストアに複数の非公開キーが含まれている場合に使用するキーの別名。デフォルトでは、Mule はファイル内の最初のキーを使用します。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用する暗号化アルゴリズム。

### [](#StandardRevocationCheck)Standard Revocation Check (標準の取り消し確認) TLS 証明書の標準取り消し確認を設定します。
項目 型 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーン内で確認する要素:

  • true​

証明書チェーンの最後の要素のみを確認します。

  • false​

証明書チェーンのすべての要素を確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

証明書の有効性を確認する方法:

  • true​

証明書失効リスト (CRL) で証明書の有効性を確認します。

  • false​

オンライン証明書状況プロトコル (OCSP) を使用して証明書の有効性を確認します。

No Fallback (代替なし)

Boolean (ブール)

証明書の有効性を確認するための第 2 の方法を使用するかどうか:

  • true​

[Prefer Crls (CRL を優先)]​ 項目で指定されていない方法 (第 2 の方法) を使用して証明書の有効性を確認します。

  • false​

証明書の有効性を確認するための第 2 の方法を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合の処理:

  • true​

検証エラーを回避します。

  • false​

検証の失敗を許可します。

### [](#CustomOcspResponder)Custom OCSP Responder (カスタム OCSP レスポンダー) 証明書の取り消し確認のカスタム OCSP レスポンダーを設定します。
項目 型 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

OCSP 応答の署名証明書の別名。指定した場合、別名はトラストストアに存在する必要があります。

### [](#CrlFile)CRL File (CRL ファイル) 証明書失効リスト (CRL) ファイルの場所を指定します。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。

### [](#reconnection-再接続)Reconnection (再接続) 操作の再接続戦略を設定します。
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイメントに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

### [](#reconnect-再接続)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#ReconnectForever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー) 有効期限ポリシー戦略を設定します。
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

動的設定インスタンスがアイドル状態を続けられる最大時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ 項目の時間単位。

### [](#CallToolResponse)Call Tool Response (Call Tool 応答) クライアントとしてのツールのコールから取得した応答。
項目 型 説明 デフォルト値 必須

Content (コンテンツ)

ツールにより生成されたコンテンツ

はい

Error (エラー)

Boolean (ブール)

ツールの実行が成功したか、エラーになったか。エラーの場合でもコンテンツが生成されることがあります。

false

### [](#CallToolResponseContent)Call Tool Response Content (Call Tool 応答コンテンツ)
項目 型 説明 デフォルト値 必須

Type (型)

Enumeration (列挙)。次のいずれかになります。

  • text (テキスト)

  • Image (画像)

  • resource (リソース)

コンテンツタイプ。

はい

Text (テキスト)

String (文字列)

型が ​text (テキスト)​ の場合のコンテンツのペイロード。

Mime Type (MIME タイプ)

String (文字列)

コンテンツの MIME タイプ。

Data (データ)

Binary (バイナリ)

型が ​image (画像)​ の場合のコンテンツのペイロード。

Resource (リソース)

型が ​resource (リソース)​ の場合のコンテンツのペイロード。

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

### [](#ResourceContent)Resource Content (リソースコンテンツ) リソースコンテンツのフラット化表現。リソースには、text (テキスト) または blob 型を使用できます。テキストリソースではテキストプロパティが設定され、後者では blob 型が使用されます。
項目 型 説明 デフォルト値 必須

Uri

String (文字列)

リソース URI

はい

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

はい

Text (テキスト)

String (文字列)

テキストリソースのコンテンツ。BLOB データ型の場合は null。

Blob

Binary (バイナリ)

BLOB リソースのコンテンツ。テキストデータ型の場合は null。

### [](#ErrorMapping)エラーのマッピング
項目 型 説明 デフォルト値 必須

Source (ソース)

Enumeration (列挙)。次のいずれかになります。

  • ANY

  • REDELIVERY_EXHAUSTED​

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY​

  • SERVER_SECURITY​

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED​

  • TIMEOUT

変換先

String (文字列)

はい

### [](#ResourceMetadata)Resource Metadata (リソースメタデータ)
項目 型 説明 デフォルト値 必須

Uri

String (文字列)

リソース URI。

はい

Name (名前)

String (文字列)

リソースの名前。

はい

Description (説明)

String (文字列)

リソースの説明。

はい

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

はい

### [](#RepeatableInMemoryIterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームをコンシュームしてランダムにアクセスするために割り当てられるメモリ量。ストリームのデータ量がこのバッファサイズを超える場合は、[Buffer Size Increment (バッファサイズ増分)] 値に従って、[Max In Memory Size (最大メモリ内サイズ)] 値を上限としてバッファが拡張されます。

100

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、拡張する量。値を ​0​ またはそれ以下に設定すると、バッファは拡張されません。

100

Max Buffer Size (最大バッファサイズ)

Number (数値)

バッファの最大サイズ。バッファサイズがこの値を超える場合、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。​0​ 以下の値は無制限を意味します。

### [](#RepeatableFileStoreIterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)
項目 型 説明 デフォルト値 必須

In Memory Objects (メモリ内オブジェクト)

Number (数値)

メモリ内に保持されるインスタンスの最大数。この最大数を超えるインスタンスが必要な場合、ディスク上のコンテンツがバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE

  • KB

  • MB

  • GB

[In Memory Objects (メモリ内オブジェクト)]​ 項目の単位。

### [](#ToolMetadata)Tool Metadata (ツールメタデータ) ツールをそのプロパティを介して説明します。
項目 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

ツールの名前。

はい

Description (説明)

String (文字列)

このツールをコールするタイミングを LLM が判断するのに十分な詳細な説明。

はい

Input Schema (入力スキーマ)

String (文字列)

ツールの入力パラメーターを説明する JSON スキーマ。

はい

### [](#NewSessionRequest)New Session Request (新規セッション要求) 新規サーバーセッションの作成を要求するクライアントに関連付けられたデータが含まれます。
項目 型 説明 デフォルト値 必須

Session Id (セッション ID)

String (文字列)

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

はい

Client Certificate (クライアント証明書)

### [](#CertificateData)Certificate Data (証明書データ)
項目 型 説明 デフォルト値 必須

Basic Constraints (基本制約)

Number (数値)

Critical Extension OIDs (重要な拡張機能 OID)

Array of String (文字列の配列)

Encoded (エンコード)

Binary (バイナリ)

Extended Key Usage (拡張キー使用)

Array of String (文字列の配列)

Extensions (拡張機能)

Issuer Alternative Names (発行者別名)

Issuer DN (発行者 DN)

Issuer Unique ID (発行者の一意の ID)

Boolean (ブール) の配列

Issuer X500 Principal (発行者 X500 プリンシパル)

Key Usage (キー使用)

Boolean (ブール) の配列

Name (名前)

String (文字列)

Non Critical Extension OIDs (重要でない拡張機能 OID)

Array of String (文字列の配列)

Not After (以前)

Date (日付)

Not Before (以降)

Date (日付)

Public Key (公開キー)

Serial Number (シリアル番号)

Number (数値)

Serial Number Object (シリアル番号オブジェクト)

Sig Alg Name (署名アルゴリズム名)

String (文字列)

Sig Alg OID (署名アルゴリズム OID)

String (文字列)

Sig Alg Params (署名アルゴリズムパラメーター)

Binary (バイナリ)

Signature (署名)

Binary (バイナリ)

Subject Alternative Names (サブジェクトの別名)

Subject DN (サブジェクト DN)

Subject X500 Principal (サブジェクト X500 プリンシパル)

Type (型)

String (文字列)

バージョン

Number (数値)

### [](#CertificateExtension)Certificate Extension (証明書拡張機能)
項目 型 説明 デフォルト値 必須

Criticality (重要性)

Boolean (ブール)

OID

String (文字列)

Value (値)

Binary (バイナリ)

### [](#AlternativeNameData)Alternative Name Data (別名データ)
項目 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

Type (型)

Number (数値)

### [](#PrincipalData)Principal Data (プリンシパルデータ)
項目 型 説明 デフォルト値 必須

Common Name (一般名)

String (文字列)

Name (名前)

String (文字列)

### [](#X500PrincipalData)X500 Principal Data (X500 プリンシパルデータ)
項目 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

### [](#PublicKeyData)Public Key Data (公開キーデータ)
項目 型 説明 デフォルト値 必須

Algorithm (アルゴリズム)

String (文字列)

Encoded (エンコード)

Binary (バイナリ)

Modulus (モジュール)

Number (数値)

Params (パラメーター)

Number (数値)

Public Key (公開キー)

String (文字列)

### [](#SerialNumberData)Serial Number Data (シリアル番号データ)
項目 型 説明 デフォルト値 必須

Serial Number (シリアル番号)

Number (数値)

### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー) エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。
項目 型 説明 デフォルト値 必須

Max Redelivery Count (最大再配信数)

Number (数値)

REDELIVERY_EXHAUSTED​ エラーが返されるまでに、再配信された要求が処理に失敗できる最大回数。

Message Digest Algorithm (メッセージダイジェストアルゴリズム)

String (文字列)

[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​true​ の場合に使用するセキュアハッシュアルゴリズム。メッセージのペイロードが Java オブジェクトの場合、Mule ではこの値が無視され、ペイロードの ​hashCode()​ が返した値が返されます。

Message Identifier (メッセージ識別子)

メッセージが再配信されたかどうかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。

Object Store (オブジェクトストア)

ObjectStore

各メッセージの再配信カウンターが保存されるオブジェクトストアを設定します。

### [](#RedeliveryPolicyMessageIdentifier)Redelivery Policy Message Identifier (再配信ポリシーメッセージ識別子) 再配信されたメッセージを識別する方法と、メッセージがいつ再配信されたのかを見つける方法を設定します。
項目 型 説明 デフォルト値 必須

Use Secure Hash (セキュアハッシュを使用)

Boolean (ブール)

true​ の場合、再配信されたメッセージの識別にセキュアハッシュアルゴリズムが使用されます。

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。

### [](#ResourceRequest)Resource Request (リソース要求) リソースのインバウンド要求。コネクタが MCP サーバーとして機能している場合に使用されます。
項目 型 説明 デフォルト値 必須

Requested Uri (要求済み URI)

String (文字列)

はい

### [](#RequestAttributes)Request Attributes (要求属性)
項目 型 説明 デフォルト値 必須

Session Id (セッション ID)

String (文字列)

はい

Request Id (要求 ID)

String (文字列)

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

はい

### [](#TextToolResponseContent)Text Tool Response Content (テキストツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部であるテキストコンテンツを定義します。
項目 型 説明 デフォルト値 必須

Text (テキスト)

String (文字列)

はい

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

### [](#ImageToolResponseContent)Image Tool Response Content (画像ツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部である画像コンテンツを定義します。
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Data (データ)

Binary (バイナリ)

Base64 でエンコードされていない未加工の画像コンテンツ。

Mime Type (MIME タイプ)

String (文字列)

画像の MIME タイプ。

### [](#TextResourceToolResponseContent)Text Resource Tool Response Content (テキストリソースツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部である埋め込みテキストリソースを定義します。
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Uri

String (文字列)

リソース URI。

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

Text (テキスト)

String (文字列)

リソースのテキスト。

### [](#BlobResourceToolResponseContent)Blob Resource Tool Response Content (Blob リソースツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部である埋め込み blob リソースを定義します。
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Blob

Binary (バイナリ)

Base64 でエンコードされていない未加工のリソースコンテンツ。

はい

Uri

String (文字列)

リソース URI。

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

### [](#TextResource)テキストリソース テキストリソースを定義します。
項目 型 説明 デフォルト値 必須

Text (テキスト)

String (文字列)

テキストコンテンツ。

はい

### [](#BlobResource)Blob リソース Blob リソースのコンテンツを定義します。
項目 型 説明 デフォルト値 必須

Blob

Binary (バイナリ)

Base64 でエンコードされていない未加工の blob コンテンツ。

はい

### [](#CustomHeader)カスタムヘッダー 要求または応答に含めるカスタムヘッダーを設定します。
名前 型 説明 デフォルト値 必須

Key (キー)

String (文字列)

ヘッダー名。

はい

Value (値)

String (文字列)

ヘッダー値。プロパティプレースホルダーと DataWeave 式をサポートします。

はい

## [](#関連情報)関連情報 - [Using Anypoint Code Builder to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb) - [Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [MCP Connector の概要](https://docs.mulesoft.com/jp/mcp-connector/1.1/) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.2 MCP 用 Anypoint Connector (MCP Connector) では、Model Context Protocol (MCP) を使用して、MCP をサポートする AI クライアントが API、コネクタ、アプリケーションを呼び出して、それらと通信できるようにします。 MCP Connector を使用して LLM アプリケーションを API に接続します。複雑なエンドポイントを持つ API を、エージェントクライアントに適した簡単かつアトミックなツールまたはリソースとして公開します。エージェントのアクションにとって何が簡単で、繰り返し可能で、最適であるかを決定し、そこから始めます。 MCP は、LLM アプリケーションと外部データ、サービス、およびツール間のインテグレーションを可能にするオープンプロトコルです。 MCP プロトコル: - AI に関連情報を提供することで AI の精度を強化し、応答の正確さを向上します。 - 外部データまたはサービスへのアクセスを必要とする複雑なタスクを AI が管理できるようにします。 - AI モデルと外部システム間の相互運用性を促進し、ワークフローへの統合を簡略化します。 MCP Connector: - MCP プロトコルを使用して Mule アプリケーション、コネクタ、カスタム API を公開し、さらに Claude、Cursor、Windsurf のエージェントや独自のエージェントからのエージェント環境を有効にすることができます。 - MCP サーバーとクライアントの両方の機能を果たすことができる Mule アプリケーションを作成できます。結果の MCP サーバーまたはクライアントは Mule の内部で実行されます。つまり、独自のホスト環境を設定する必要はありません。 - MCP サーバーとして機能する場合、Mule を使用すると、AI クライアントで、MCP をネイティブにサポートしない既存の API 主導の投資、従来のシステム、SaaS アプリケーションを使用できます、 - MCP クライアントとして機能する場合、Mule は、AI エージェントがワークフロー内で単に別のシステムとして追加される接続とオーケストレーションを作成するのに役立ちます。 - Mule をオーケストレーションレイヤーとして使用することで、AI エージェントを既存のエンタープライズエコシステムに組み込むことができます。 - サーバー用とクライアント用の両方の Streamable HTTP (推奨) と、SSE (サーバー用とクライアント用の両方) ​[トランスポート方式](#connection-types)​をサポートします。 - `/sse`​、​`/messages`​、​`/mcp`​ を含め、すべての公開されたエンドポイントでカスタムレスポンスヘッダーをサポートします。カスタムレスポンスヘッダーを使用して、セキュリティ、運用、インテグレーション、ガバナンスのメリットを得ます。 - 分散トレースのサポートを提供し、分散システム全体で MCP インタラクションの包括的な監視とオブザーバビリティを可能にします。 これにより、増大している AI エージェントエコシステムで Mule API とアプリケーションの機能を使用できます。 互換性と修正された問題については、「MCP Connector リリースノート」を参照してください。 ## [](#prerequisites)始める前に このコネクタを使用するには、以下に精通している必要があります。 - Anypoint Connector - Mule Runtime Engine (Mule) - Mule フローの要素とグローバル要素 - Anypoint Code Builder または Anypoint Studio を使用して Mule アプリケーションを作成する方法 アプリケーションを作成する前に、以下が必要です。 - Java 17 - Apache Maven - Anypoint Platform - 対象リソースに接続するためのログイン情報 - Anypoint Code Builder または Anypoint Studio の最新バージョン ## [](#use-cases)コネクタの一般的なユースケース 次に、コネクタの一般的なユースケースを示します。 - カスタマーサービス AI エージェントを使用して、時間のかかるタスク (ケース履歴の確認、報告された問題の分析、関連情報の取得など) を処理することで、人間のエージェントの効率を高めます。 - セールス プロスペクトの調査を加速し、カスタマイズした資料を生成し、契約書を作成することで、営業チームの成功を促進します。 - マーケティング ソーシャルメディアコンテンツのドラフトの作成、市場調査の実施、キャンペーンパフォーマンスの分析に AI 主導のサポートを提供することでマーケティングチームを強化します。 ## [](#connection-types)接続種別 - Streamable HTTP クライアントが個々のサーバー URL を認識することなく、MCP サーバーの複数のインスタンスをロードバランサーの背後で実行するようにデプロイできます。クライアントは 1 つのエンドポイント (​`/mcp`​ など) に接続され、ロードバランサーは要求をすべての MCP サーバーインスタンスに分散します。これは、Mule アプリケーションの複数のレプリカを実行する可能性があるクラウド環境の拡張性を確保するうえで特に役立ちます。 MCP クライアントとして機能する場合、Streamable HTTP を使用すると、Mule アプリケーションは、拡張性の高い同じ負荷分散方法を使用してリモート MCP サーバーに接続できます。 - SSE クライアント サーバー送信イベント (SSE) 標準を使用して、MCP Connector が MCP サーバーへの永続的な一方向 (サーバー送信) 接続を確立できるようにします。この種別の接続を使用すると、MCP サーバーはリアルタイム更新およびメッセージをクライアントにプッシュすることができ、クライアントは新しい情報を常にポーリングする必要がなくなります。 - SSE Server サーバー送信イベント (SSE) トランスポートを使用して、MCP サーバーを公開します。これにより、MCP クライアントはこのサーバーへの永続的な一方向接続を確立し、リアルタイム更新およびメッセージを受信できます。 ### [](#streamable-http-の制限)Streamable HTTP の制限 Streamable HTTP 接続種別では以下はサポートされません。 - 通知を取得するために GET ​`/mcp`​ エンドポイントをコールする - 再開可能性と再配信 ## [](#次のステップ)次のステップ Unresolved include directive in modules/ROOT/pages/index.adoc - include::connectors::partial$t-index-partial.adoc\[\] ## [](#関連情報)関連情報 - [Anypoint Connectors Overview](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [Using Anypoint Code Builder to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb) - [Using Anypoint Studio to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-reference) - [MuleSoft MCP サポート: Model Context Protocol の使用開始](https://blogs.mulesoft.com/news/model-context-protocol/) - [Model Context Protocol](https://modelcontextprotocol.io/introduction) - [HTTP With SSE](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#http-with-sse) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.2 - MCP サーバーへのセキュリティの適用 MCP Connector により MCP クライアントのサーバー側認証が可能になります。これらの例では、ステートフルなサーバー送信イベント (SSE) 接続と ​**On New Session Listener**​ ソースを使用して、OAuth アクセストークンの検証を含むカスタムセキュリティロジックを実装します。 ## [](#on-new-session-listener-を使用したサーバー側認証)On New Session Listener を使用したサーバー側認証 MCP 仕様ではセッション管理を強調し、SSE 接続では状態を維持します。​**On New Session Listener**​ ソースでは、サーバー側認証を実装するための重要なポイントが提供されます。この例は、このリスナーでトリガーされる基本フローを示しており、自動生成された ​`sessionId`​ と、接続しているクライアントにより送信された HTTP ヘッダーへのアクセス方法を示しています。これらはその後、カスタム認証ロジックで使用できます。 これは、​**On New Session Listener**​ ソースを使用するサンプルフローです。 ```xml ``` このフローは、新しいクライアントが MCP サーバーアプリケーションに接続するたびに実行されます。ペイロードには自動生成された ​`sessionId`​ と ​`additionalProperties`​ が含まれています。SSE 接続種別を使用する場合、これらは HTTP リクエストヘッダーにマッピングされます。 この時点で独自の認証ロジックを実装できます。たとえば、​`#[payload.additionalProperties.authorization]`​ 式で HTTP 認証ヘッダーを取得し、後で検証することができます。 ### [](#oauth-アクセストークンの検証)OAuth アクセストークンの検証 必要に応じて、​[Mule OAuth 2.0 プロバイダー](https://docs.mulesoft.com/jp/api-manager/latest/mule-oauth-provider-landing-page)​を使用して、OAuth アクセストークンの実装と検証を行うことができます。 このサンプルフローでは、OAuth プロバイダーを使用してアクセストークンが検証され、トークンが無効な場合はセッションが拒否されます。 ```xml ``` 次のいずれかに該当する場合、新しいセッションは拒否されます。 - `rejectWithStatusCode`​ パラメーターに null 以外の値 (または null 以外の値に解決する式) が割り当てられている、または - フローが失敗した場合、状況コード 500 が報告される この例では、状況コードが ​`401 - UNAUTHORIZED`​ コードにマッピングされるように OAuth 検証エラーが処理されます。 ## [](#クライアント側認証)クライアント側認証 クライアントでは、認証パラメーターは、HTTP Connector と ​[OAuth Module](https://docs.mulesoft.com/jp/oauth-module/latest/)​ (これもプロジェクトに追加されている場合) で定義されたすべての認証戦略を受け入れます。 **Call Tool**​ などの操作は追加のプロパティも受け入れます。SSE の場合、このプロパティはリクエストヘッダーにマッピングされます。これにより、API キーなどのカスタム認証ヘッダーを追加することができます。次に例を示します。 ```xml ``` ## [](#次のステップ)次のステップ コネクタを設定したら、​[例](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-examples)​を試すことができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.2 - 例 既存の API を使用して、MCP Connector を使用してエージェントを作成する方法の例を次にいくつか示します。 ## [](#mcp-サーバーとツールの作成)MCP サーバーとツールの作成 これらの例は、Mule アプリケーション内で MCP サーバーを作成し、MCP サーバーで公開される 2 つの個別のツールを定義するプロセスを示しています。1 つは、承認済みベンダーの動的リストを各ベンダーの商品カテゴリとともに取得するツールで、もう 1 つは、指定された詳細で購入注文の作成を開始するツールです。 これらの例は、MCP ツールの概念を呼び出し可能なリモートプロシージャーコール (RPC) として示しています。 ### [](#mcp-サーバー設定の作成)MCP サーバー設定の作成 この例は、Streamable HTTP トランスポートを使用して Mule アプリケーション内で MCP サーバーを設定する方法を示しています。MCP クライアントとして機能する場合、MuleSoft では、AI エージェントがワークフロー内で単に別のシステムとして統合されるインテグレーションとオーケストレーションを容易に作成できます。 ```xml <<1>> <<2>> <<3>> <<4>> ```
1HTTP リスナー設定では、MCP サーバーが公開されるエンドポイントを定義します。
2MCP サーバー設定では、Streamable HTTP トランスポートを使用します。
3ヘッダーは、バージョン追跡とサーバー識別用にすべての応答に追加されます。
4さまざまな環境をサポートするためにプロパティプレースホルダーが設定値で使用されます。
### [](#ベンダーのリストを提供するツールの作成)ベンダーのリストを提供するツールの作成 この例は、外部システム (この例では SAP Concur) から承認済みベンダーの動的リストを取得する MCP ツールを作成する方法を示しています.この例は、​``​ を使用してコール可能なツールを定義する方法と、データを処理し、​`Custom19`​ 項目からの割り当て済み商品カテゴリを含め、関連ベンダー情報をエージェントに提供する方法を示しています。 まず、再試行およびタイムアウト設定を使用して SAP Concur 設定を定義します。 ```xml <<1>> <<2>> 30 <<3>> SECONDS <<4>> 3600000 MILLISECONDS ```
1SAP Concur 設定には、OAuth 認証設定が含まれます。
2一時的な接続の問題を処理するために再接続戦略を設定します。
3要求タイムアウトは、要求がハングしないように 30 秒に設定します。
4キャッシュ設定を追加して、1 時間の TTL でパフォーマンスを向上します。
次に、ページネーションとキャッシュを使用してベンダーの取得を処理するメインフローを作成します。 ```xml <<1>> Get all approved vendors with optional pagination > "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "pageSize": { "type": "integer", "description": "Number of vendors to return per page", "minimum": 1, "maximum": 100, "default": 50 }, "pageNumber": { "type": "integer", "description": "Page number to retrieve", "minimum": 1, "default": 1 } }, "required": [] }]]> <<3>> <<4>> <<5>> ```
1<mcp:tool-listener>​ では、ページネーションをサポートするベンダー取得ツールのインターフェースを定義します。
2<mcp:parameters-schema>​ スキーマには、ページサイズとページ番号の検証が含まれます。
3キャッシュコンポーネントは、結果を 1 時間保存することでパフォーマンスを向上します。
4DataWeave 変換では、承認されたベンダーを絞り込み、ページネーションメタデータを追加します。
5エラー処理では、接続エラー、認証エラー、予期しないエラーが対象となります。
### [](#購入注文を作成するツールの作成)購入注文を作成するツールの作成 この例は、エージェントが SAP Concur で購入注文の作成を開始するために使用できる MCP ツールの作成方法を示しています。この例では、JSON スキーマを使用してツールの入力パラメーターを定義する方法が強調されています。パラメーターごとに自然言語の説明が含まれており、これにより LLM は必要な情報を理解して入力することができます。 ```xml <<1>> Create a new purchase order in SAP Concur with validation > "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "name": { "type": "string", "description": "Name for the purchase order.", "minLength": 1, "maxLength": 100 }, "description": { "type": "string", "description": "Purchase order description.", "minLength": 1, "maxLength": 500 }, "vendorCode": { "type": "string", "description": "Code that identifies the vendor.", "pattern": "^[A-Z0-9]{3,10}$" }, "itemDescription": { "type": "string", "description": "Description of the item purchased in this order.", "minLength": 1, "maxLength": 200 }, "price": { "type": "number", "description": "Monetary amount of the purchase order.", "minimum": 0.01, "maximum": 999999.99 }, "currency": { "type": "string", "description": "Currency code for the purchase order monetary amount.", "pattern": "^[A-Z]{3}$" } }, "required": ["name", "description", "vendorCode", "itemDescription", "price", "currency"] }]]> <<3>> <<4>> <<5>> ```
1Tool Listener では、包括的な入力規則を含む購入注文作成インターフェースを定義します。
2パラメータースキーマには、長さ制限やパターンなど、すべての項目の入力規則が含まれます。
3ベンダー存在チェックが購入注文の作成前に実行されます。
4DataWeave 変換ではベンダーチェックの応答を検証します。
5エラー処理では、接続エラー、認証エラー、検証エラー、予期しないエラーが対象となります。
## [](#サードパーティ-mcp-サーバーを使用する-mcp-クライアントの設定)サードパーティ MCP サーバーを使用する MCP クライアントの設定 前の例では、既存の Anypoint Connector から情報を取得するツールの作成方法が示されました。ここでは、サードパーティ MCP サーバーを使用する方法を見てみましょう。 ### [](#複数の-mcp-サーバーを使用した天気サービスの作成)複数の MCP サーバーを使用した天気サービスの作成 この例は、MCP クライアントを設定し、​**Call Tool**​ 操作を使用することで、Streamable HTTP トランスポートを使用して Mule アプリケーションを既存のサードパーティ MCP サーバーと統合する方法を示しています。

サードパーティ MCP サーバーに接続する場合、その MCP サーバーで Streamable HTTP トランスポートがサポートされることを確認してください。サードパーティサーバーで SSE トランスポートのみがサポートされる場合、SSE クライアント接続を使用するか、サービスプロバイダーに連絡して Streamable HTTP についてのサポートを受ける必要があります。

まず、タイムアウトおよび再試行設定を使用してクライアント設定を定義します。 ```xml <<1>> 30 SECONDS <<2>> <<3>> ```
1HTTP 要求の設定には、天気 API のタイムアウト設定と再試行設定が含まれます。
2Google マップ MCP クライアントの設定では、カスタムヘッダーと再接続設定と共に Streamable HTTP トランスポートを使用します。
3天気 MCP サーバーの設定では、Streamable HTTP トランスポートを使用し、カスタムヘッダーを使用して天気サービスエンドポイントを公開します。
次に、エラー処理とキャッシュを含む天気サービスフローを作成します。 ```xml <<1>> 900000 MILLISECONDS <<2>> Provides the weather at given coordinates expressed as latitude and longitude <<3>> <<4>> Provides the weather at a specific address <<5>> ```
1 キャッシュ設定では、API コールを減らすために天気データを 15 分保存します。
2 座標ベースの天気フローには、入力規則とキャッシュが含まれます。
3 住所ベースの天気フローではツールの構成が示されています。
  • まず、Google マップを使用して住所を座標に変換します。

  • 次に、その座標を使用して天気を取得します。

4 両方のフローに、さまざまなシナリオの包括的なエラー処理が含まれます。
5 DataWeave 変換では、続行する前に Google マップの応答を検証します。
LLM でこれらのツールを直接オーケストレーションできますが、Mule での手動構成が望まれる次のような場合もあります。 - すべての MCP サーバーへの保証されたアクセスが必要な場合 - 認証をセキュアに処理する必要がある場合 - 強力なガバナンス機能とトレース機能が必要な場合 ## [](#関連情報)関連情報 - [MCP サーバーへのセキュリティの適用](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-config-topics) - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-reference) - [MuleSoft MCP サポート: Model Context Protocol の使用開始](https://blogs.mulesoft.com/news/model-context-protocol/) - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # MCP Connector 1.2 XML と Maven のサポート Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#コネクタの名前空間の追加)コネクタの名前空間の追加 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#次のステップ)次のステップ Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] ## [](#関連情報)関連情報 Unresolved include directive in modules/ROOT/pages/mcp-connector-xml-maven.adoc - include::connectors::partial$t-xml-maven-partial.adoc\[\] # MCP Connector 1.2 リファレンス MCP 用 Anypoint Connector (MCP Connector) を使用すると、Mule アプリケーションは MCP サーバーとクライアントの両方の機能を果たすことができます。MCP クライアントとして機能する場合、MuleSoft では、AI エージェントがワークフロー内で単に別のシステムとして統合されるインテグレーションとオーケストレーションを容易に作成できます。 ## [](#設定)設定 ### [](#Client)クライアント クライアントとして機能し、MCP サーバーに接続される設定要素。 #### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

はい

Connection (接続)

この設定に指定する接続型。

はい

Client Name (クライアント名)

String (文字列)

プロトコル初期化フェーズ中にクライアントが自身を識別するために使用する名前。これは、この設定要素に指定される名前 (後で config-ref パラメーターを介して参照される) とは異なります。この名前は一意である必要はありません。

はい

Client Version (クライアントバージョン)

String (文字列)

プロトコル初期化フェーズ中にクライアントが自身を識別するために使用するバージョン。これは、コネクタまたは Mule アプリケーションのバージョンに一致する必要はありません。

はい

Name (名前)

String (文字列)

この設定の参照に使用される ID。

はい

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

#### [](#接続種別)接続種別 ##### [](#Client_SseClient)SSE クライアント Streamable HTTP トランスポートをお勧めします。 SSE (サーバー送信イベント) クライアント接続種別を使用すると、SSE 標準を使用して、MCP Connector が MCP サーバーへの永続的な一方向 (サーバー送信) 接続を確立できます。この種別の接続を使用すると、MCP サーバーはリアルタイム更新およびメッセージをクライアントにプッシュすることができ、クライアントは新しい情報を常にポーリングする必要がなくなります。 ###### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

要求がタイムアウトする前に、サーバーの応答を待機する期間を設定します。

30

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

requestTimeout パラメーターの時間単位

SECONDS

Authentication (認証)

HttpRequestAuthentication

Default Request Headers (デフォルトリクエストヘッダー)

Object (オブジェクト)

MCP サーバーに各要求と共に送信するカスタムヘッダーを定義します。

Server Url (サーバー URL)

String (文字列)

対象 MCP サーバーのベース URL

はい

Sse Endpoint Path (SSE エンドポイントパス)

String (文字列)

/sse

Reconnection Delay (再接続遅延)

Number (数値)

SSE 接続がタイムアウトまたは終了した場合に SSE 接続を再初期化するまで待機する時間を指定します。

500

Reconnection Delay Unit (再接続遅延単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

reconnectionDelay パラメーターの時間単位

MILLISECONDS

Tls Context (TLS コンテキスト)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

##### [](#Client_StreamableHttpClient)Streamable HTTP クライアント ###### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

要求がタイムアウトする前に、サーバーの応答を待機する期間を設定します。

30

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

requestTimeout パラメーターの時間単位

SECONDS

Authentication (認証)

HttpRequestAuthentication

Default Request Headers (デフォルトリクエストヘッダー)

Object (オブジェクト)

MCP サーバーに各要求と共に送信するカスタムヘッダーを定義します。

Server Url (サーバー URL)

String (文字列)

対象 MCP サーバーのベース URL

はい

Mcp Endpoint Path (MCP エンドポイントパス)

String (文字列)

/mcp

Tls Context (TLS コンテキスト)

TLS

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

## [](#サポートされている操作)サポートされている操作 - [MCP Client - Call Tool](#CallTool)​ - [MCP Client - List Resources](#ListResources)​ - [MCP Client - List Tools](#ListTools)​ - [MCP Client - Ping](#Ping)​ - [MCP Client - Read Resource](#ReadResource)​ ### [](#Server)サーバー MCP サーバーとして機能する設定要素。 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

はい

Connection (接続)

この設定に指定する接続型。

はい

Server Name (サーバー名)

String (文字列)

プロトコル初期化フェーズ中にこのサーバーが自身を識別するために使用する名前。これは、この設定要素に指定される名前 (後で config-ref パラメーターを介して参照される) とは異なります。この名前は一意である必要はありません。

はい

Server Version (サーバーバージョン)

String (文字列)

プロトコル初期化フェーズ中にこのサーバーが自身を識別するために使用するバージョン。これは、コネクタまたは Mule アプリケーションのバージョンに一致する必要はありません。

はい

Name (名前)

String (文字列)

この設定の参照に使用される ID。

はい

#### [](#接続種別-2)接続種別 ##### [](#Server_SseServer)SSE Server [「HTTP with SSE」](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#http-with-sse)​で定義されているとおりに、SSE トランスポートを使用して、MCP サーバーを公開します。 ###### [](#パラメーター-5)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

Request Timeout (要求タイムアウト)

10

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

Request Timeout unit (要求タイムアウト単位)

SECONDS

Listener Config (リスナー設定)

String (文字列)

SSE とメッセージングエンドポイントを公開するために使用する HTTP リスナー設定への参照。

はい

Sse Endpoint Path (SSE エンドポイントパス)

String (文字列)

クライアントが SSE 接続を開始するために使用するエンドポイントパス。

/sse

Messages Path (メッセージパス)

String (文字列)

メッセージングエンドポイント要求の送信先のパス。

/message

Default Sse Response Headers (デフォルト SSE レスポンスヘッダー)

Object (オブジェクト)

Default Message Response Headers (デフォルトメッセージレスポンスヘッダー)

Object (オブジェクト)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

##### [](#Server_StreamableHttpServer)Streamable HTTP サーバー [「Streamable HTTP」](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)​で定義されているとおりに、Streamable HTTP トランスポートを使用して、MCP サーバーを公開します。 ###### [](#パラメーター-6)パラメーター
名前 型 説明 デフォルト値 必須

Request Timeout (要求タイムアウト)

Number

Request Timeout (要求タイムアウト)

10

Request Timeout Unit (要求タイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

Request Timeout unit (要求タイムアウト単位)

SECONDS

Listener Config (リスナー設定)

String (文字列)

SSE とメッセージングエンドポイントを公開するために使用する http:listener-config への参照。

はい

Mcp Endpoint Path (MCP エンドポイントパス)

String (文字列)

クライアントが SSE 接続を開始するために使用するエンドポイントパス

/mcp

Response Content Type (応答コンテンツタイプ)

Enumeration (列挙)。次のいずれかになります。

  • JSON

  • SSE

SSE ストリームの開始により応答を送信するか、1 つの application/json ボディの戻りにより応答を送信するか。

SSE

Default Response Headers (デフォルトレスポンスヘッダー)

Object (オブジェクト)

すべての有効な応答に含めるカスタムヘッダー (拒否された無効な要求は含めません)。

Session Idle Timeout (セッションアイドルタイムアウト)

Number (数値)

アイドルセッションのタイムアウト

5

Session Idle Timeout Unit (セッションアイドルタイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

sessionIdleTimeout を評価する時間単位。

MINUTES

Sessions Object Store (セッションオブジェクトストア)

ObjectStore

セッション情報を保存するために使用する ObjectStore。複数のレプリカにデプロイする場合、Hazelcast または OSv2 のいずれかを介してすべてのレプリカに分散される特定のオブジェクトストアを定義することをお勧めします。指定しない場合、デフォルトの一時的なインスタンスが作成されます。

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

## [](#関連付けられたソース)関連付けられたソース - [MCP Server - On New Session Listener](#OnNewSessionListener)​ - [MCP Server - Resource listener](#ResourceListener)​ - [MCP Server - Tool Listener](#ToolListener)​ ## [](#操作)操作 ## [](#CallTool)MCP Client - Call Tool `` リモート MCP サーバー内でツールを呼び出します。 ### [](#パラメーター-7)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Tool Name (ツール名)

String (文字列)

呼び出すツールの名前。

はい

Arguments (引数)

Object (オブジェクト)

ツールの入力引数。

#[payload]

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

#[null]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力)出力

型

Call Tool Response (Call Tool 応答)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:JSON\_RPC\_ERROR​ - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#ListResources)MCP Client - List Resources `` リモート MCP サーバー内のすべての使用可能なリソースをリストします。 ### [](#パラメーター-8)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。反復可能ストリームは、デフォルトの動作です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-2)出力

型

Resource Metadata (リソースメタデータ)​ の配列

### [](#次の設定の場合-2)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-2)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:INVALID\_URI​ - MCP:JSON\_RPC\_ERROR​ - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#ListTools)MCP Client - List Tools `` リモート MCP サーバー内のすべての使用可能なツールをリストします。 ### [](#パラメーター-9)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。反復可能ストリームは、デフォルトの動作です。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-3)出力

型

Tool Metadata (ツールメタデータ)​ の配列

### [](#次の設定の場合-3)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-3)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:JSON\_RPC\_ERROR​ - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#Ping)MCP Client - Ping `` リモートサーバーを ping します。 ### [](#パラメーター-10)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-4)出力

型

Any (任意)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合-4)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-4)スロー - MCP:CONNECTIVITY - MCP:RETRY\_EXHAUSTED​ ## [](#ReadResource)MCP Client - Read Resource `` URI で参照されるリソースを読み取ります。 ### [](#パラメーター-11)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Uri

String (文字列)

はい

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

#[null]

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

エラーのマッピング

エラーのマッピングのセット。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

### [](#出力-5)出力

型

Resource Content (リソースコンテンツ)

Attributes Type (属性型)

Any (任意)

### [](#次の設定の場合-5)次の設定の場合 - [クライアント](#Client)​ ### [](#スロー-5)スロー - MCP:CONNECTIVITY - MCP:INTERNAL\_ERROR​ - MCP:INVALID\_PARAMS​ - MCP:INVALID\_REQUEST​ - MCP:INVALID\_URI​ - MCP:JSON\_RPC\_ERROR - MCP:METHOD\_NOT\_FOUND​ - MCP:PARSE\_ERROR​ - MCP:REQUEST\_TIMEOUT​ - MCP:RETRY\_EXHAUSTED​ - MCP:SERVER\_ERROR​ ## [](#ソース)ソース ## [](#OnNewSessionListener)MCP Server - On New Session Listener `` ### [](#パラメーター-12)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Reject With Status Code (状況コード付き拒否)

Number (数値)

Reject With Message (メッセージ付き拒否)

String (文字列)

### [](#出力-6)出力

型

New Session Request (新規セッション要求)

### [](#次の設定の場合-6)次の設定の場合 - [サーバー](#Server)​ ## [](#ResourceListener)MCP Server - Resource listener `` 所有フローの実行によりコンテンツが生成されたリソースを公開します。このフローは、受信したリソース/読み取り要求ごとに実行されます。ユーザーは、リソースコンテンツが静的になるようにフローを実装するか、リソースコンテンツを動的にするかを選択できます。たとえば、動的リソースには、実際はライブ DB クエリの実行結果である expenses.csv ファイルを使用できます。また、静的リソースには、Amazon S3 を介して取得され、​`ee:cache`​ コンポーネントを使用してローカルにキャッシュされたファイルを使用できます。 ### [](#パラメーター-13)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Name (名前)

String (文字列)

リソースの名前。

はい

Description (説明)

String (文字列)

このリソースを読み取るタイミングを LLM が判断するのに十分な詳細な説明。

はい

Uri

String (文字列)

リソース URI。

はい

Resource Mime Type (リソースの MIME タイプ)

String (文字列)

リソースの MIME タイプ。

はい

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Resource Listener

次のいずれかになります。

リソースのコンテンツと種別を定義します。これらのパラメーターは、フローが正常に完了した場合 (ペイロードと変数が使用可能な場合) に評価されます。

はい

### [](#出力-7)出力

型

Resource Request (リソース要求)

Attributes Type (属性型)

### [](#次の設定の場合-7)次の設定の場合 - [サーバー](#Server)​ ## [](#ToolListener)MCP Server - Tool Listener `` 所有フローの実行により結果が生成されたツールを公開します。このフローは、受信したツール/コール要求ごとに実行されます。トリガーされると、フローは、入力引数を保持する Java マップがペイロードとなっているメッセージを使用して実行されます。ツールの応答は、フローが正常に完了するかエラーで完了した場合に生成されます。いずれの場合も、応答には種別が異なるいくつかのコンテンツ項目が含まれている可能性があります。エラー応答が定義されていない場合、エラーの説明を含むテキストコンテンツ項目が自動的に生成されます。 ### [](#パラメーター-14)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

はい

Name (名前)

String (文字列)

ツールの名前

はい

Description (説明)

String (文字列)

このツールをコールするタイミングを LLM が判断するのに十分な詳細な説明。

はい

Parameters Schema (パラメータースキーマ)

String (文字列)

項目がツールの入力引数として機能するオブジェクトを定義する JSON スキーマ

はい

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Config Ref (設定参照)

ConfigurationProvider

このコンポーネントを実行するために使用する設定の名前。

はい

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを定義します。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

Responses (応答)

フローが正常に完了した場合の応答項目。

はい

On Error Responses (エラー時の応答)

フローがエラーで完了した場合のコンテンツ項目。

### [](#出力-8)出力

型

Object (オブジェクト)

Attributes Type (属性型)

Request Attributes (要求属性)

### [](#次の設定の場合-8)次の設定の場合 - [サーバー](#Server)​ ## [](#型)型 ### [](#Tls)TLS Mule アプリケーションのセキュアな通信を提供するように TLS を設定します。
項目 型 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

TLS トラストストアを設定します。

Key Store (キーストア)

TLS キーストアを設定します。

Revocation Check (取り消し確認)

取り消し確認メカニズムを設定します。

### [](#TrustStore)Truststore (トラストストア) TLS 用のトラストストアを設定します。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

ストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用する暗号化アルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、Mule では証明書の検証の実行を停止します。これを ​true​ に設定すると、接続が攻撃に対して脆弱になる可能性があります。

### [](#KeyStore)Keystore (キーストア) TLS プロトコル用のキーストアを設定します。生成したキーストアには、非公開鍵と公開証明書が格納されます。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアへのパス。Mule では、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Type (型)

String (文字列)

ストアの型。

Alias (別名)

String (文字列)

キーストアに複数の非公開キーが含まれている場合に使用するキーの別名。デフォルトでは、Mule はファイル内の最初のキーを使用します。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用する暗号化アルゴリズム。

### [](#StandardRevocationCheck)Standard Revocation Check (標準の取り消し確認) TLS 証明書の標準取り消し確認を設定します。
項目 型 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーン内で確認する要素:

  • true​

証明書チェーンの最後の要素のみを確認します。

  • false​

証明書チェーンのすべての要素を確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

証明書の有効性を確認する方法:

  • true​

証明書失効リスト (CRL) で証明書の有効性を確認します。

  • false​

オンライン証明書状況プロトコル (OCSP) を使用して証明書の有効性を確認します。

No Fallback (代替なし)

Boolean (ブール)

証明書の有効性を確認するための第 2 の方法を使用するかどうか:

  • true​

[Prefer Crls (CRL を優先)]​ 項目で指定されていない方法 (第 2 の方法) を使用して証明書の有効性を確認します。

  • false​

証明書の有効性を確認するための第 2 の方法を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合の処理:

  • true​

検証エラーを回避します。

  • false​

検証の失敗を許可します。

### [](#CustomOcspResponder)Custom OCSP Responder (カスタム OCSP レスポンダー) 証明書の取り消し確認のカスタム OCSP レスポンダーを設定します。
項目 型 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

OCSP 応答の署名証明書の別名。指定した場合、別名はトラストストアに存在する必要があります。

### [](#CrlFile)CRL File (CRL ファイル) 証明書失効リスト (CRL) ファイルの場所を指定します。
項目 型 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。

### [](#reconnection-再接続)Reconnection (再接続) 操作の再接続戦略を設定します。
項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイメントに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

### [](#reconnect-再接続)Reconnect (再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#ReconnectForever)Reconnect Forever (繰り返し再接続)
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー) 有効期限ポリシー戦略を設定します。
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

動的設定インスタンスがアイドル状態を続けられる最大時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ 項目の時間単位。

### [](#CallToolResponse)Call Tool Response (Call Tool 応答) クライアントとしてのツールのコールから取得した応答。
項目 型 説明 デフォルト値 必須

Content (コンテンツ)

ツールにより生成されたコンテンツ

はい

Error (エラー)

Boolean (ブール)

ツールの実行が成功したか、エラーになったか。エラーの場合でもコンテンツが生成されることがあります。

false

### [](#CallToolResponseContent)Call Tool Response Content (Call Tool 応答コンテンツ)
項目 型 説明 デフォルト値 必須

Type (型)

Enumeration (列挙)。次のいずれかになります。

  • text (テキスト)

  • Image (画像)

  • resource (リソース)

コンテンツタイプ。

はい

Text (テキスト)

String (文字列)

型が ​text (テキスト)​ の場合のコンテンツのペイロード。

Mime Type (MIME タイプ)

String (文字列)

コンテンツの MIME タイプ。

Data (データ)

Binary (バイナリ)

型が ​image (画像)​ の場合のコンテンツのペイロード。

Resource (リソース)

型が ​resource (リソース)​ の場合のコンテンツのペイロード。

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

### [](#ResourceContent)Resource Content (リソースコンテンツ) リソースコンテンツのフラット化表現。リソースには、text (テキスト) または blob 型を使用できます。テキストリソースではテキストプロパティが設定され、後者では blob 型が使用されます。
項目 型 説明 デフォルト値 必須

Uri

String (文字列)

リソース URI

はい

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

はい

Text (テキスト)

String (文字列)

テキストリソースのコンテンツ。BLOB データ型の場合は null。

Blob

Binary (バイナリ)

BLOB リソースのコンテンツ。テキストデータ型の場合は null。

### [](#ErrorMapping)エラーのマッピング
項目 型 説明 デフォルト値 必須

Source (ソース)

Enumeration (列挙)。次のいずれかになります。

  • ANY

  • REDELIVERY_EXHAUSTED​

  • TRANSFORMATION

  • EXPRESSION

  • SECURITY

  • CLIENT_SECURITY​

  • SERVER_SECURITY​

  • ROUTING

  • CONNECTIVITY

  • RETRY_EXHAUSTED​

  • TIMEOUT

変換先

String (文字列)

はい

### [](#ResourceMetadata)Resource Metadata (リソースメタデータ)
項目 型 説明 デフォルト値 必須

Uri

String (文字列)

リソース URI。

はい

Name (名前)

String (文字列)

リソースの名前。

はい

Description (説明)

String (文字列)

リソースの説明。

はい

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

はい

### [](#RepeatableInMemoryIterable)Repeatable In Memory Iterable (反復可能なメモリ内イテラブル)
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

ストリームをコンシュームしてランダムにアクセスするために割り当てられるメモリ量。ストリームのデータ量がこのバッファサイズを超える場合は、[Buffer Size Increment (バッファサイズ増分)] 値に従って、[Max In Memory Size (最大メモリ内サイズ)] 値を上限としてバッファが拡張されます。

100

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、拡張する量。値を ​0​ またはそれ以下に設定すると、バッファは拡張されません。

100

Max Buffer Size (最大バッファサイズ)

Number (数値)

バッファの最大サイズ。バッファサイズがこの値を超える場合、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。​0​ 以下の値は無制限を意味します。

### [](#RepeatableFileStoreIterable)Repeatable File Store Iterable (反復可能なファイルストアイテラブル)
項目 型 説明 デフォルト値 必須

In Memory Objects (メモリ内オブジェクト)

Number (数値)

メモリ内に保持されるインスタンスの最大数。この最大数を超えるインスタンスが必要な場合、ディスク上のコンテンツがバッファされます。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE

  • KB

  • MB

  • GB

[In Memory Objects (メモリ内オブジェクト)]​ 項目の単位。

### [](#ToolMetadata)Tool Metadata (ツールメタデータ) ツールをそのプロパティを介して説明します。
項目 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

ツールの名前。

はい

Description (説明)

String (文字列)

このツールをコールするタイミングを LLM が判断するのに十分な詳細な説明。

はい

Input Schema (入力スキーマ)

String (文字列)

ツールの入力パラメーターを説明する JSON スキーマ。

はい

### [](#NewSessionRequest)New Session Request (新規セッション要求) 新規サーバーセッションの作成を要求するクライアントに関連付けられたデータが含まれます。
項目 型 説明 デフォルト値 必須

Session Id (セッション ID)

String (文字列)

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

はい

Client Certificate (クライアント証明書)

### [](#CertificateData)Certificate Data (証明書データ)
項目 型 説明 デフォルト値 必須

Basic Constraints (基本制約)

Number (数値)

Critical Extension OIDs (重要な拡張機能 OID)

Array of String (文字列の配列)

Encoded (エンコード)

Binary (バイナリ)

Extended Key Usage (拡張キー使用)

Array of String (文字列の配列)

Extensions (拡張機能)

Issuer Alternative Names (発行者別名)

Issuer DN (発行者 DN)

Issuer Unique ID (発行者の一意の ID)

Boolean (ブール) の配列

Issuer X500 Principal (発行者 X500 プリンシパル)

Key Usage (キー使用)

Boolean (ブール) の配列

Name (名前)

String (文字列)

Non Critical Extension OIDs (重要でない拡張機能 OID)

Array of String (文字列の配列)

Not After (以前)

Date (日付)

Not Before (以降)

Date (日付)

Public Key (公開キー)

Serial Number (シリアル番号)

Number (数値)

Serial Number Object (シリアル番号オブジェクト)

Sig Alg Name (署名アルゴリズム名)

String (文字列)

Sig Alg OID (署名アルゴリズム OID)

String (文字列)

Sig Alg Params (署名アルゴリズムパラメーター)

Binary (バイナリ)

Signature (署名)

Binary (バイナリ)

Subject Alternative Names (サブジェクトの別名)

Subject DN (サブジェクト DN)

Subject X500 Principal (サブジェクト X500 プリンシパル)

Type (型)

String (文字列)

バージョン

Number (数値)

### [](#CertificateExtension)Certificate Extension (証明書拡張機能)
項目 型 説明 デフォルト値 必須

Criticality (重要性)

Boolean (ブール)

OID

String (文字列)

Value (値)

Binary (バイナリ)

### [](#AlternativeNameData)Alternative Name Data (別名データ)
項目 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

Type (型)

Number (数値)

### [](#PrincipalData)Principal Data (プリンシパルデータ)
項目 型 説明 デフォルト値 必須

Common Name (一般名)

String (文字列)

Name (名前)

String (文字列)

### [](#X500PrincipalData)X500 Principal Data (X500 プリンシパルデータ)
項目 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

### [](#PublicKeyData)Public Key Data (公開キーデータ)
項目 型 説明 デフォルト値 必須

Algorithm (アルゴリズム)

String (文字列)

Encoded (エンコード)

Binary (バイナリ)

Modulus (モジュール)

Number (数値)

Params (パラメーター)

Number (数値)

Public Key (公開キー)

String (文字列)

### [](#SerialNumberData)Serial Number Data (シリアル番号データ)
項目 型 説明 デフォルト値 必須

Serial Number (シリアル番号)

Number (数値)

### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー) エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。
項目 型 説明 デフォルト値 必須

Max Redelivery Count (最大再配信数)

Number (数値)

REDELIVERY_EXHAUSTED​ エラーが返されるまでに、再配信された要求が処理に失敗できる最大回数。

Message Digest Algorithm (メッセージダイジェストアルゴリズム)

String (文字列)

[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​true​ の場合に使用するセキュアハッシュアルゴリズム。メッセージのペイロードが Java オブジェクトの場合、Mule ではこの値が無視され、ペイロードの ​hashCode()​ が返した値が返されます。

Message Identifier (メッセージ識別子)

メッセージが再配信されたかどうかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。

Object Store (オブジェクトストア)

ObjectStore

各メッセージの再配信カウンターが保存されるオブジェクトストアを設定します。

### [](#RedeliveryPolicyMessageIdentifier)Redelivery Policy Message Identifier (再配信ポリシーメッセージ識別子) 再配信されたメッセージを識別する方法と、メッセージがいつ再配信されたのかを見つける方法を設定します。
項目 型 説明 デフォルト値 必須

Use Secure Hash (セキュアハッシュを使用)

Boolean (ブール)

true​ の場合、再配信されたメッセージの識別にセキュアハッシュアルゴリズムが使用されます。

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。

### [](#ResourceRequest)Resource Request (リソース要求) リソースのインバウンド要求。コネクタが MCP サーバーとして機能している場合に使用されます。
項目 型 説明 デフォルト値 必須

Requested Uri (要求済み URI)

String (文字列)

はい

### [](#RequestAttributes)Request Attributes (要求属性)
項目 型 説明 デフォルト値 必須

Session Id (セッション ID)

String (文字列)

はい

Request Id (要求 ID)

String (文字列)

はい

Additional Properties (追加プロパティ)

Object (オブジェクト)

はい

### [](#TextToolResponseContent)Text Tool Response Content (テキストツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部であるテキストコンテンツを定義します。
項目 型 説明 デフォルト値 必須

Text (テキスト)

String (文字列)

はい

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

### [](#ImageToolResponseContent)Image Tool Response Content (画像ツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部である画像コンテンツを定義します。
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Data (データ)

Binary (バイナリ)

Base64 でエンコードされていない未加工の画像コンテンツ。

Mime Type (MIME タイプ)

String (文字列)

画像の MIME タイプ。

### [](#TextResourceToolResponseContent)Text Resource Tool Response Content (テキストリソースツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部である埋め込みテキストリソースを定義します。
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Uri

String (文字列)

リソース URI。

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

Text (テキスト)

String (文字列)

リソースのテキスト。

### [](#BlobResourceToolResponseContent)Blob Resource Tool Response Content (Blob リソースツール応答コンテンツ) このコネクタを介して実装されたツールの応答の一部である埋め込み blob リソースを定義します。
項目 型 説明 デフォルト値 必須

Audience (対象者)

Array of Enumeration (列挙の配列)。次のいずれかになります。

  • USER

  • ASSISTANT

このデータの目的のコンシューマーが誰であるかを説明します。複数のエントリを含めて、複数の対象者に役立つコンテンツを示すことができます。

Priority (優先度)

Number (数値)

このデータがサーバーの運用にどの程度重要であるかを説明します。​1​ の値は「重要性が最も高い」ことを意味し、データが必須であることを示します。​0​ の値は「重要性が最も低い」ことを意味し、データが完全に省略可能であることを示します。

Blob

Binary (バイナリ)

Base64 でエンコードされていない未加工のリソースコンテンツ。

はい

Uri

String (文字列)

リソース URI。

Mime Type (MIME タイプ)

String (文字列)

リソースの MIME タイプ。

### [](#TextResource)テキストリソース テキストリソースを定義します。
項目 型 説明 デフォルト値 必須

Text (テキスト)

String (文字列)

テキストコンテンツ。

はい

### [](#BlobResource)Blob リソース Blob リソースのコンテンツを定義します。
項目 型 説明 デフォルト値 必須

Blob

Binary (バイナリ)

Base64 でエンコードされていない未加工の blob コンテンツ。

はい

### [](#CustomHeader)カスタムヘッダー 要求または応答に含めるカスタムヘッダーを設定します。
名前 型 説明 デフォルト値 必須

Key (キー)

String (文字列)

ヘッダー名。

はい

Value (値)

String (文字列)

ヘッダー値。プロパティプレースホルダーと DataWeave 式をサポートします。

はい

## [](#関連情報)関連情報 - [Using Anypoint Code Builder to Configure a Connector](https://docs.mulesoft.com/connectors/introduction/intro-config-use-acb) - [Studio を使用したコネクタの設定](https://docs.mulesoft.com/connectors/introduction/intro-config-use-studio) - [MCP Connector の概要](https://docs.mulesoft.com/jp/mcp-connector/1.2/) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # バージョン 1.0.0 への MCP Connector のアップグレード MCP Connector 0.1.0-BETA は非推奨になりました。代わりに MCP Connector 1.0.0 を使用してください。MCP Connector 1.0.0 には、このコネクタの 0.1.0-BETA バージョンとの後方互換性はありません。 ## [](#このリリースでの変更)このリリースでの変更 このリリースには、次の変更が含まれています。 - Streamable HTTP トランスポート Streamable HTTP トランスポートのサポートが追加されました。このトランスポート方式は、非推奨になった SSE トランスポートを置き換えて、拡張性とクラウドの互換性を向上します。 - カスタムレスポンスヘッダー すべての公開済みエンドポイントでカスタムヘッダーのサポートが追加されました。 - 強化されたエラー処理 特定のエラー種別とより適切になったエラーメッセージによりエラー処理が改善されました。 - パフォーマンスの向上 キャッシュサポートとタイムアウト設定が追加されました。 - 入力規則 JSON スキーマの制約によりパラメーター検証が強化されました。 - 次の新しい型が追加されました。 - Call Tool Response (Call Tool 応答) - Resource Content (リソースコンテンツ) - Resource Metadata (リソースメタデータ) - Tool Metadata (ツールメタデータ) - New Session Request (新規セッション要求) - Resource Request (リソース要求) - Text Tool Response Content (テキストツール応答コンテンツ) - Text Resource Tool Response Content (テキストリソースツール応答コンテンツ) - Blob Resource Tool Response Content (Blob リソースツール応答コンテンツ) - Blob リソース - `mule.http.service.implementation=NETTY`​ プロパティは不要になったため、​[削除](#remove-property)​する必要があります。 - ``​ の ​``​ 要素は ​``​ に名前変更されました。このコネクタの 0.1.0-BETA バージョンを使用していた場合は、コネクタの設定 XML でこの要素の名前を手動で変更する必要があります。 ## [](#削除された機能)削除された機能 - ``​ および ​``​ 設定属性が削除されました。 - ``​ 操作が削除されました。MCP サーバーは常に自身を非動的としてアドバタイズします。 ## [](#update-pom)POM ファイルの連動関係の更新 MCP Connector 0.1.0-BETA を使用している場合、POM ファイルの連動関係を次のように更新する必要があります。 ```xml com.mulesoft.connectors mule-mcp-connector 1.0.0 mule-plugin ``` `com.mulesoft.connector`​ が変更され、​`connector`​ が複数形の ​`connectors`​ になりました。 ## [](#remove-property)NETTY プロパティの削除 MCP Connector の 0.1.0-BETA バージョンを使用していて、​`-Dmule.http.service.implementation=NETTY`​ プロパティを追加した場合は、次を含め追加したすべての場所から削除してください。 - `AnypointStudio.ini`​ ファイル - デバッグ設定 - アプリケーションのプロパティ ## [](#関連情報)関連情報 - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-reference) - [MCP Connector の例](https://docs.mulesoft.com/jp/mcp-connector/1.0/mcp-connector-examples) - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # バージョン 1.1 への MCP Connector のアップグレード MCP Connector 0.1.0-BETA は非推奨になりました。代わりに MCP Connector 1.x を使用してください。MCP Connector 1.x には、このコネクタの 0.1.0-BETA バージョンとの後方互換性はありません。 ## [](#サポートされているアップグレードパス)サポートされているアップグレードパス
開始バージョン 終了バージョン

1.0

1.x

## [](#1-1-の変更)1.1 の変更 - MCP クライアント設定内の \[SSE Client (SSE クライアント)\] 接続種別と \[Streamable Http Client (Streamable HTTP クライアント)\] 接続種別の両方に ​**\[Default Request Headers (デフォルトリクエストヘッダー)\]**​ パラメーターが追加されました。このパラメーターを使用すると、MCP サーバーに各要求と共に送信するカスタムヘッダーを指定できます。 ## [](#1-0-の変更)1.0 の変更 このリリースには、次の変更が含まれています。 - Streamable HTTP トランスポート Streamable HTTP トランスポートのサポートが追加されました。このトランスポート方式は、非推奨になった SSE トランスポートを置き換えて、拡張性とクラウドの互換性を向上します。 - カスタムレスポンスヘッダー すべての公開済みエンドポイントでカスタムヘッダーのサポートが追加されました。 - 強化されたエラー処理 特定のエラー種別とより適切になったエラーメッセージによりエラー処理が改善されました。 - パフォーマンスの向上 キャッシュサポートとタイムアウト設定が追加されました。 - 入力規則 JSON スキーマの制約によりパラメーター検証が強化されました。 - 次の新しい型が追加されました。 - Call Tool Response (Call Tool 応答) - Resource Content (リソースコンテンツ) - Resource Metadata (リソースメタデータ) - Tool Metadata (ツールメタデータ) - New Session Request (新規セッション要求) - Resource Request (リソース要求) - Text Tool Response Content (テキストツール応答コンテンツ) - Text Resource Tool Response Content (テキストリソースツール応答コンテンツ) - Blob Resource Tool Response Content (Blob リソースツール応答コンテンツ) - Blob リソース - `mule.http.service.implementation=NETTY`​ プロパティは不要になったため、​[削除](#remove-property)​する必要があります。 - ``​ の ​``​ 要素は ​``​ に名前変更されました。このコネクタの 0.1.0-BETA バージョンを使用していた場合は、コネクタの設定 XML でこの要素の名前を手動で変更する必要があります。 ## [](#削除された機能)削除された機能 - ``​ および ​``​ 設定属性が削除されました。 - ``​ 操作が削除されました。MCP サーバーは常に自身を非動的としてアドバタイズします。 ## [](#update-pom)POM ファイルの連動関係の更新 MCP Connector 0.1.0-BETA を使用している場合、POM ファイルの連動関係を次のように更新する必要があります。 ```xml com.mulesoft.connectors mule-mcp-connector 1.0.0 mule-plugin ``` `com.mulesoft.connector`​ が変更され、​`connector`​ が複数形の ​`connectors`​ になりました。 ## [](#remove-property)NETTY プロパティの削除 MCP Connector の 0.1.0-BETA バージョンを使用していて、​`-Dmule.http.service.implementation=NETTY`​ プロパティを追加した場合は、次を含め追加したすべての場所から削除してください。 - `AnypointStudio.ini`​ ファイル - デバッグ設定 - アプリケーションのプロパティ ## [](#関連情報)関連情報 - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-reference) - [MCP Connector の例](https://docs.mulesoft.com/jp/mcp-connector/1.1/mcp-connector-examples) - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # バージョン 1.2 への MCP Connector のアップグレード MCP Connector 0.1.0-BETA は非推奨になりました。代わりに MCP Connector 1.x を使用してください。MCP Connector 1.x には、このコネクタの 0.1.0-BETA バージョンとの後方互換性はありません。 ## [](#サポートされているアップグレードパス)サポートされているアップグレードパス
開始バージョン 終了バージョン

1.0

1.x

## [](#1-2-の変更)1.2 の変更 - MCP Connector で分散トレースがサポートされるようになりました。 ## [](#1-1-の変更)1.1 の変更 - MCP クライアント設定内の \[SSE Client (SSE クライアント)\] 接続種別と \[Streamable Http Client (Streamable HTTP クライアント)\] 接続種別の両方に ​**\[Default Request Headers (デフォルトリクエストヘッダー)\]**​ パラメーターが追加されました。このパラメーターを使用すると、MCP サーバーに各要求と共に送信するカスタムヘッダーを指定できます。 ## [](#1-0-の変更)1.0 の変更 このリリースには、次の変更が含まれています。 - Streamable HTTP トランスポート Streamable HTTP トランスポートのサポートが追加されました。このトランスポート方式は、非推奨になった SSE トランスポートを置き換えて、拡張性とクラウドの互換性を向上します。 - カスタムレスポンスヘッダー すべての公開済みエンドポイントでカスタムヘッダーのサポートが追加されました。 - 強化されたエラー処理 特定のエラー種別とより適切になったエラーメッセージによりエラー処理が改善されました。 - パフォーマンスの向上 キャッシュサポートとタイムアウト設定が追加されました。 - 入力規則 JSON スキーマの制約によりパラメーター検証が強化されました。 - 次の新しい型が追加されました。 - Call Tool Response (Call Tool 応答) - Resource Content (リソースコンテンツ) - Resource Metadata (リソースメタデータ) - Tool Metadata (ツールメタデータ) - New Session Request (新規セッション要求) - Resource Request (リソース要求) - Text Tool Response Content (テキストツール応答コンテンツ) - Text Resource Tool Response Content (テキストリソースツール応答コンテンツ) - Blob Resource Tool Response Content (Blob リソースツール応答コンテンツ) - Blob リソース - `mule.http.service.implementation=NETTY`​ プロパティは不要になったため、​[削除](#remove-property)​する必要があります。 - ``​ の ​``​ 要素は ​``​ に名前変更されました。このコネクタの 0.1.0-BETA バージョンを使用していた場合は、コネクタの設定 XML でこの要素の名前を手動で変更する必要があります。 ## [](#削除された機能)削除された機能 - ``​ および ​``​ 設定属性が削除されました。 - ``​ 操作が削除されました。MCP サーバーは常に自身を非動的としてアドバタイズします。 ## [](#update-pom)POM ファイルの連動関係の更新 MCP Connector 0.1.0-BETA を使用している場合、POM ファイルの連動関係を次のように更新する必要があります。 ```xml com.mulesoft.connectors mule-mcp-connector 1.0.0 mule-plugin ``` `com.mulesoft.connector`​ が変更され、​`connector`​ が複数形の ​`connectors`​ になりました。 ## [](#remove-property)NETTY プロパティの削除 MCP Connector の 0.1.0-BETA バージョンを使用していて、​`-Dmule.http.service.implementation=NETTY`​ プロパティを追加した場合は、次を含め追加したすべての場所から削除してください。 - `AnypointStudio.ini`​ ファイル - デバッグ設定 - アプリケーションのプロパティ ## [](#関連情報)関連情報 - [MCP Connector リファレンス](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-reference) - [MCP Connector の例](https://docs.mulesoft.com/jp/mcp-connector/1.2/mcp-connector-examples) - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com)