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

# MCP の開始方法
<a name="data-transformation-getting-started-mcp"></a>

 すべてのデータ変換エージェント API は MCP ツールとして利用できるため、IDE を離れることなく、MCP 互換 AI エージェントからプロファイルの作成、テスト変換の実行、障害のデバッグを行うことができます。

## 前提条件
<a name="data-transformation-getting-started-mcp-prerequisites"></a>
+  MCP 互換クライアント (Kiro やカーソルなど）。
+  AWS からのデータ変換エージェントの IAM アクセス許可で設定された 認証情報[セットアップ](data-transformation-setting-up.md)。

## ステップ 1: AWS MCP サーバーをインストールして設定する
<a name="data-transformation-getting-started-mcp-step1"></a>

 任意のエージェントツール (Kiro や Cursor など) に AWS MCP サーバーをインストールし、 AWS 認証情報とリージョンで設定します。インストールと設定の手順については、[AWS MCP サーバーのドキュメント](https://github.com/awslabs/mcp)を参照してください。

## ステップ 2: ツールが使用可能であることを確認する
<a name="data-transformation-getting-started-mcp-step2"></a>

 セットアップ後、データ変換エージェントのオペレーションはエージェントに呼び出し可能なツールとして表示されます。ツール名は API オペレーションに直接マッピングされます。


| ツール名 | その内容 | 
| --- | --- | 
| CreateDataTransformationProfile | DRAFT 状態のプロファイルを作成します | 
| UpdateProfileWithAgent | AI エージェントにメッセージを送信してプロファイルを編集する | 
| PublishDataTransformationProfile | 現在のドラフトをイミュータブルバージョンとして発行します | 
| GetDataTransformationProfile | プロファイルメタデータとコンテンツを取得します | 
| StartDataTransformationJob | 一括変換ジョブを開始します | 
| DescribeDataTransformationJob | ジョブのステータスと進行状況を確認します | 
| DeleteDataTransformationProfile | プロファイルメタデータとコンテンツを削除します | 
| ListDataTransformationProfiles | アカウントのプロファイルを一覧表示します | 
| ListDataTransformationJobs | 変換ジョブを一覧表示します | 

**注記**  
 同期変換オペレーション (TransformData) は REST 専用であり、MCP ツールとして表示されない場合があります。エージェントはユーザーに代わって REST コールを構築して実行できます。「ステップ 3: リクエスト形式の同期変換を使用してテストする」を参照してください。

## ステップ 3: 自然言語でツールを使用する
<a name="data-transformation-getting-started-mcp-step3"></a>

 接続したら、MCP を介してデータ変換エージェントとやり取りする独自のエージェントと通信して、プロファイルのライフサイクル全体を駆動します。
+  AWS 「」というスタータープロファイルから「Cardiology Profile」という C-CDA プロファイルを作成します。→ エージェントは CreateDataTransformationProfile を呼び出し、プロファイル ID を返します。
+  「薬剤セクションのマッピングを追加します。」 → エージェントは UpdateProfileWithAgent を呼び出し、提案された変更を表示し、確認を求めます。
+  「プロファイルを公開し、s3://my-bucket/ccda-files/ に対して一括ジョブを開始する」 → エージェントは PublishDataTransformationProfile を呼び出してから StartDataTransformationJob を呼び出します。
+  「最後のジョブのステータスは何ですか？」 → エージェントは DescribeDataTransformationJob を呼び出し、進捗状況を報告します。
+  「12 レコード失敗: 何が起こったか？」 → エージェントはエラーを検査し、プロファイルの修正を提案します。

 セッションは複数のターンにわたってコンテキストを保持するため、エージェントはワークフロー全体でプロファイル、会話、および以前の指示を記憶します。

## トラブルシューティング
<a name="data-transformation-getting-started-mcp-troubleshooting"></a>


| 症状 | Fix | 
| --- | --- | 
| セットアップ後にツールが表示されない |  AWS MCP サーバーが実行されていて、正しいリージョンに設定されていることを確認します。MCP クライアントを再起動します。 | 
| ツール呼び出しの AccessDeniedException  | healthlake:\*DataTransformation\* アクションを IAM ポリシーに追加します。「[セットアップ](data-transformation-setting-up.md)」を参照してください。 | 
| ResourceNotFoundException | MCP サーバー設定のリージョンが、プロファイルが存在するリージョンと一致していることを確認します。 |