> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ative e conecte o servidor MCP remoto do ClickHouse Cloud

> Este guia explica como ativar e usar o MCP remoto do ClickHouse Cloud

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

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](/docs/pt-BR/get-started/setup/cloud) em execução
* Sua IDE ou ferramenta de desenvolvimento com agentes de preferência

<div id="enable-remote-mcp-server">
  ## Habilitar o servidor MCP remoto para Cloud
</div>

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**:

<Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/1connectmcpmodal.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=744e5d063d27c1d69b4b09204c3627f8" alt="Selecione MCP no modal Connect" size="md" width="2190" height="2082" data-path="images/use-cases/AI_ML/MCP/1connectmcpmodal.webp" />

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

<Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/2enable_mcp.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=b3dcbb434349ffabcc8402552d82eb1a" alt="Habilitar servidor MCP" size="md" width="1340" height="884" data-path="images/use-cases/AI_ML/MCP/2enable_mcp.webp" />

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

```bash theme={null}
https://mcp.clickhouse.cloud/mcp
```

<div id="setup-clickhouse-cloud-remote-mcp-server">
  ## Configure o MCP remoto para desenvolvimento
</div>

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

<div id="claude-code">
  ### Claude Code
</div>

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

```bash theme={null}
claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp
```

Em seguida, abra o Claude Code:

```bash theme={null}
claude
```

Execute o comando a seguir para listar servidores MCP:

```bash theme={null}
/mcp
```

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

<div id="claude-web">
  ### Claude interface web
</div>

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

<div id="cursor">
  ### Cursor
</div>

1. Navegue pelo [Cursor Marketplace](https://cursor.com/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.

<div id="visual-studio-code">
  ### Visual Studio Code
</div>

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

```json theme={null}
{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}
```

Para mais detalhes, consulte a [documentação do Visual Studio Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).

<div id="windsurf">
  ### Windsurf
</div>

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

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

Para mais informações, consulte a [documentação do Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp#adding-a-new-mcp).

<div id="zed">
  ### Zed
</div>

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

```json theme={null}
{
  "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](https://zed.dev/docs/ai/mcp#as-custom-servers).

<div id="codex">
  ### Codex
</div>

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

```bash theme={null}
codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp
```

<div id="example-usage">
  ## Exemplo de uso
</div>

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](/docs/pt-BR/products/cloud/features/ai-ml/remote-mcp#available-tools).

<div id="exploring-data">
  ### Explorando seus dados
</div>

Comece descobrindo o que está disponível:

| Prompt                                                     | Ferramenta invocada                 |
| ---------------------------------------------------------- | ----------------------------------- |
| "A quais organizações tenho acesso?"                       | `get_organizations`                 |
| "Quais bancos de dados estão disponíveis no meu serviço?"  | `list_databases`                    |
| "Mostre as tabelas no banco de dados `default`"            | `list_tables`                       |
| "Liste todas as tabelas cujos nomes começam com `events_`" | `list_tables` (com o filtro `like`) |

<div id="running-queries">
  ### Executando consultas analíticas
</div>

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

| Prompt                                                                 | Ferramenta invocada |
| ---------------------------------------------------------------------- | ------------------- |
| "Mostre as 10 primeiras linhas da tabela `hits`"                       | `run_select_query`  |
| "Qual é a duração média da sessão por país nos últimos 7 dias?"        | `run_select_query`  |
| "Quantas linhas existem em cada tabela do banco de dados `analytics`?" | `run_select_query`  |

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

<div id="managing-services">
  ### Gerenciando serviços e infraestrutura
</div>

Tenha visibilidade sobre seus recursos no ClickHouse Cloud:

| Prompt                                               | Ferramenta invocada                |
| ---------------------------------------------------- | ---------------------------------- |
| "Liste todos os meus serviços"                       | `get_services_list`                |
| "Qual é o status do meu serviço de produção?"        | `get_service_details`              |
| "Mostre a programação de backups deste serviço"      | `get_service_backup_configuration` |
| "Liste os backups recentes"                          | `list_service_backups`             |
| "Quais ClickPipes estão configurados neste serviço?" | `list_clickpipes`                  |

<div id="monitoring-costs">
  ### Custos de monitoramento
</div>

| Prompt                                                     | Ferramenta invocada                                   |
| ---------------------------------------------------------- | ----------------------------------------------------- |
| "Qual foi o custo da minha organização na semana passada?" | `get_organization_cost`                               |
| "Mostre os custos diários de 1º de março a 15 de março"    | `get_organization_cost` (com `from_date` e `to_date`) |

<div id="related-content">
  ## Conteúdo relacionado
</div>

* [ClickHouse Agent Skills](https://github.com/ClickHouse/agent-skills)