翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# WorkSpaces アプリケーション MCP サーバー
<a name="agent-access-mcp-server"></a>

WorkSpaces アプリケーション MCP サーバーは、ストリーミングセッション中にデスクトップアプリケーションとやり取りするためのモデルコンテキストプロトコル (MCP) ツールを AI エージェントに提供するフルマネージドサービスです。エージェントは、ボタンのクリック、テキストの入力、スクロール、デスクトップのスクリーンショットの撮影を行うことができます。

## 概要
<a name="agent-access-mcp-server-overview"></a>

スタックでエージェントアクセスを有効にすると、エージェントはマネージド MCP サーバーに接続してデスクトップアプリケーションとやり取りできます。MCP サーバーは、エージェントとストリーミングセッション間の通信を処理します。エージェントは MCP ツールリクエストを送信し、サーバーはそれらをデスクトップで実行します。

MCP サーバーは AWS クラウドでホストされています。サーバーコンポーネントをインストールまたは保守する必要はありません。サーバーは、Streamable HTTP をトランスポートプロトコルとして使用します。

## MCP サーバーへの接続
<a name="agent-access-mcp-server-endpoint"></a>

エージェントは、次のエンドポイントで MCP サーバーに接続します。

```
https://agentaccess-mcp.{{region}}.api.aws/mcp
```

各リクエストには以下を含める必要があります。
+ **SigV4 署名** — すべてのリクエストは、サービス名 の IAM 認証情報を使用して署名する必要があります`agentaccess-mcp`。
+ **ストリーミング URL ヘッダー** — `CreateStreamingURL` API からのストリーミング URL は、すべてのリクエストで`X-Amzn-AgentAccess-Streaming-Session-Url`ヘッダーとして渡す必要があります。

次の Python の例は、 を使用して接続する方法を示しています`mcp-proxy-for-aws`。

```
aws_iam_streamablehttp_client(
    endpoint="https://agentaccess-mcp.{{region}}.api.aws/mcp",
    aws_service="agentaccess-mcp",
    aws_region="{{region}}",
    headers={
        "X-Amzn-AgentAccess-Streaming-Session-Url": streaming_url,
    },
)
```

他の言語の場合は、送信 MCP リクエスト用の独自の署名ロジックを記述するか、SigV4 署名をサポートする利用可能なライブラリを見つける必要があります。

の詳細については`mcp-proxy-for-aws`、GitHub の[mcp-proxy-for-aws](https://github.com/aws/mcp-proxy-for-aws)」を参照してください。

## 使用可能なツール
<a name="agent-access-mcp-server-tools"></a>

MCP サーバーには、エージェントがストリーミングセッション中にデスクトップとやり取りするための以下のツールが用意されています。すべてのツール名は `agentaccess___` プレフィックスを使用します。

### マウスツール
<a name="agent-access-mcp-tools-mouse"></a>

`left_click`  
指定された座標で左クリックを実行します。  
パラメータ: `x` (必須)`y`、 (必須）、 `modifiers` (オプション、例: `ctrl`または `ctrl+shift`)。

`double_click`  
指定された座標でダブルクリックを実行します。  
パラメータ: `x` (必須）、 `y` (必須）、 `modifiers` (オプション）。

`triple_click`  
指定された座標でトリプルクリックを実行します。  
パラメータ: `x` (必須）、 `y` (必須）、 `modifiers` (オプション）。

`right_click`  
指定された座標で右クリックを実行します。  
パラメータ: `x` (必須）、 `y` (必須）、 `modifiers` (オプション）。

`middle_click`  
指定された座標でミドルクリックを実行します。  
パラメータ: `x` (必須）、 `y` (必須）、 `modifiers` (オプション）。

`left_click_drag`  
開始座標から終了座標への左クリックドラッグを実行します。  
パラメータ: `start_x` (必須)`start_y`、 (必須）、 `end_x` (必須）、 `end_y` (必須）。

`left_mouse_down`  
指定された座標で左マウスボタンを長押しします。  
パラメータ: `x` (必須）、 `y` (必須）、 `modifiers` (オプション）。

`left_mouse_up`  
指定された座標で左マウスボタンを離します。  
パラメータ: `x` (必須）、 `y` (必須）、 `modifiers` (オプション）。

`move_pointer`  
ポインタを指定された座標に移動します。  
パラメータ: `x` (必須）、 `y` (必須）。

`scroll`  
指定された座標でマウスホイールをスクロールします。  
パラメータ: `x` (必須)`y`、 (必須 — `scroll_direction` `Up`、`Down`、、または `Right`)`Left`、 `scroll_amount` (必須 — ティックで、120 ティックは 1 ホイールノッチに相当）、 `modifiers` (オプション）。

### キーボードツール
<a name="agent-access-mcp-tools-keyboard"></a>

`type_text`  
文字ごとにキーボードイベントをシミュレートしてテキストを入力します。  
パラメータ: `text` (必須 — 最大 10,000 文字）。

`key`  
キーまたはキーの組み合わせを押します。  
パラメータ: `keys` (必須 — 、`a``ctrl+c`、 など`+`、 によって結合された単一のキーまたは組み合わせ`ctrl+shift+s`)。

`hold_key`  
指定された期間、キーまたはキーの組み合わせを保持します。  
パラメータ: `keys` (必須）、 `duration` (必須 — 1～30 秒）。

### 画面ツール
<a name="agent-access-mcp-tools-screen"></a>

`screenshot`  
デスクトップのスクリーンショットをキャプチャします。返される画像ディメンションは、すべてのマウスツールの座標空間を定義します。  
パラメータ: `include_cursor` (オプション — デフォルトは `false`)。

## 互換性のあるフレームワーク
<a name="agent-access-mcp-server-frameworks"></a>

Streamable HTTP および SigV4 署名をサポートする任意の MCP 互換エージェントフレームワークから WorkSpaces アプリケーション MCP サーバーに接続できます。以下のフレームワークがテストされています。
+ [Strands Agents SDK](https://strandsagents.com/docs/user-guide/concepts/tools/mcp-tools/) — ネイティブ MCP クライアントサポートを提供します。
+ [mcp-proxy-for-aws](https://github.com/aws/mcp-proxy-for-aws) — Python での MCP リクエストの SigV4 署名を処理する軽量トランスポート。

## モニタリング
<a name="agent-access-mcp-server-monitoring"></a>

エージェントのアクティビティは、次のサービスを通じてモニタリングできます。
+ **AWS CloudTrail** — エージェントセッションイベントは CloudTrail に記録されます。エージェントが接続するタイミング、使用するツール、セッションが終了するタイミングを表示できます。ツール呼び出しはデータイベントであり、データイベントをログに記録する証跡を設定する必要があります。詳細については、*CloudTrail ユーザーガイド*」の[「データイベントのログ記録](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html)」を参照してください。
+ **CloudWatch** — エージェントセッションの運用メトリクスは CloudWatch で利用できます。
+ **Amazon S3** — スクリーンショットストレージを設定する場合、エージェントセッション中にキャプチャされたスクリーンショットは、指定した Amazon S3 バケットで使用できます。スクリーンショットは、次のキー形式で保存されます。

  ```
  agentaccess/screenshots/year={{YYYY}}/month={{MM}}/day={{DD}}/{{session-id}}/{{timestamp}}.png
  ```

  パスの UUID は WorkSpaces アプリケーションストリーミングセッション ID です。

## はじめに
<a name="agent-access-mcp-server-get-started"></a>

WorkSpaces アプリケーション MCP サーバーの使用を開始するには、「」を参照してください[WorkSpaces アプリケーションへのアクセス権をエージェントに付与する](getting-started-agent-access.md)。