UIP MCP

uip mcp では、CLI を モデル コンテキスト プロトコル サーバーとして公開し、MCP 対応クライアント (Claude Desktop、Cursor、VS Code MCP ホストなど) が任意の uip サブコマンドをツールとして呼び出すことができます。

注:

スキルは、AI コーディング エージェントに UiPath CLI の使用方法を教えるための主要なパスです。詳しくは、「uip skillsスキル」と「スキル」をご覧ください。MCPは、スキルをサポートしていないクライアントや、MCPスタイルのツール呼び出しを好むクライアントのための代替手段として提供されています。エージェントがスキルをサポートしている場合は、スキルを優先します。

概要

uip mcp serve

uip mcp serve 、サーバー プロセス自体のグローバル オプション ( [--output]、[ --output-filter]、[ --log-level]、[ --log-file]) が優先されます。クライアントに公開するツールは、任意のCLIコマンド文字列を受け入れ、その組み合わせのstdout/stderrを返します。終了コードは 標準コントラクトに従います。

uip mcp serve

stdio (改行で区切られた JSON-RPC) で MCP サーバーを起動します。ネットワークリスナー、HTTP トランスポート、ポート設定はありません — stdio は 1.x でサポートされている唯一のトランスポートです。

引数

設定はありません。

オプション

None. The server runs until the stdio transport is closed by the client (usually when the host application quits).

動作

• サーバーは、1 つの引数を取る run_commandという 1 つのツールをアドバタイズします。
  • command (string) — uip プレフィックスなしで実行する CLI コマンド。例: "login status --output json"
• サーバーは、起動時にインストールされたすべての uip サブコマンドを列挙し、MCPツールの説明にレンダリングされたコマンドカタログを含めます。mcp サブコマンドと help サブコマンドはそのカタログから除外され、クライアントはサーバーに別の MCP サーバーを起動するように要求することはできません。
• run_command呼び出しごとに、CLI は要求されたコマンドを子呼び出しで実行し、組み合わせた stdout/stderr を返します。子が 0 以外で終了した場合、または 0 の終了コードでエラー エンベロープを stderr に書き込んだ場合 (コマンドが終了コードを変更せずに失敗を報告するまれなケース)、結果に isError: true フラグが付けられ、プレフィックスが付けられ Error (exit code N):。

例 (シェルからサーバーを起動する - 通常、MCPクライアントがこれを起動します):

uip mcp serve

MCP クライアントの構成

すべての構成で同じコマンド/引数が使用されます。サーバー名(下記uipath )は任意です。

Claude Desktop — 編集 claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "uipath": {
      "command": "uip",
      "args": ["mcp", "serve"]
    }
  }
}

保存後、Claude Desktop を再起動します。

Claude Code — CLI を使用して追加します。

claude mcp add uipath -- uip mcp serve

カーソル — .cursor/mcp.json (プロジェクトローカル) またはカーソルグローバル MCP 構成を編集します。

{
  "mcpServers": {
    "uipath": {
      "command": "uip",
      "args": ["mcp", "serve"]
    }
  }
}

VS Code — 編集 .vscode/mcp.json:

{
  "servers": {
    "uipath": {
      "command": "uip",
      "args": ["mcp", "serve"]
    }
  }
}

ライフ サイクル

MCP サーバーには、スタンドアロンの stop コマンドはありません。MCP クライアントの子プロセスとして存在し、次の場合に終了します。

• クライアントが stdio 接続を閉じる。
• ホスト アプリケーションが終了する、または
• クライアントの構成からサーバー エントリを削除し、リロードします。

認証とテナント コンテキスト

uip mcp serve では資格情報は管理されません。すべての run_command 呼び出しは、対話型シェルと同じ格納されたセッションを読み取るため、認証を必要とするコマンドを呼び出すようにエージェントに要求する前に、 uip login を個別に実行する必要があります。セッションが存在しない場合、ツールの結果には通常の AuthenticationError ペイロードが含まれます ( 「終了コード」を参照)。

データシェイプ

ツールの結果は、MCP のツール呼び出しコントラクトに従います。成功について:

{
  "content": [
    { "type": "text", "text": "<combined stdout/stderr>" }
  ],
  "isError": false
}

失敗した場合、 isError は true され、 text の先頭に Error (exit code N):が付きます。内部テキストは通常のCLI出力です(呼び出し元が --output jsonを要求した場合はJSON、それ以外の場合はデフォルトの形式)。

考慮事項

• JSON は、常に MCP 呼び出し内から要求してください。command文字列に--output jsonを渡すことで、エージェントは表ではなく構造化データを受け取ることができます。
• 破壊的なコマンドのフィルタリングはありません。run_command ツールは、logout、tools uninstall、Orchestrator のステートを変更するツールなど、任意の uip サブコマンドを呼び出すことができます。MCP サーバーを認証済みシェルとして扱い、それに応じてエージェントのスコープを設定します。
• helpとmcpはカタログで非表示になりますが、クライアントで呼び出すことはできます。mcp serveが別のrun_commandを介して再帰的に呼び出されることを妨げるものは何もありません。これは、外部サーバーがSTDIOを制御するため、実際には何もしません。

関連

• uip skills — AI 連携のプライマリ パスです。
• スキル — エージェントの人間工学において、生の MCP アクセスよりもスキルが好まれる理由。
• 認証 — run_command 継承するセッションです。
• グローバル オプション — MCP 呼び出し内の --output json 。