Guias de MCP - ClickHouse Documentation

Model Context Protocol (MCP) é um padrão desenvolvido pela Anthropic que permite que assistentes de IA se integrem de forma transparente a sistemas externos. Esse protocolo permite que assistentes de IA se conectem a fontes de dados, APIs, bancos de dados e muito mais de maneira segura e padronizada. O MCP cria uma interface universal entre modelos de IA e vários serviços, eliminando a necessidade de implementar ferramentas personalizadas para cada integração. Você pode pensar nele como um padrão universal de API projetado especificamente para sistemas de IA. A principal vantagem do MCP é que as bibliotecas de IA só precisam implementar suporte ao protocolo uma única vez. Depois disso, todos os serviços compatíveis com MCP ficam imediatamente acessíveis, economizando muito tempo dos mantenedores dessas bibliotecas.

Como é a arquitetura do MCP?

O MCP segue uma arquitetura cliente-servidor:

Clientes (como Claude Desktop, Cursor ou VS Code) estabelecem conexões com servidores MCP. Você pode ver uma lista de clientes no repositório do GitHub awesome-mcp-clients.
Os servidores expõem ferramentas e recursos por meio de interfaces padronizadas. Você pode ver uma lista de servidores no repositório do GitHub awesome-mcp-servers.
Os modelos de IA podem então usar essas ferramentas para acessar dados e funcionalidades externas quando necessário

Veja abaixo um diagrama da arquitetura:

O ClickHouse tem um servidor MCP?

Tem sim! O ClickHouse MCP server oferece as seguintes ferramentas:

run_select_query - Execute consultas SQL no seu cluster do ClickHouse.
list_databases - Liste todos os bancos de dados no seu cluster do ClickHouse.
list_tables - Liste todas as tabelas em um banco de dados.

Se você está procurando um servidor MCP remoto no ClickHouse Cloud, consulte a página “Servidor MCP remoto no Cloud”

Agent SkillsO repositório ClickHouse Agent Skills fornece instruções prontas para uso que ampliam agentes de programação com IA (Claude Code, Cursor, Copilot etc.) com conhecimento especializado do domínio. Este repositório fornece skills para bancos de dados ClickHouse, cobrindo design de schema, otimização de consultas e padrões de ingestão de dados.

Guias para usar o ClickHouse MCP server

Abaixo estão alguns guias sobre como usar o ClickHouse MCP server.

Página	Descrição
Como criar um agente de IA com Streamlit e ClickHouse como backend	Saiba como criar um agente de IA baseado na web com Streamlit e o servidor MCP do ClickHouse
Como criar um agente de IA com LangChain/LangGraph usando o ClickHouse MCP server.	Aprenda a criar um agente de IA com LangChain/LangGraph que pode interagir com o Playground SQL do ClickHouse usando o ClickHouse MCP server.
Como criar um agente de IA com LlamaIndex usando o ClickHouse MCP server.	Saiba como criar um agente de IA com LlamaIndex que pode interagir com o ClickHouse MCP server.
Como criar um agente PydanticAI com o ClickHouse MCP server.	Aprenda a criar um agente PydanticAI que possa interagir com o ClickHouse MCP server.
Como criar um agente SlackBot com o ClickHouse MCP server.	Aprenda a criar um agente SlackBot que possa interagir com o servidor MCP do ClickHouse.
Como criar um agente de IA com Agno e o servidor MCP do ClickHouse	Aprenda a criar um agente de IA com Agno e o servidor MCP do ClickHouse
Como criar um agente de IA com Chainlit e o ClickHouse MCP server	Aprenda a usar o Chainlit para criar apps de chat baseados em LLM com o ClickHouse MCP server
Como criar um agente de IA com o Claude Agent SDK e o ClickHouse MCP server	Saiba como criar um agente de IA com o Claude Agent SDK e o ClickHouse MCP server
Como criar um agente de IA com CopilotKit e o ClickHouse MCP server	Aprenda a criar uma aplicação baseada em agentes usando dados armazenados no ClickHouse com ClickHouse MCP e CopilotKit
Como criar um agente de IA com o CrewAI e o ClickHouse MCP server	Saiba como criar um agente de IA com o CrewAI e o ClickHouse MCP server
Como criar um agente de IA com o DSPy e o ClickHouse MCP server	Aprenda a criar um agente de IA com DSPy e o servidor MCP do ClickHouse
Como criar um agente de IA com mcp-agent e o servidor MCP do ClickHouse	Aprenda a criar um agente de IA com mcp-agent e o servidor MCP do ClickHouse
Como criar um agente de IA com o Microsoft Agent framework e o ClickHouse MCP server	Aprenda a criar um agente de IA com o Microsoft Agent framework e o ClickHouse MCP server
Como criar um agente de IA com Upsonic e o servidor MCP do ClickHouse	Aprenda a criar um agente de IA com Upsonic e o servidor MCP do ClickHouse
Como criar um agente OpenAI usando o servidor MCP do ClickHouse.	Aprenda a criar um agente OpenAI que possa interagir com o ClickHouse MCP server.
Configure o ClickHouse MCP server com AnythingLLM e ClickHouse Cloud	Este guia explica como configurar o AnythingLLM com um ClickHouse MCP server usando Docker.
Configurar o servidor MCP do ClickHouse com o Claude Desktop	Este guia explica como configurar o Claude Desktop com um servidor MCP do ClickHouse.
Configurar o servidor MCP do ClickHouse com o Jan.ai	Este guia explica como configurar o Jan.ai com o ClickHouse MCP server.
Configurar o ClickHouse MCP server com o LibreChat e o ClickHouse Cloud	Este guia explica como configurar o LibreChat com o ClickHouse MCP server usando Docker.
Configurar o servidor MCP do ClickHouse com Ollama	Este guia explica como configurar o Ollama com o servidor MCP do ClickHouse.
Configurar o servidor MCP do ClickHouse com Open WebUI e ClickHouse Cloud	Este guia mostra como configurar o Open WebUI com um servidor MCP do ClickHouse usando o Docker.

​Como é a arquitetura do MCP?

​O ClickHouse tem um servidor MCP?

​Guias para usar o ClickHouse MCP server

Como é a arquitetura do MCP?

O ClickHouse tem um servidor MCP?

Guias para usar o ClickHouse MCP server