MCP の開始方法

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

前提条件

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

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

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

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

接続したら、MCP を介してデータ変換エージェントとやり取りする独自のエージェントと通信して、プロファイルのライフサイクル全体を駆動します。

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

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

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

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

SDK との開始方法 AWS CLI

データ変換機能