MCP サーバーのテスト

UiPath MCP Inspector、オープンソースの MCP Inspector、cURL、または Postman を使用して、任意の AI クライアントの外部で UiPath MCP サーバーを直接テストします。

MCP サーバーを AI クライアントに接続する前に、接続とツールの動作を直接テストします。AI クライアントの外部でテストすることで、問題の発生場所を MCP サーバー、その認証、または AI クライアントのいずれで発生しているのかを切り分けることができます。

UiPath MCP インスペクターを使用してテストする

UiPath MCP インスペクターは Orchestrator 内で実行され、別途設定する必要はありません。

インスペクターにアクセスする

1. [MCP サーバー] ページで、MCP サーバーを選択します。

2. インスペクター アイコンを選択します。

   

ツールを呼び出す

1. リストからツールを選択します。

2. ツールの入力パラメーターを入力します。

3. [ 呼び出し ] を選択して結果を調べます。

   

MCP インスペクター (CLI) を使用したテスト

MCP インスペクターは、Streamable HTTP 経由で任意の MCP サーバーに接続するオープンソース ツールです。

前提条件

• npx コマンドを実行するために Node.js がインストールされます。
• MCP サーバーの URL です。Orchestrator の [ MCP サーバー ] ページからアクセスできます。
• ベアラー トークンです。最も簡単なオプションとして、 個人用アクセス トークン (PAT) を使用します。サポートされているその他のトークンの種類については、「 MCP サーバー認証」をご覧ください。

1. ターミナルから次のコマンドを実行します。これは、macOS、Linux、Windows (PowerShell 7 または Git Bash) でも同じです。

   npx @modelcontextprotocol/inspector@0.22.0
   

   このコマンドを実行すると、ブラウザーで Inspector Web UI が開きます。

2. [MCP サーバーの URL] に入力します。

3. トランスポートの種類として [ストリーミング可能な HTTP ] を選択します。

4. [ 認証 ] セクションで、トークンを の形式 Bearer <token>入力します。

5. [接続] を選択します。

   

結果

接続すると、以下の操作を行うことができます。

• ツールのリストを表示して、すべてのツールが正しい JSON スキーマで表示されていることを確認します。
• ツールを呼び出して、テスト入力を使用してツールを実行し、応答を検査します。
• セッションを視聴して、 initialize → initialized → request のライフサイクルをリアルタイムで確認します。
• スキーマを検証し、型の不一致を LLM に到達する前に検出します。

cURL を使用したテスト

cURL を使用して未加工の JSON-RPC 要求を送信し、ヘッダーを含む完全な要求/応答サイクルを調べます。

前提条件

• ベアラー トークンです。サポートされている方法については、「 MCP サーバー認証 」をご覧ください。
• MCP サーバーの URL です。Orchestrator の [ MCP サーバー ] ページからアクセスできます。

1. トークンとサーバー URL を環境変数として設定します。

   TOKEN="your-bearer-token"
   SERVER_URL="https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folder}/{slug}"
   

2. MCP セッションを初期化します。

   curl -v -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "initialize",
       "params": {
         "protocolVersion": "2025-06-18",
         "capabilities": {},
         "clientInfo": {"name": "curl-test", "version": "1.0"}
       }
     }'
   

   -v フラグを使用して応答ヘッダーを表示し、mcp-session-id ヘッダーの値を保存します。以降のすべての要求に Task Mining が必要です。

   注:

   UiPath MCP サーバーは、プロトコル バージョン 2025-06-18をサポートしています。サーバーはサポートされているバージョンで応答するため、 2025-11-25 (最新の MCP 仕様バージョン) の送信は機能する可能性がありますが、サポートされていない動作を避けるには 2025-06-18 を使用してください。

3. 初期化された通知を送信します。

   curl -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -H "mcp-session-id: $SESSION_ID" \
     -d '{"jsonrpc": "2.0", "method": "notifications/initialized"}'
   

   サーバーは本文なしで 202 Accepted で応答します。サーバーは、ツールの要求を処理する前に、この通知を必要とします。

4. 利用可能なツールを一覧表示します。

   curl -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "mcp-session-id: $SESSION_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "jsonrpc": "2.0",
       "id": 2,
       "method": "tools/list"
     }'
   

5. ツールを呼び出します。

   curl -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "mcp-session-id: $SESSION_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "jsonrpc": "2.0",
       "id": 3,
       "method": "tools/call",
       "params": {
         "name": "add",
         "arguments": {"a": 5, "b": 3}
       }
     }'
   

6. セッションを閉じます。

   curl -X DELETE "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "mcp-session-id: $SESSION_ID"
   

Postman を使用したテスト

Postman は MCP 要求をネイティブにサポートします。

1. コレクションに MCP 要求を作成します。
2. Streamable HTTP の場合は、トランスポートとして [HTTP ] を選択します。
3. [MCP サーバーの URL] に入力します。
4. [ 認可 ] タブで、ご使用のトークンによる ベアラー トークン 認証を設定します。
5. [接続] を選択します。

Postman は、 initialize や notifications/initializedを含むセッションのライフサイクルを自動的に処理します。

ヒント:

代わりに、未加工の JSON-RPC 要求を手動で送信するには (たとえば、各要求と応答を個別に制御するには)、Postman をプレーンな REST クライアントとして使用し、「 cURL を使用したテスト」と同じ要求フローに従います。