1. Homepage
  2. MCP Connector (1.2)

  3. Anypoint Studio を使用した MCP Connector の設定

All Connectors

Anypoint Studio を使用した MCP Connector 1.2 の設定

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

  1. Mule プロジェクトを作成します​。

  2. コネクタを Mule プロジェクトに追加します​。

  3. コネクタのフローのソースを設定します​。

  4. フローにコネクタの操作を追加します​。

  5. コネクタのグローバル要素を設定します​。

  6. その他のコネクタ項目を設定します​。

  7. アプリケーションをデバッグします​。

  8. アプリケーションログを表示します​。

  9. MCP ポリシーを適用します​。

  10. アプリケーションをデプロイします​。

Studio で初めてコネクタを設定する場合は、​「Anypoint Studio を使用したコネクタの設定」​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​「MCP Connector リファレンス」​を参照してください。

Mule プロジェクトを作成する

Studio で、MCP 用 Anypoint Connector (MCP Connector) を追加および設定する新しい Mule プロジェクトを作成します。

  1. Studio で、​[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)]​ を選択します。

  2. Mule プロジェクトの名前を入力して、​[Finish (完了)]​ をクリックします。

コネクタを Mule プロジェクトに追加する

MCP Connector を Mule プロジェクトに追加すると、コネクタの名前空間およびスキーマの場所が XML コードに自動的に入力され、必要な連動関係がプロジェクトの ​pom.xml​ ファイルに追加されます。

  1. [Mule Palette (Mule パレット)]​ で、​[(X) Search in Exchange ((X) Exchange 内を検索)]​ をクリックします。

  2. [Add Dependencies to Project (連動関係をプロジェクトに追加)]​ で、検索項目に ​mcp​ を入力します。

  3. [Available modules (使用可能なモジュール)]​ で、​MCP Connector​ をクリックします。

  4. [Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。 次のソースのいずれかを MCP Connector で使用するように設定できます。

  • On New Session Listener

  • Resource Listener

  • Tool Listener

  • [HTTP] > [Listener]

    設定されたホストとポートで要求を受信するたびにフローを開始する

  • Scheduler

    たとえば、​[HTTP] > [Listener]​ ソースを設定する手順は、次のとおりです。

    1. [Mule Palette (Mule パレット)]​ で、​[HTTP] > [Listener]​ を選択します。

    2. [Listener]​ を Studio キャンバスにドラッグします。

    3. [Listener (リスナー)]​ 設定画面で、必要に応じて ​[Display Name (表示名)]​ 項目の値を変更します。

    4. [Path (パス)]​ 項目の値を指定します。

    5. [Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (​+​) をクリックして、アプリケーション内の ​[HTTP] > [Listener]​ ソースのすべてのインスタンスで使用できるグローバル要素を設定します。

    6. [General (一般)]​ タブで、コネクタの接続情報を指定します。

    7. [TLS]​ タブで、必要に応じてコネクタの TLS 情報を指定します。

    8. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

    9. [Test Connection (接続をテスト)]​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。

    10. [OK]​ をクリックします。

フローにコネクタの操作を追加する

フローにコネクタの操作を追加するときは、そのコネクタで実行するアクションを指定しています。

MCP Connector の操作を追加する手順は、次のとおりです。

  1. [Mule Palette (Mule パレット)]​ で、​[MCP]​ を選択し、目的の操作を選択します。

  2. その操作を Studio キャンバスのソースの横にドラッグします。

コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定します。グローバル要素を設定するには、コネクタが対象の MCP システムにアクセスするために必要な認証ログイン情報を指定する必要があります。

ANT スタイルのプロパティプレースホルダーを含む設定ファイルを参照するか (推奨)、グローバル設定プロパティに認証ログイン情報を入力できます。プロパティプレースホルダーを使用する利点とその設定方法については、​「Anypoint Connector 設定」​を参照してください。

MCP Connector のグローバル要素を設定する手順は、次のとおりです。

  1. Studio キャンバスで操作を選択します。

  2. 操作のプロパティ画面で、[Add (追加)] (​+​) アイコンをクリックして、グローバル要素設定項目にアクセスします。

  3. [General (一般)]​ タブの ​[Connection (接続)]​ で、設定する認証方式を選択します。MCP プロトコルのセキュリティは主に OAuth 認証コードフローに基づきます。さまざまなシステムや使用法との互換性を維持するため、コネクタでは次を含めその他の認証方法もサポートされます。

  1. [TLS]​ タブで、必要に応じてコネクタの TLS 情報を指定します。

  2. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  3. [Test Connection (接続をテスト)]​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。

  4. [OK]​ をクリックします。

基本認証

[Global Element Properties (グローバル要素のプロパティ)]​ 画面の ​[General (一般)]​ タブで認証情報を入力し、基本認証を設定します。

  1. [Connection (接続)] > [Basic (基本)]​ を選択し、次の項目の値を入力または設定します。

    項目 ユーザーアクション

    Name (名前)

    設定名を入力します。

    Username (ユーザー名)

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

    Password (パスワード)

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

    Preemptive (プリエンプティブ)

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

OAuth 認証コード

クライアントがエンドユーザー (人間) の代理となる場合に使用されます。たとえば、エージェントは SaaS システムによって実装された MCP ツールをコールします。

OAuth Client Credentials (OAuth クライアントログイン情報)

マシン間の認証で使用されます。クライアントアプリケーションは、そのクライアント ID とクライアントシークレットを使用して自身を認証サーバーで直接認証し、アクセストークンを受け取ります。

これは、アプリケーションがユーザーの代理ではなく自身のためにリソースにアクセスしている場合に使用されます。

ダイジェスト

パスワードをプレーンテキストで送信することを避けるためにチャレンジ/レスポンスメカニズムを使用する HTTP 認証スキーム。このスキームでは、パスワードとその他の情報をハッシュ化してクライアントの ID を検証します。

NTLM

主に Windows 環境で使用される Microsoft 認証プロトコル。チャレンジレスポンスメカニズムを使用し、ネットワーク認証で一般的に使用されます。

その他のコネクタ項目の設定

MCP Connector のグローバル要素を設定したら、コネクタの他の必須項目を設定します。必須項目は、使用するコネクタ操作によって異なります。

アプリケーションをデバッグする

Studio の埋め込みデバッガーを使用して Mule アプリケーションをデバッグします。

Logging and Debuggingを参照してください。

アプリケーションログの表示

問題を確認するため、アプリケーションログを次の方法で表示できます。

  • アプリケーションを Anypoint Platform から実行している場合、アプリケーションログ出力は Anypoint Studio のコンソールウィンドウに表示されます。

  • コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログ出力はオペレーティングシステムコンソールに表示されます。

アプリケーションのログファイル (​log4j2.xml​) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​MULE_HOME/logs/<app-name>.log​ でアプリケーションログを表示することもできます。ログパスは、アプリケーションログファイル ​log4j2.xml​ で設定できます。

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 クライアントのアクティビティを追跡します。

  • レート制限を実装して、悪用を防止し、公正な使用を確保します。

  • 開発環境、ステージング環境、本番環境で異なるポリシーを設定します。

  • ポリシー設定を定期的に見直して更新します。

使用可能なポリシーと設定についての詳細は、xInbound Policies Directoryを参照してください。

アプリケーションをデプロイする

これらをデプロイメントに使用できます。

  • CloudHub 2.0

  • Runtime Fabric

  • ハイブリッド

  • CloudHub (ポリシーを適用できないなどの制限あり)

アプリケーションのデプロイについての詳細は、デプロイメントオプションを参照してください。

次のステップ

関連情報