Ative e conecte o servidor MCP remoto do ClickHouse Cloud

Este guia mostra como habilitar o servidor MCP remoto do ClickHouse Cloud e configurá-lo para uso com ferramentas de desenvolvedor comuns.

Pré-requisitos

• Um serviço do ClickHouse Cloud em execução
• Sua IDE ou ferramenta de desenvolvimento com agentes de preferência

Conecte-se ao serviço ClickHouse Cloud para o qual você deseja habilitar o servidor MCP remoto. No menu à esquerda, clique em Connect. Uma caixa com os detalhes da conexão será aberta.

Selecione Connect with MCP:

Ative o botão para habilitar o MCP no serviço:

Copie a URL exibida, que é a mesma mostrada abaixo:

https://mcp.clickhouse.cloud/mcp

Escolha sua IDE ou ferramenta abaixo e siga as instruções de configuração correspondentes.

No diretório de trabalho, execute o comando a seguir para adicionar a configuração do servidor MCP do ClickHouse Cloud ao Claude Code:

claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp

Em seguida, abra o Claude Code:

claude

Execute o comando a seguir para listar servidores MCP:

/mcp

Selecione clickhouse-cloud e autentique-se via OAuth usando suas credenciais do ClickHouse Cloud.

1. Navegue até Customize > Connectors
2. Clique no ícone "+" e em Add custom connector
3. Dê um nome ao conector personalizado, como clickhouse-cloud, e adicione-o
4. Clique no conector clickhouse-cloud recém-adicionado e depois em Connect
5. Autentique-se usando suas credenciais do ClickHouse Cloud via OAuth

1. Navegue pelo Cursor Marketplace e instale servidores MCP.
2. Procure por ClickHouse e clique em "Add to Cursor" em qualquer servidor para instalá-lo
3. Autentique-se com OAuth.

Adicione a seguinte configuração ao arquivo .vscode/mcp.json:

{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

Para mais detalhes, consulte a documentação do Visual Studio Code.

Edite o arquivo mcp_config.json com a seguinte configuração:

{
  "mcpServers": {
    "clickhouse-cloud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.clickhouse.cloud/mcp"]
    }
  }
}

Para mais informações, consulte a documentação do Windsurf.

Adicione o ClickHouse como um servidor customizado. Adicione o seguinte às configurações do Zed, em context_servers:

{
  "context_servers": {
    "clickhouse-cloud": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

O Zed deverá solicitar que você se autentique via OAuth na primeira vez em que se conectar ao servidor. Para mais detalhes, consulte a documentação do Zed.

Execute o comando abaixo para adicionar o servidor MCP do ClickHouse Cloud pela CLI:

codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp

Depois de se conectar, você pode interagir com o ClickHouse Cloud por meio de prompts em linguagem natural. Abaixo estão alguns fluxos de trabalho comuns e as ferramentas que seu MCP client acionará em segundo plano. Para ver a lista completa de ferramentas disponíveis, consulte a referência de ferramentas.

Comece descobrindo o que está disponível:

Faça perguntas em linguagem natural, e o agente as traduzirá para SQL:

A ferramenta run_select_query permite apenas instruções SELECT. Todas as consultas são somente leitura.

Tenha visibilidade sobre seus recursos no ClickHouse Cloud:

• ClickHouse Agent Skills