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

# Guides MCP

> Cette page propose une introduction au Model Context Protocol (MCP) et contient une table des matières des guides 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) est une norme développée par Anthropic qui permet aux assistants IA de s’intégrer de façon transparente à des systèmes externes.
Ce protocole permet aux assistants IA de se connecter à des sources de données, à des API, à des bases de données, et bien plus encore, de manière sécurisée et standardisée.

MCP crée une interface universelle entre les modèles d’IA et différents services, ce qui évite de devoir développer des implémentations d’outils sur mesure pour chaque intégration.
Vous pouvez le voir comme une norme d’API universelle conçue spécialement pour les systèmes d’IA.

Le principal avantage de MCP est que les bibliothèques d’IA n’ont besoin d’implémenter la prise en charge du protocole qu’une seule fois.
Ensuite, tous les services compatibles avec MCP deviennent immédiatement accessibles, ce qui fait gagner un temps considérable aux mainteneurs de bibliothèques d’IA.

<div id="mcp-architecture">
  ## Quelle est l’architecture de MCP ?
</div>

MCP repose sur une architecture client-serveur :

* Les clients (comme Claude Desktop, Cursor ou VS Code) établissent des connexions avec des serveurs MCP. Vous trouverez une liste de clients dans le dépôt GitHub [awesome-mcp-clients](https://github.com/punkpeye/awesome-mcp-clients?tab=readme-ov-file#windsurf).
* Les serveurs exposent des outils et des fonctionnalités via des interfaces standardisées. Vous trouverez une liste de serveurs dans le dépôt GitHub [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers).
* Les modèles d’IA peuvent ensuite utiliser ces outils pour accéder à des données et à des fonctionnalités externes en cas de besoin

Un schéma illustrant l’architecture figure ci-dessous :

<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="Vue d’ensemble de MCP" size="lg" width="1551" height="641" data-path="images/use-cases/AI_ML/MCP/mcp_overview.webp" />

<div id="clickhouse-mcp-server">
  ## ClickHouse dispose-t-il d’un serveur MCP ?
</div>

Oui !
Le [ClickHouse MCP server](https://github.com/ClickHouse/mcp-clickhouse) propose les outils suivants :

* `run_select_query` - Exécuter des requêtes SQL sur votre cluster ClickHouse.
* `list_databases` - Lister toutes les bases de données de votre cluster ClickHouse.
* `list_tables` - Lister toutes les tables d’une base de données.

Si vous recherchez un serveur MCP distant dans ClickHouse Cloud, consultez la page ["Remote MCP server in Cloud"](/docs/fr/products/cloud/features/ai-ml/remote-mcp)

<Tip>
  **Agent Skills**

  Le [dépôt ClickHouse Agent Skills](https://github.com/ClickHouse/agent-skills) fournit des instructions prêtes à l’emploi qui enrichissent les agents IA de développement (Claude Code, Cursor, Copilot, etc.) d’une expertise métier spécifique. Ce dépôt fournit des Skills pour les bases de données ClickHouse, couvrant la conception de schémas, l’optimisation des requêtes et les modèles d’ingestion de données.
</Tip>

<div id="clickhouse-mcp-server-guides">
  ## Guides d’utilisation du ClickHouse MCP server
</div>

Vous trouverez ci-dessous quelques guides expliquant comment utiliser le ClickHouse MCP server.

| Page                                                                                                                                                             | Description                                                                                                                                          |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Comment créer un AI Agent avec Streamlit reposant sur ClickHouse](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/streamlit)                                  | Découvrez comment créer un AI Agent web avec Streamlit et le ClickHouse MCP server                                                                   |
| [Comment créer un agent IA LangChain/LangGraph à l’aide du serveur MCP ClickHouse.](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/langchain)                 | Découvrez comment créer un agent IA LangChain/LangGraph capable d’interagir avec le SQL playground de ClickHouse à l’aide du serveur MCP ClickHouse. |
| [Comment créer un agent IA LlamaIndex avec le serveur MCP ClickHouse.](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/llamaindex)                             | Découvrez comment créer un agent IA LlamaIndex capable d’interagir avec le serveur MCP ClickHouse.                                                   |
| [Comment créer un agent PydanticAI avec ClickHouse MCP server.](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/pydantic-ai)                                   | Découvrez comment créer un agent PydanticAI capable d’interagir avec ClickHouse MCP server.                                                          |
| [Comment créer un agent SlackBot avec ClickHouse MCP server.](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/slackbot)                                        | Découvrez comment créer un agent SlackBot capable d’interagir avec le serveur MCP ClickHouse.                                                        |
| [Comment créer un AI Agent avec Agno et le serveur MCP ClickHouse](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/agno)                                       | Découvrez comment créer un AI Agent avec Agno et le serveur MCP ClickHouse                                                                           |
| [Comment créer un AI Agent avec Chainlit et le ClickHouse MCP server](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/chainlit)                                | Découvrez comment utiliser Chainlit pour créer des applications de chat basées sur des LLM avec le ClickHouse MCP server                             |
| [Comment créer un AI Agent avec Claude Agent SDK et le ClickHouse MCP server](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/claude-agent-sdk)                | Découvrez comment créer un AI Agent avec Claude Agent SDK et le ClickHouse MCP server                                                                |
| [Comment créer un AI Agent avec CopilotKit et le serveur MCP ClickHouse](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/copilotkit)                           | Découvrez comment créer une application agentique à partir de données stockées dans ClickHouse avec ClickHouse MCP et CopilotKit                     |
| [Comment créer un AI Agent avec CrewAI et le ClickHouse MCP server](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/crewai)                                    | Découvrez comment créer un AI Agent avec CrewAI et le ClickHouse MCP server                                                                          |
| [Comment créer un AI Agent avec DSPy et le ClickHouse MCP server](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/dspy)                                        | Apprenez à créer un agent IA avec DSPy et le ClickHouse MCP server                                                                                   |
| [Comment créer un agent IA avec mcp-agent et le ClickHouse MCP server](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/mcp-agent)                              | Apprenez à créer un agent IA avec mcp-agent et le ClickHouse MCP server                                                                              |
| [Comment créer un AI Agent avec Microsoft Agent framework et ClickHouse MCP server](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/microsoft-agent-framework) | Découvrez comment créer un AI Agent avec Microsoft Agent framework et ClickHouse MCP server                                                          |
| [Comment créer un agent IA avec Upsonic et le serveur MCP de ClickHouse](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/upsonic)                              | Découvrez comment créer un agent IA avec Upsonic et le serveur MCP de ClickHouse                                                                     |
| [Comment créer un agent OpenAI à l’aide du serveur MCP de ClickHouse.](/docs/fr/guides/use-cases/ai-ml/MCP/ai-agent-libraries/openai-agents)                          | Découvrez comment créer un agent OpenAI capable d’interagir avec ClickHouse MCP server.                                                              |
| [Configurer ClickHouse MCP server avec Ollama](/docs/fr/guides/use-cases/ai-ml/MCP/ollama)                                                                            | Ce guide explique comment configurer Ollama avec ClickHouse MCP server.                                                                              |
| [Utilisation de ClickHouse MCP server avec AnythingLLM](/docs/fr/guides/use-cases/ai-ml/MCP/anythingllm)                                                              | Ce guide explique comment configurer AnythingLLM avec ClickHouse MCP server à l’aide de Docker.                                                      |
| [Utilisation de ClickHouse MCP server avec Claude Desktop](/docs/fr/guides/use-cases/ai-ml/MCP/claude-desktop)                                                        | Ce guide explique comment configurer Claude Desktop avec un serveur MCP ClickHouse.                                                                  |
| [Utilisation du serveur MCP ClickHouse avec Jan.ai](/docs/fr/guides/use-cases/ai-ml/MCP/janai)                                                                        | Ce guide explique comment configurer Jan.ai avec un serveur MCP ClickHouse.                                                                          |
| [Utilisation du serveur MCP ClickHouse avec LibreChat](/docs/fr/guides/use-cases/ai-ml/MCP/librechat)                                                                 | Ce guide explique comment configurer LibreChat avec le serveur MCP ClickHouse à l’aide de Docker.                                                    |
| [Utilisation du serveur MCP ClickHouse avec Open WebUI](/docs/fr/guides/use-cases/ai-ml/MCP/open-webui)                                                               | Ce guide explique comment configurer Open WebUI pour utiliser un ClickHouse MCP server avec Docker.                                                  |
