> ## 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.

# Guias de MCP

> Esta página apresenta uma introdução ao Model Context Protocol (MCP) e traz um índice dos guias de MCP.

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>;
};

[Model Context Protocol](https://www.anthropic.com/news/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.

<div id="mcp-architecture">
  ## Como é a arquitetura do MCP?
</div>

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](https://github.com/punkpeye/awesome-mcp-clients?tab=readme-ov-file#windsurf).
* 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](https://github.com/punkpeye/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:

<Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/mcp_overview.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=bee0beef935d6b4e927e623ec66d4ed4" alt="Visão geral do MCP" size="lg" width="1551" height="641" data-path="images/use-cases/AI_ML/MCP/mcp_overview.webp" />

<div id="clickhouse-mcp-server">
  ## O ClickHouse tem um servidor MCP?
</div>

Tem sim!
O [ClickHouse MCP server](https://github.com/ClickHouse/mcp-clickhouse) 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"](/docs/pt-BR/products/cloud/features/ai-ml/remote-mcp)

<Tip>
  **Agent Skills**

  O [repositório ClickHouse Agent Skills](https://github.com/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.
</Tip>

<div id="clickhouse-mcp-server-guides">
  ## Guias para usar o ClickHouse MCP server
</div>

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](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/streamlit)                                   | 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.](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/langchain)                   | 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.](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/llamaindex)                           | 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.](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/pydantic-ai)                                       | Aprenda a criar um agente PydanticAI que possa interagir com o ClickHouse MCP server.                                                         |
| [Como criar um agente SlackBot com o ClickHouse MCP server.](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/slackbot)                                            | 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](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/agno)                                        | 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](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/chainlit)                                     | 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](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/claude-agent-sdk)                   | 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](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/copilotkit)                                 | 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](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/crewai)                                       | 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](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/dspy)                                           | 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](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/mcp-agent)                              | 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](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/microsoft-agent-framework) | 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](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/upsonic)                                  | 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.](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ai-agent-libraries/openai-agents)                                 | Aprenda a criar um agente OpenAI que possa interagir com o ClickHouse MCP server.                                                             |
| [Configurar o servidor MCP do ClickHouse com Ollama](/docs/pt-BR/guides/use-cases/ai-ml/MCP/ollama)                                                                         | Este guia explica como configurar o Ollama com o servidor MCP do ClickHouse.                                                                  |
| [Usando o ClickHouse MCP server com AnythingLLM](/docs/pt-BR/guides/use-cases/ai-ml/MCP/anythingllm)                                                                        | Este guia explica como configurar o AnythingLLM com um ClickHouse MCP server usando Docker.                                                   |
| [Usando o ClickHouse MCP server com o Claude Desktop](/docs/pt-BR/guides/use-cases/ai-ml/MCP/claude-desktop)                                                                | Este guia explica como configurar o Claude Desktop com um servidor MCP do ClickHouse.                                                         |
| [Usando o servidor MCP do ClickHouse com o Jan.ai](/docs/pt-BR/guides/use-cases/ai-ml/MCP/janai)                                                                            | Este guia explica como configurar o Jan.ai com o ClickHouse MCP server.                                                                       |
| [Usando o ClickHouse MCP server com o LibreChat](/docs/pt-BR/guides/use-cases/ai-ml/MCP/librechat)                                                                          | Este guia explica como configurar o LibreChat com o ClickHouse MCP server usando Docker.                                                      |
| [Usando o ClickHouse MCP server com o Open WebUI](/docs/pt-BR/guides/use-cases/ai-ml/MCP/open-webui)                                                                        | Este guia mostra como configurar o Open WebUI com um servidor MCP do ClickHouse usando o Docker.                                              |
