A partir del 10 de abril de 2026, Dataplex Universal Catalog ahora se llama Knowledge Catalog. Los nombres de la API, la biblioteca cliente, la CLI y IAM no cambiaron. Para obtener más información, consulta Presentamos Google Cloud Knowledge Catalog.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Usa Knowledge Catalog con MCP, Gemini y otros agentes

En esta página, se explica cómo conectar tu instancia de Knowledge Catalog (anteriormente Dataplex Universal Catalog) a herramientas para desarrolladores, como Gemini CLI. Conectar Knowledge Catalog a estas herramientas permite el descubrimiento de datos y la administración de recursos basados en IA directamente en tu herramienta.

Para conectar el linaje de datos a las herramientas para desarrolladores con un servidor local de MCP Toolbox, consulta Usa el linaje de datos con el servidor local de MCP Toolbox.

Para obtener una experiencia integrada de línea de comandos, te recomendamos que uses la extensión dedicada de Knowledge Catalog para Gemini CLI. La extensión agrupa las habilidades subyacentes directamente en la extensión, lo que simplifica la configuración.

Como alternativa, puedes conectar otros IDEs y herramientas para desarrolladores que admitan MCP con un MCP Toolbox local para bases de datos. Luego, puedes usar agentes de IA en tu IDE existente para descubrir recursos de datos en Knowledge Catalog. Para obtener más información sobre MCP, consulta Introducción al Protocolo de contexto del modelo.

En esta guía, se demuestra el proceso de conexión para las siguientes herramientas:

Gemini CLI (a través de la extensión)
Gemini Code Assist
Claude Code
Claude para computadoras de escritorio
Codex
Cline (extensión de VS Code)
Cursor
Visual Studio Code (Copilot)
Windsurf (anteriormente Codeium)

Acerca de Gemini CLI y las extensiones

Gemini CLI es un agente de IA conversacional de código abierto de Google que acelera los flujos de trabajo de desarrollo y ayuda con la programación, la depuración, la exploración de datos y la creación de contenido. Ofrece una experiencia basada en agentes para interactuar con los servicios de Data Cloud, como Knowledge Catalog, y otras bases de datos populares de código abierto.

Para obtener más información sobre Gemini CLI, consulta la documentación de Gemini CLI.

¿Cómo funcionan las extensiones de Gemini CLI?

Las extensiones amplían las capacidades de Gemini CLI, lo que le permite conectarse a servicios específicos Google Cloud y otras herramientas, y controlarlos. Proporcionan a Gemini contexto y comprensión de la API, lo que permite la interacción conversacional. Puedes cargar extensiones de Gemini CLI desde URLs de GitHub, directorios locales o registros. Estas extensiones ofrecen nuevas habilidades, comandos de barra y mensajes. Estos son independientes de las extensiones de IDE, como Gemini Code Assist, que se integran con MCP Toolbox.

¿Qué herramientas de MCP proporciona Knowledge Catalog?

La extensión de Knowledge Catalog para Gemini CLI integra la IA en tus tareas de descubrimiento y administración de datos. Puedes interactuar con Knowledge Catalog usando instrucciones en lenguaje natural en tu terminal.

Para ver todas las habilidades disponibles, consulta las habilidades de Knowledge Catalog en GitHub.

Para obtener más información sobre la extensión de Knowledge Catalog, consulta la Extensión de Gemini CLI: Knowledge Catalog.

Roles obligatorios

Para obtener los permisos que necesitas para conectarte a Knowledge Catalog con MCP Toolbox o la extensión de Gemini CLI, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para habilitar las APIs: Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin)
Para usar las habilidades de Knowledge Catalog: Visualizador de catálogo de Dataplex (roles/dataplex.catalogViewer)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para conectarse a Knowledge Catalog con MCP Toolbox o la extensión de Gemini CLI. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para conectarse a Knowledge Catalog con MCP Toolbox o la extensión de Gemini CLI:

Para habilitar las APIs: serviceusage.services.enable
Para usar las habilidades de Knowledge Catalog:
- dataplex.projects.search
- dataplex.entries.get
- dataplex.aspectTypes.get
- dataplex.aspectTypes.list

