Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Guida introduttiva a MCP
<a name="data-transformation-getting-started-mcp"></a>

 Ogni API di Data Transformation Agent è disponibile come strumento MCP, quindi puoi creare profili, eseguire conversioni di test ed eseguire il debug degli errori da un agente MCP-compatible AI senza uscire dall'IDE. 

## Prerequisiti
<a name="data-transformation-getting-started-mcp-prerequisites"></a>
+  Un MCP-compatible client (come Kiro o Cursor). 
+  AWS credenziali configurate con le autorizzazioni IAM di Data Transformation Agent da. [Configurazione](data-transformation-setting-up.md) 

## Fase 1: Installare e configurare AWS Server MCP
<a name="data-transformation-getting-started-mcp-step1"></a>

 Installa il server AWS MCP nel tuo strumento agentico preferito (come Kiro o Cursor) e configuralo con le tue credenziali e la tua regione. AWS [Per le istruzioni di installazione e configurazione, consultate la documentazione del server MCP.AWS](https://github.com/awslabs/mcp) 

## Fase 2: Verificare che gli strumenti siano disponibili
<a name="data-transformation-getting-started-mcp-step2"></a>

 Dopo la configurazione, le operazioni di Data Transformation Agent vengono visualizzate come strumenti richiamabili nell'agente. I nomi degli strumenti si riferiscono direttamente alle operazioni dell'API: 


| Nome dello strumento | Cosa fa | 
| --- | --- | 
| CreateDataTransformationProfile | Crea un profilo in stato DRAFT | 
| UpdateProfileWithAgent | Invia un messaggio all'agente AI per modificare un profilo | 
| PublishDataTransformationProfile | Pubblica la bozza corrente come versione immutabile | 
| GetDataTransformationProfile | Recupera i metadati e il contenuto del profilo | 
| StartDataTransformationJob | Avvia un processo di conversione in blocco | 
| DescribeDataTransformationJob | Controlla lo stato e l'avanzamento del lavoro | 
| DeleteDataTransformationProfile | Elimina i metadati e il contenuto del profilo | 
| ListDataTransformationProfiles | Elenca i profili presenti nel tuo account | 
| ListDataTransformationJobs | Elenca i lavori di trasformazione | 

**Nota**  
 L'operazione di conversione di sincronizzazione (TransformData) è REST-only e potrebbe non apparire come uno strumento MCP. Il tuo agente può creare ed eseguire la chiamata REST per tuo conto: vedi Fase 3: Test con conversione di sincronizzazione per il formato della richiesta. 

## Fase 3: Usa gli strumenti in linguaggio naturale
<a name="data-transformation-getting-started-mcp-step3"></a>

 Una volta connesso, gestisci l'intero ciclo di vita del profilo parlando con il tuo agente, che interagisce con Data Transformation Agent tramite MCP: 
+  «Crea un C-CDA profilo dal profilo AWS iniziale chiamato 'Cardiology Profile'». → L'agente chiama CreateDataTransformationProfile e restituisce l'ID del profilo. 
+  «Aggiungi una mappatura per la sezione Farmaci». → L'agente chiama UpdateProfileWithAgent, mostra la modifica proposta e chiede conferma. 
+  «Pubblica il profilo e avvia un lavoro collettivo su s3://my - bucket/ccda -files/» → L'agente chiama quindi. PublishDataTransformationProfile StartDataTransformationJob 
+  «Qual è lo stato del mio ultimo lavoro?» → L'agente chiama DescribeDataTransformationJob e segnala i progressi. 
+  «12 record falliti: cosa è successo?» → L'agente controlla gli errori e propone una correzione del profilo. 

 Le sessioni mantengono il contesto in più turni, in modo che l'agente ricordi il profilo, la conversazione e le istruzioni precedenti durante tutto il flusso di lavoro. 

## Risoluzione dei problemi
<a name="data-transformation-getting-started-mcp-troubleshooting"></a>


| Caratteristiche | Correggi | 
| --- | --- | 
| Gli strumenti non vengono visualizzati dopo la configurazione | Verifica che il server AWS MCP sia in esecuzione e configurato per la regione corretta. Riavvia il client MCP. | 
| AccessDeniedException sulle chiamate agli strumenti | Aggiungi le azioni healthlake: \* DataTransformation \* alla tua policy IAM. Per informazioni, consulta [Configurazione](data-transformation-setting-up.md). | 
| ResourceNotFoundException | Assicurati che la regione nella configurazione del tuo server MCP corrisponda alla regione in cui esistono i tuoi profili. |