Conectar tu IDE a Dataplex Universal Catalog

En este documento se explica cómo usar MCP Toolbox for Databases para conectar tu catálogo universal de Dataplex a varios entornos de desarrollo integrados (IDEs) y herramientas para desarrolladores que admiten Model Context Protocol (MCP). Después, puedes usar agentes de IA en tus herramientas para descubrir recursos de datos en el catálogo universal de Dataplex.

MCP es un protocolo abierto para conectar modelos de lenguaje de gran tamaño (LLMs) a fuentes de datos, como el catálogo universal de Dataplex. Para obtener más información sobre MCP, consulta el artículo Introducción a Model Context Protocol.

En esta guía se muestra el proceso de conexión de los siguientes IDEs:

• Gemini CLI
• Gemini Code Assist
• Código de Claude
• Claude para ordenadores
• Cline (extensión de VS Code)
• Cursor
• Visual Studio Code (Copilot)
• Windsurf (antes Codeium)

Antes de empezar

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.

Instalar la caja de herramientas de MCP

1. Descarga la versión más reciente de la caja de herramientas de MCP como archivo binario. Selecciona el binario que corresponda a tu sistema operativo y a la arquitectura de tu CPU. Debes usar MCP Toolbox v0.12.0 o una versión posterior.

   Linux/amd64

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

   Sustituye VERSION por la versión de la caja de herramientas de MCP (por ejemplo, v0.12.0).

   macOS (Darwin)/arm64

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

   Sustituye VERSION por la versión de la caja de herramientas de MCP (por ejemplo, v0.12.0).

   macOS (Darwin)/amd64

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

   Sustituye VERSION por la versión de la caja de herramientas de MCP (por ejemplo, v0.12.0).

   Windows/amd64

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

   Sustituye VERSION por la versión de la caja de herramientas de MCP (por ejemplo, v0.12.0).

2. Haz que el archivo binario sea ejecutable:

   chmod +x toolbox
   

3. Verifica la instalación:

   ./toolbox --version
   

   Si la instalación se realiza correctamente, se devuelve el número de versión (por ejemplo, 0.10.0).

Configurar el cliente de MCP

Gemini CLI

1. Instala la CLI de Gemini.
2. En tu directorio de trabajo, crea una carpeta llamada .gemini. Dentro de esa carpeta, crea un archivo settings.json.
3. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

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

Gemini Code Assist

1. En VS Code, instala la extensión Gemini Code Assist.
2. Habilita el modo Agente en el chat de Gemini Code Assist.
3. En tu directorio de trabajo, crea una carpeta llamada .gemini. Dentro de esa carpeta, crea un archivo settings.json.
4. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

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

Código de Claude

1. Instala Claude Code.
2. Crea el archivo .mcp.json en la raíz de tu proyecto, si no existe.
3. Añade la configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

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

Claude para ordenadores

1. Abre Claude Desktop y ve a Configuración.
2. Para abrir el archivo de configuración, en la pestaña Desarrollador, haz clic en Editar configuración.
3. Añade la configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

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

4. Reinicia Claude para ordenadores.
   En la nueva pantalla de chat se muestra un icono de MCP con el nuevo servidor MCP.

Cline

1. En VS Code, abre la extensión Cline y, a continuación, haz clic en el icono Servidores MCP.
2. Para abrir el archivo de configuración, toca Configurar servidores MCP.
3. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

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

   Si el servidor se conecta correctamente, aparecerá el estado activo en verde.

Cursor

1. Crea el directorio .cursor en la raíz de tu proyecto si no existe.
2. Crea el archivo .cursor/mcp.json si no existe y ábrelo.
3. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

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

4. Abre Cursor y ve a Configuración>Configuración del cursor > MCP. Cuando el servidor se conecta, aparece el estado activo en verde.

VS Code (Copilot)

1. Abre VS Code y crea el directorio .vscode en la raíz de tu proyecto si no existe.
2. Crea el archivo .vscode/mcp.json si no existe y ábrelo.
3. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

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

Windsurf

1. Abre Windsurf y ve al asistente de cascada.
2. Para abrir el archivo de configuración, haz clic en el icono de MCP y, a continuación, en Configurar.
3. Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

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

Usar las herramientas

Tu herramienta de IA ahora está conectada a Dataplex Universal Catalog mediante MCP. Prueba a pedirle a tu asistente de IA que busque algunos recursos de datos, como conjuntos de datos de BigQuery, instancias de Cloud SQL y otros.

La LLM tiene acceso a la siguiente herramienta:

• dataplex_search_entries busca recursos de datos
• dataplex_lookup_entry recupera metadatos (por ejemplo, esquema, uso, resumen empresarial y contactos) de recursos de datos.
• dataplex_search_aspect_types: busca tipos de aspectos.

Nota: Las herramientas precompiladas son de la versión 1.0 o anteriores y pueden contener diferencias entre versiones.

Opcional: Añade instrucciones del sistema

Las instrucciones del sistema son una forma de proporcionar directrices específicas al LLM, lo que le ayuda a entender el contexto y a responder con mayor precisión. Configura las instrucciones del sistema según la petición del sistema recomendada.

Nota: Te recomendamos encarecidamente que sigas este paso opcional para disfrutar de una mejor experiencia y evitar trabajo adicional, como diseñar tu propio agente.

Para obtener más información sobre cómo configurar las instrucciones, consulta Usar instrucciones para obtener ediciones de IA que sigan tu estilo de programación.