Skip to main content
Nem todos os usuários interagem com o ClickHouse por meio do console do Cloud. Por exemplo, muitos desenvolvedores trabalham diretamente em seus editores de código preferidos, em agentes de CLI ou se conectam ao banco de dados por meio de configurações personalizadas, enquanto outros dependem de assistentes de IA de uso geral, como o Anthropic Claude, para a maior parte de suas explorações. Esses usuários e as cargas de trabalho agentivas que atuam em seu nome precisam de uma forma de acessar e consultar o ClickHouse Cloud com segurança, sem configurações complexas nem infraestrutura personalizada. O recurso de servidor MCP remoto no ClickHouse Cloud resolve isso ao expor uma interface padrão que agentes externos podem usar para recuperar contexto analítico. MCP, ou Model Context Protocol, é um padrão para acesso estruturado a dados por aplicações de IA baseadas em LLMs. Com essa integração, agentes externos podem listar bancos de dados e tabelas, inspecionar esquemas e executar consultas SELECT com escopo limitado e em modo somente leitura. A autenticação é feita via OAuth 2.0 ou por meio de uma chave de API do ClickHouse Cloud. O servidor é totalmente gerenciado no ClickHouse Cloud, portanto não requer configuração nem manutenção. Isso facilita que ferramentas agentivas se integrem ao ClickHouse e recuperem os dados de que precisam, seja para análise, sumarização, geração de código ou exploração.

​
servidor MCP remoto vs servidor MCP de código aberto

O ClickHouse oferece dois servidores MCP. O servidor MCP remoto oferece a integração mais completa com o ClickHouse Cloud, incluindo gerenciamento de serviços, monitoramento de backups, visibilidade do ClickPipe e dados de faturamento, sem necessidade de gerenciar infraestrutura. Para instâncias self-hosted do ClickHouse, consulte os guias do servidor MCP de código aberto.

​
Habilitando o servidor MCP remoto

O servidor MCP remoto deve ser habilitado para cada serviço antes de poder aceitar conexões. No console do ClickHouse Cloud, abra o serviço, clique no botão Connect, selecione MCP e habilite-o. Habilitar ou desabilitar o servidor MCP remoto requer a permissão control-plane:service:manage-mcp (consulte Funções e permissões do Console). Para ver o passo a passo detalhado com capturas de tela, consulte o guia de configuração.

​
Endpoint

Após ser habilitado, o servidor MCP remoto fica disponível em:

​
Autenticação

O servidor MCP remoto oferece suporte a dois métodos de autenticação:
  • OAuth 2.0: Recomendado para clientes interativos. Quando um cliente MCP se conecta pela primeira vez, ele abre uma janela do navegador para que o usuário faça login com suas credenciais do ClickHouse Cloud. O acesso fica restrito às organizações e aos serviços aos quais o usuário autenticado tem permissão de acesso.
  • Chave de API do ClickHouse Cloud: Destinada a ambientes remotos, headless e automatizados, nos quais um fluxo do OAuth baseado em navegador não é viável. Envie o ID e o segredo da chave de API usando autenticação HTTP Basic:
O acesso por chave de API é limitado pelas funções, permissões e data de expiração configuradas para a chave. Use uma chave dedicada, com o mínimo de privilégios necessário, e injete-a por meio de um sistema de gerenciamento de segredos. A codificação Base64 não criptografa as credenciais; portanto, não faça commit do valor codificado no controle de versão nem o exponha em logs. Para ver um exemplo de configuração de um cliente MCP em um ambiente headless, consulte Autenticar a partir de um ambiente headless.

​
Segurança

Todas as ferramentas expostas pelo servidor MCP remoto são somente leitura. Cada ferramenta é marcada com readOnlyHint: true nos metadados do MCP. Nenhuma ferramenta pode modificar dados, alterar a configuração do serviço nem realizar qualquer operação destrutiva.

​
Ferramentas disponíveis

O servidor MCP remoto disponibiliza 13 ferramentas organizadas nas seguintes categorias.

​
Exploração de consultas e esquema

Essas ferramentas permitem que os agentes descubram quais dados estão disponíveis e executem consultas analíticas.

​
Organizações

​
Serviços

​
Backups

​
ClickPipes

​
Faturamento

​
Primeiros passos

Consulte o guia de configuração para ver instruções passo a passo sobre como habilitar o servidor MCP remoto e conectá-lo a um cliente MCP.