기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# MCP 시작하기
<a name="data-transformation-getting-started-mcp"></a>

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

## 사전 조건
<a name="data-transformation-getting-started-mcp-prerequisites"></a>
+  MCP 호환 클라이언트(예: Kiro 또는 Cursor).
+  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>

 설정 후 Data Transformation Agent 작업은 에이전트에 호출 가능한 도구로 표시됩니다. 도구 이름은 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를 통해 데이터 변환 에이전트와 상호 작용하는 자체 에이전트와 대화하여 전체 프로필 수명 주기를 주도합니다.
+  “'Cardiology Profile'이라는 AWS 스타터 프로파일에서 C-CDA 프로파일을 생성합니다.” → 에이전트가 CreateDataTransformationProfile을 호출하고 프로필 ID를 반환합니다.
+  “투약 섹션에 대한 매핑을 추가합니다.” → 에이전트가 UpdateProfileWithAgent를 호출하고 제안된 변경 사항을 표시한 다음 확인을 요청합니다.
+  “프로파일을 게시하고 s3://my-bucket/ccda-files/에 대해 대량 작업을 시작합니다.” → 에이전트가 PublishDataTransformationProfile을 호출한 다음 StartDataTransformationJob을 호출합니다.
+  “마지막 작업의 상태는 어떻게 됩니까?” → 에이전트가 DescribeDataTransformationJob을 호출하고 진행 상황을 보고합니다.
+  “12개 레코드 실패: 무슨 일이 발생했나요?” → 에이전트가 오류를 검사하고 프로필 수정을 제안합니다.

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

## 문제 해결
<a name="data-transformation-getting-started-mcp-troubleshooting"></a>


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