También puedes obtener estos permisos con roles personalizados o otros roles predefinidos.

Habilitar la API de Dataplex

En la Google Cloud consola de, ve a la página del selector de proyectos.

Ir al selector de proyectos
Selecciona o crea un Google Cloud proyecto de.
Roles necesarios para seleccionar o crear un proyecto
- Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
- Crear un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén más información para otorgar roles.
Nota: Si no planeas conservar los recursos creados durante este procedimiento, crea un proyecto en lugar de seleccionar un proyecto existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.
Verifica que la facturación esté habilitada para tu Google Cloud proyecto.
Habilitar la API de Dataplex
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.
Habilitar la API

Si usas un shell local, crea credenciales de autenticación locales para tu cuenta de usuario:
```
gcloud auth application-default login
```
No es necesario que hagas esto si usas Cloud Shell.

Si se muestra un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a gcloud CLI con tu identidad federada.

Instala MCP Toolbox

No es necesario que instales MCP Toolbox si solo planeas usar Gemini Code Assist o la extensión de Gemini CLI, ya que agrupan las capacidades del servidor requeridas. Para otros IDEs y herramientas, sigue los pasos de esta sección para instalar MCP Toolbox.

Descarga la versión más reciente de MCP Toolbox como un objeto binario. Selecciona la versión binaria de MCP Toolbox que corresponda a tu sistema operativo (SO) y arquitectura de CPU. Debes usar MCP Toolbox v0.31.0 o una versión posterior.
Linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox
Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v0.31.0.
macOS (Darwin)/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox
Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v0.31.0.
macOS (Darwin)/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox
Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v0.31.0.
Windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox
Reemplaza VERSION por la versión de MCP Toolbox, por ejemplo, v0.31.0.
Haz que el objeto binario sea ejecutable:
```
chmod +x toolbox
```
Verifica la instalación:
```
./toolbox --version
```
Si la instalación se realiza correctamente, se muestra el número de versión, por ejemplo, 0.15.0.

Configura clientes y conexiones

En esta sección, se explica cómo conectar Knowledge Catalog a tus herramientas.

Para conectar IDEs y herramientas compatibles con MCP, primero debes instalar MCP Toolbox. La caja de herramientas actúa como un servidor de Protocolo de contexto del modelo (MCP) código abierto que se encuentra entre tu IDE y Knowledge Catalog, lo que proporciona un plano de control seguro y eficiente para tus herramientas de IA. Después de la instalación, consulta la sección de tu herramienta específica para obtener instrucciones de configuración.

Extensión de Gemini CLI

Este método usa la extensión knowledge-catalog para la herramienta independiente de Gemini CLI y no usa MCP Toolbox.

Instala el Gemini CLI.
Instala la extensión de Knowledge Catalog para Gemini CLI desde el repositorio de GitHub:
```
gemini extensions install https://github.com/gemini-cli-extensions/knowledge-catalog
```
Configura la variable de entorno para conectarte a tu proyecto de Knowledge Catalog:
```
export DATAPLEX_PROJECT=PROJECT_ID
```
Reemplaza PROJECT_ID por el Google Cloud ID del proyecto.
Inicia Gemini CLI en modo interactivo:
```
gemini
```
La CLI carga automáticamente la extensión de Knowledge Catalog y sus habilidades, que puedes usar para interactuar con tu base de datos.

En Gemini CLI, usa el /extensions comando para verificar que la extensión esté instalada.

Gemini Code Assist

Gemini Code Assist agrupa las capacidades requeridas del servidor de MCP, por lo que no es necesario que instales MCP Toolbox por separado.

En VS Code, instala la extensión de Gemini Code Assist.
Habilita el modo de agente en el chat de Gemini Code Assist.
En tu directorio de trabajo, crea una carpeta llamada .gemini. Dentro de esa carpeta, crea un archivo settings.json.

Agrega la siguiente configuración:

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

Reemplaza PROJECT_ID por el Google Cloud ID del proyecto.

Guarde la configuración.

Claude Code

Instala Claude Code.
Configura la variable de entorno para conectarte a tu proyecto de Knowledge Catalog:
```
export DATAPLEX_PROJECT=
```