CloudBeaver MCP Server

Un servidor MCP seguro que conecta agentes de IA al cliente web de CloudBeaver, permitiéndoles explorar esquemas de bases de datos, leer metadatos y ejecutar consultas SQL.

Ver en dbeaver.comPrueba este MCPPatrocinado

Documentación

Servidor de Protocolo de Contexto de Modelo (MCP)

[!note] Nota Esta función está disponible solo en las ediciones Enterprise, AWS y GCP.

CloudBeaver puede ejecutarse como un servidor de Protocolo de Contexto de Modelo (MCP). Esto permite que clientes de IA externos ejecuten operaciones de base de datos a través de CloudBeaver.

[!info] Información Puede encontrar más información sobre el Protocolo de Contexto de Modelo (MCP) aquí.

Habilitar el servidor MCP

Para activar el servidor MCP:

Navegue a Configuración -> Administración -> Configuración del servidor
Habilite las opciones Integración de IA y Servidor MCP de IA
Abra el menú contextual de la conexión donde desea usar MCP y seleccione Editar conexión.
Abra la pestaña IA, seleccione la casilla Habilitar MCP y haga clic en Guardar. Después de hacer clic en Guardar, aparece la sección de configuración de MCP. Incluye:
- el Endpoint MCP generado para la conexión seleccionada
  - ejemplos de mcp.json listos para copiar para clientes MCP compatibles
  [!example] Ejemplo
```
{
  "mcpServers": {
    "dbeaver": {
      "type": "http",
      "url": "https://server-example.com/api/mcp/projects/General/datasources/postgres-jdbc-19b9378f1f8-60bb24cfcd2979a7",
      "headers": {
        "X-API-Key": "${token}"
      }
    }
  }
}
```
  [!important] Importante El endpoint MCP es específico de la conexión. Cada conexión tiene su propio endpoint y debe configurarse por separado en el cliente.
  - la opción Usar autenticación OAuth en lugar de clave de API De forma predeterminada, los fragmentos usan autenticación con token de API. Para usar OAuth, seleccione Usar autenticación OAuth en lugar de clave de API. Los fragmentos generados se actualizan automáticamente.
  [!note] Nota El soporte de OAuth depende del cliente MCP. Si su cliente no admite OAuth para servidores MCP, use autenticación con token de API en su lugar.
Si usa autenticación con token de API, genere un token de acceso de API y reemplace ${token} con el token generado.

Herramientas compatibles

Herramienta	Qué hace
`getDatasourceInfo`	Devuelve el tipo de BD, la versión y los detalles de la conexión.
`listCatalogNames`	Lista todos los catálogos/bases de datos.
`listSchemaNames`	Lista los esquemas en un catálogo.
`listSchemaNames`	Lista las tablas en un esquema/catálogo.
`getTableDetails`	Devuelve el DDL de una o más tablas (columnas, restricciones, índices, comentarios).
`executeSQL`	Ejecuta una consulta SQL y devuelve los resultados como CSV (por defecto `10` filas).

Configurar un cliente MCP

Después de habilitar MCP para una conexión, use el fragmento de configuración generado para registrar el servidor en su cliente MCP.

El fragmento depende del método de autenticación seleccionado:

con autenticación con token de API, el fragmento incluye el endpoint y el encabezado del token
con autenticación OAuth, el cliente maneja la autenticación a través del flujo OAuth

La configuración del cliente se realiza completamente en el lado del cliente. Consulte la documentación de su cliente para obtener instrucciones sobre cómo agregar un servidor MCP.

Cliente	Referencia
Cursor	Documentación de Cursor
VS Code	Documentación de VS Code
Claude code	Documentación de Claude code
Claude Desktop	Documentación de Claude Desktop
ZED	Documentación de ZED

[!tip] Consejo Para otros clientes MCP, use la URL del endpoint generada y adapte la configuración según la documentación del cliente.