MCP 시작하기

모든 Data Transformation Agent API는 MCP 도구로 사용할 수 있으므로 IDE를 벗어나지 않고도 MCP 호환 AI 에이전트에서 프로필을 작성하고, 테스트 변환을 실행하고, 실패를 디버깅할 수 있습니다.

사전 조건

선호하는 에이전트 도구(예: Kiro 또는 Cursor)에 AWS MCP 서버를 설치하고 자격 AWS 증명 및 리전으로 구성합니다. 설치 및 구성 지침은 AWS MCP 서버 설명서를 참조하세요.

설정 후 Data Transformation Agent 작업은 에이전트에 호출 가능한 도구로 표시됩니다. 도구 이름은 API 작업에 직접 매핑됩니다.

도구 이름	하는 일
CreateDataTransformationProfile	DRAFT 상태에서 프로필을 생성합니다.
UpdateProfileWithAgent	AI 에이전트에게 메시지를 전송하여 프로필을 편집합니다.
PublishDataTransformationProfile	현재 초안을 변경할 수 없는 버전으로 게시합니다.
GetDataTransformationProfile	프로필 메타데이터 및 콘텐츠를 검색합니다.
StartDataTransformationJob	대량 변환 작업을 시작합니다.
DescribeDataTransformationJob	작업 상태 및 진행 상황을 확인합니다.
DeleteDataTransformationProfile	프로필 메타데이터 및 콘텐츠를 삭제합니다.
ListDataTransformationProfiles	계정의 프로필을 나열합니다.
ListDataTransformationJobs	변환 작업을 나열합니다.

동기화 변환 작업(TransformData)은 REST 전용이며 MCP 도구로 표시되지 않을 수 있습니다. 에이전트는 사용자를 대신하여 REST 호출을 구성하고 실행할 수 있습니다. 요청 형식에 대한 3단계: 동기화 변환으로 테스트를 참조하세요.

연결되면 MCP를 통해 데이터 변환 에이전트와 상호 작용하는 자체 에이전트와 대화하여 전체 프로필 수명 주기를 주도합니다.

“'Cardiology Profile'이라는 AWS 스타터 프로파일에서 C-CDA 프로파일을 생성합니다.” → 에이전트가 CreateDataTransformationProfile을 호출하고 프로필 ID를 반환합니다.
“투약 섹션에 대한 매핑을 추가합니다.” → 에이전트가 UpdateProfileWithAgent를 호출하고 제안된 변경 사항을 표시한 다음 확인을 요청합니다.
“프로파일을 게시하고 s3://my-bucket/ccda-files/에 대해 대량 작업을 시작합니다.” → 에이전트가 PublishDataTransformationProfile을 호출한 다음 StartDataTransformationJob을 호출합니다.
“마지막 작업의 상태는 어떻게 됩니까?” → 에이전트가 DescribeDataTransformationJob을 호출하고 진행 상황을 보고합니다.
“12개 레코드 실패: 무슨 일이 발생했나요?” → 에이전트가 오류를 검사하고 프로필 수정을 제안합니다.

세션은 컨텍스트를 여러 차례 유지하므로 에이전트는 워크플로 전체에서 프로필, 대화 및 이전 지침을 기억합니다.

증상	수정
설정 후 도구가 표시되지 않음	AWS MCP 서버가 실행 중이고 올바른 리전에 맞게 구성되어 있는지 확인합니다. MCP 클라이언트를 다시 시작합니다.
도구 호출 시 AccessDeniedException	IAM 정책에 healthlake:DataTransformation 작업을 추가합니다. 설정을(를) 참조하세요.
ResourceNotFoundException	MCP 서버 구성의 리전이 프로필이 있는 리전과 일치하는지 확인합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

SDK 및 시작하기 AWS CLI

데이터 변환 기능