> ## 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.
# Usando o servidor MCP do ClickHouse com o Claude Desktop
> Este guia explica como configurar o Claude Desktop para usar um servidor MCP do ClickHouse.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> Este guia explica como configurar o Claude Desktop com um servidor MCP do ClickHouse usando uv
> e conectá-lo aos datasets de exemplo do ClickHouse.
Você precisará instalar o [uv](https://docs.astral.sh/uv/) para seguir as instruções deste guia.
Se não quiser usar o uv, será necessário atualizar a configuração do servidor MCP do ClickHouse para usar outro gerenciador de pacotes.
Você também precisará instalar o aplicativo Claude Desktop, que pode ser baixado no [site do Claude Desktop](https://claude.ai/desktop).
Depois de instalar o Claude Desktop, é hora de configurar o [servidor MCP do ClickHouse](https://github.com/ClickHouse/mcp-clickhouse).
Podemos fazer isso por meio do [arquivo de configuração do Claude Desktop](https://claude.ai/docs/configuration).
Para encontrar esse arquivo, primeiro vá para a página de configurações (`Cmd+,` no Mac) e depois clique na aba `Developer` no menu à esquerda.
Em seguida, você verá a tela abaixo, na qual deverá clicar no botão `Edit config`:
Isso levará você a um diretório que contém o arquivo de configuração (`claude_desktop_config.json`).
Na primeira vez que você abrir esse arquivo, ele provavelmente conterá o seguinte conteúdo:
```json theme={null}
{
"mcpServers": {}
}
```
O dicionário `mcpServers` usa o nome de um servidor MCP como chave e um dicionário de opções de configuração como valor.
Por exemplo, a configuração do servidor MCP do ClickHouse para se conectar ao ClickHouse Playground ficaria assim:
```json theme={null}
{
"mcpServers": {
"mcp-clickhouse": {
"command": "uv",
"args": [
"run",
"--with",
"mcp-clickhouse",
"--python",
"3.10",
"mcp-clickhouse"
],
"env": {
"CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
"CLICKHOUSE_PORT": "8443",
"CLICKHOUSE_USER": "demo",
"CLICKHOUSE_PASSWORD": "",
"CLICKHOUSE_SECURE": "true",
"CLICKHOUSE_VERIFY": "true",
"CLICKHOUSE_CONNECT_TIMEOUT": "30",
"CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
}
}
}
}
```
Depois de atualizar a configuração, será necessário reiniciar o Claude Desktop para que as alterações entrem em vigor.
Dependendo de como você instalou o `uv`, talvez receba o seguinte erro ao reiniciar o Claude Desktop:
```text theme={null}
MCP mcp-clickhouse: spawn uv ENOENT
```
Se isso acontecer, será necessário atualizar o `command` para incluir o caminho completo do `uv`. Por exemplo, se você o instalou via Cargo, será `/Users//.cargo/bin/uv`
Depois de reiniciar o Claude Desktop, você pode encontrar o servidor MCP do ClickHouse clicando no ícone `Search and tools`:
Em seguida, você pode escolher se quer desativar todas as ferramentas ou apenas algumas.
Agora estamos prontos para fazer ao Claude algumas perguntas que farão com que ele use o servidor MCP do ClickHouse.
Por exemplo, poderíamos perguntar `Qual é o dataset mais interessante no playground SQL?`.
Na primeira vez que uma ferramenta do servidor MCP for chamada, o Claude pedirá que você confirme o uso dela:
Abaixo, você pode ver parte de uma conversa que inclui algumas chamadas de ferramentas para o servidor MCP do ClickHouse: