Connetti il tuo IDE a Dataplex Universal Catalog

Questo documento mostra come utilizzare MCP Toolbox for Databases per connettere Dataplex Universal Catalog a una serie di ambienti di sviluppo integrati (IDE) e strumenti per sviluppatori che supportano il protocollo Model Context Protocol (MCP). Puoi quindi utilizzare gli agenti AI negli strumenti esistenti per scoprire gli asset di dati in Dataplex Universal Catalog.

MCP è un protocollo aperto per connettere modelli linguistici di grandi dimensioni (LLM) a origini dati come Dataplex Universal Catalog. Per ulteriori informazioni su MCP, consulta Introduzione al Model Context Protocol.

Questa guida mostra la procedura di connessione per i seguenti IDE:

• Interfaccia a riga di comando di Gemini
• Gemini Code Assist
• Claude code
• Claude desktop
• Cline (estensione VS Code)
• Cursore
• Visual Studio Code (Copilot)
• Windsurf (in precedenza Codeium)

Prima di iniziare

1. In the Google Cloud console, go to the project selector page.

   Go to project selector

2. Select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

3. Verify that billing is enabled for your Google Cloud project.

4. If you're using a local shell, then create local authentication credentials for your user account:

   gcloud auth application-default login

   You don't need to do this if you're using Cloud Shell.

   If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Installare la casella degli strumenti MCP

1. Scarica l'ultima versione di MCP Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare MCP Toolbox v0.12.0 o versioni successive.

   Linux/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox
   

   Sostituisci VERSION con la versione di MCP Toolbox, ad esempio v0.12.0.

   macOS (Darwin)/arm64

   curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/arm64/toolbox
   

   Sostituisci VERSION con la versione di MCP Toolbox, ad esempio v0.12.0.

   macOS (Darwin)/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/amd64/toolbox
   

   Sostituisci VERSION con la versione di MCP Toolbox, ad esempio v0.12.0.

   Windows/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/VERSION/windows/amd64/toolbox
   

   Sostituisci VERSION con la versione di MCP Toolbox, ad esempio v0.12.0.

2. Rendi eseguibile il file binario:

   chmod +x toolbox
   

3. Verifica l'installazione:

   ./toolbox --version
   

   Un'installazione riuscita restituisce il numero di versione, ad esempio 0.10.0.

Configura il client MCP

Interfaccia a riga di comando di Gemini

1. Installa l'interfaccia a riga di comando di Gemini.
2. Nella directory di lavoro, crea una cartella denominata .gemini. All'interno, crea un file settings.json.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

     {
       "mcpServers": {
         "dataplex": {
           "command": "./PATH/TO/toolbox",
           "args": ["--prebuilt","dataplex","--stdio"],
           "env": {
             "DATAPLEX_PROJECT": "PROJECT_ID"
           }
         }
       }
     }
     

Gemini Code Assist

1. In VS Code, installa l'estensione Gemini Code Assist.
2. Attiva la modalità Agente nella chat di Gemini Code Assist.
3. Nella directory di lavoro, crea una cartella denominata .gemini. All'interno, crea un file settings.json.
4. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

     {
       "mcpServers": {
         "dataplex": {
           "command": "./PATH/TO/toolbox",
           "args": ["--prebuilt","dataplex","--stdio"],
           "env": {
             "DATAPLEX_PROJECT": "PROJECT_ID"
           }
         }
       }
     }
     

Codice Claude

1. Installa Claude Code.
2. Crea il file .mcp.json nella directory principale del progetto, se non esiste.
3. Aggiungi la configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

     {
       "mcpServers": {
         "dataplex": {
           "command": "./PATH/TO/toolbox",
           "args": ["--prebuilt","dataplex","--stdio"],
           "env": {
             "DATAPLEX_PROJECT": "PROJECT_ID"
           }
         }
       }
     }
     

Claude desktop

