CloudBeaver MCP Server

Um servidor MCP seguro que conecta agentes de IA ao cliente web CloudBeaver, permitindo que eles explorem esquemas de banco de dados, leiam metadados e executem consultas SQL.

Ver em dbeaver.comExperimente este MCPPatrocinado

Documentação

Servidor de Protocolo de Contexto de Modelo (MCP)

[!note] Nota Este recurso está disponível apenas nas edições Enterprise, AWS e GCP.

O CloudBeaver pode ser executado como um servidor de Protocolo de Contexto de Modelo (MCP). Isso permite que clientes de IA externos executem operações de banco de dados por meio do CloudBeaver.

[!info] Informação Você pode encontrar mais informações sobre o Protocolo de Contexto de Modelo (MCP) aqui.

Habilitar o servidor MCP

Para ativar o servidor MCP:

Navegue até Configurações -> Administração -> Configuração do Servidor
Habilite as opções Integração de IA e Servidor MCP de IA
Abra o menu de contexto da conexão onde você deseja usar o MCP e selecione Editar Conexão.
Abra a aba IA, selecione a caixa de seleção Habilitar MCP e clique em Salvar. Após clicar em Salvar, a seção de configuração do MCP aparece. Ela inclui:
- o Endpoint MCP gerado para a conexão selecionada
  - exemplos de mcp.json prontos para copiar para clientes MCP compatíveis
  [!example] Exemplo
```
{
  "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 O endpoint MCP é específico da conexão. Cada conexão tem seu próprio endpoint e deve ser configurada separadamente no cliente.
  - a opção Usar autenticação OAuth em vez de chave de API Por padrão, os trechos de código usam autenticação por token de API. Para usar OAuth, selecione Usar autenticação OAuth em vez de chave de API. Os trechos gerados são atualizados automaticamente.
  [!note] Nota O suporte a OAuth depende do cliente MCP. Se o seu cliente não suportar OAuth para servidores MCP, use autenticação por token de API.
Se você usar autenticação por token de API, gere um token de acesso à API e substitua ${token} pelo token gerado.

Ferramentas compatíveis

Ferramenta	O que ela faz
`getDatasourceInfo`	Retorna o tipo de banco de dados, versão e detalhes da conexão.
`listCatalogNames`	Lista todos os catálogos/bancos de dados.
`listSchemaNames`	Lista esquemas em um catálogo.
`listSchemaNames`	Lista tabelas em um esquema/catálogo.
`getTableDetails`	Retorna o DDL para uma ou mais tabelas (colunas, restrições, índices, comentários).
`executeSQL`	Executa uma consulta SQL e retorna os resultados como CSV (padrão de `10` linhas).

Configurar um cliente MCP

Depois de habilitar o MCP para uma conexão, use o trecho de configuração gerado para registrar o servidor no seu cliente MCP.

O trecho depende do método de autenticação selecionado:

com autenticação por token de API, o trecho inclui o endpoint e o cabeçalho do token
com autenticação OAuth, o cliente lida com a autenticação por meio do fluxo OAuth

A configuração do cliente é realizada inteiramente no lado do cliente. Consulte a documentação do seu cliente para obter instruções sobre como adicionar um servidor MCP.

Cliente	Referência
Cursor	Documentação do Cursor
VS Code	Documentação do VS Code
Claude code	Documentação do Claude code
Claude Desktop	Documentação do Claude Desktop
ZED	Documentação do ZED

[!tip] Dica Para outros clientes MCP, use a URL do endpoint gerada e adapte a configuração de acordo com a documentação do cliente.