1. Apri Claude Desktop e vai a Impostazioni.
2. Per aprire il file di configurazione, nella scheda Sviluppatore, fai clic su Modifica configurazione.
3. Aggiungi la configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

     {
       "mcpServers": {
         "dataplex": {
           "command": "./PATH/TO/toolbox",
           "args": ["--prebuilt","dataplex","--stdio"],
           "env": {
             "DATAPLEX_PROJECT": "PROJECT_ID"
           }
         }
       }
     }
     

4. Riavvia Claude desktop.
   Nella nuova schermata di chat viene visualizzata un'icona MCP con il nuovo server MCP.

Cline

1. In VS Code, apri l'estensione Cline e poi fai clic sull'icona MCP Servers.
2. Per aprire il file di configurazione, tocca Configura server MCP.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

     {
       "mcpServers": {
         "dataplex": {
           "command": "./PATH/TO/toolbox",
           "args": ["--prebuilt","dataplex","--stdio"],
           "env": {
             "DATAPLEX_PROJECT": "PROJECT_ID"
           }
         }
       }
     }
     

   Dopo la connessione riuscita del server, viene visualizzato uno stato attivo verde.

Cursore

1. Crea la directory .cursor nella root del progetto se non esiste.
2. Crea il file .cursor/mcp.json se non esiste e aprilo.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

     {
       "mcpServers": {
         "dataplex": {
           "command": "./PATH/TO/toolbox",
           "args": ["--prebuilt","dataplex","--stdio"],
           "env": {
             "DATAPLEX_PROJECT": "PROJECT_ID"
           }
         }
       }
     }
     

4. Apri Cursore e vai a Impostazioni>Impostazioni cursore >MCP. Quando il server si connette, viene visualizzato uno stato attivo verde.

VS Code (Copilot)

1. Apri VS Code e crea la directory .vscode nella radice del progetto se non esiste.
2. Crea il file .vscode/mcp.json se non esiste e aprilo.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

     {
       "servers": {
         "dataplex": {
           "command": "./PATH/TO/toolbox",
           "args": ["--prebuilt","dataplex","--stdio"],
           "env": {
             "DATAPLEX_PROJECT": "PROJECT_ID"
           }
         }
       }
     }
     

Windsurf

1. Apri Windsurf e vai all'assistente Cascade.
2. Per aprire il file di configurazione, fai clic sull'icona di MCP, quindi fai clic su Configura.
3. Aggiungi la seguente configurazione, sostituisci le variabili di ambiente con i tuoi valori e salva:

     {
       "mcpServers": {
         "dataplex": {
           "command": "./PATH/TO/toolbox",
           "args": ["--prebuilt","dataplex","--stdio"],
           "env": {
             "DATAPLEX_PROJECT": "PROJECT_ID"
           }
         }
       }
     }
     

Utilizzare gli strumenti

Il tuo strumento di AI è ora connesso a Dataplex Universal Catalog tramite MCP. Prova a chiedere all'assistente AI di trovare alcuni asset di dati come set di dati BigQuery, istanze Cloud SQL e altri.

Per l'LLM è disponibile il seguente strumento:

• dataplex_search_entries: cerca asset di dati
• dataplex_lookup_entry: recupera i metadati (ad esempio schema, utilizzo, panoramica aziendale e contatti) degli asset di dati
• dataplex_search_aspect_types: cerca tipi di aspetto

Nota: gli strumenti predefiniti sono la versione 1.0 o precedente e potrebbero contenere differenze tra le versioni.

(Facoltativo) Aggiungi istruzioni di sistema

Le istruzioni di sistema sono un modo per fornire linee guida specifiche all'LLM, aiutandolo a comprendere il contesto e a rispondere in modo più accurato. Configura le istruzioni di sistema in base al prompt di sistema consigliato.

Nota: ti consigliamo vivamente questo passaggio facoltativo per ottenere un'esperienza migliore ed evitare lavoro aggiuntivo, ad esempio la progettazione di un agente personalizzato.

Per maggiori informazioni su come configurare le istruzioni, consulta Utilizzare le istruzioni per ottenere modifiche AI che seguono il tuo stile di codifica.