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

# Utiliser le serveur MCP ClickHouse avec Open WebUI

> Ce guide explique comment configurer Open WebUI avec un serveur MCP ClickHouse à l’aide de Docker.

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

> Ce guide explique comment configurer [Open WebUI](https://github.com/open-webui/open-webui) avec le serveur MCP de ClickHouse
> et le connecter aux jeux de données d’exemple de ClickHouse.

<Steps>
  <Step title="Installer uv" id="install-uv">
    Vous devrez installer [uv](https://docs.astral.sh/uv/) pour suivre les instructions de ce guide.
    Si vous ne souhaitez pas utiliser uv, vous devrez mettre à jour la configuration du serveur MCP pour utiliser un autre gestionnaire de paquets.
  </Step>

  <Step title="Lancer Open WebUI" id="launch-open-webui">
    Pour lancer Open WebUI, vous pouvez exécuter la commande suivante :

    ```bash theme={null}
    uv run --with open-webui open-webui serve
    ```

    Accédez à [http://localhost:8080/](http://localhost:8080/) pour afficher l’UI.
  </Step>

  <Step title="Configurer le serveur MCP de ClickHouse" id="configure-clickhouse-mcp-server">
    Pour configurer le serveur MCP de ClickHouse, nous devons convertir le serveur MCP en points de terminaison Open API.
    Commençons par définir des variables d’environnement qui nous permettront de nous connecter au ClickHouse SQL Playground :

    ```bash theme={null}
    export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
    export CLICKHOUSE_USER="demo"
    export CLICKHOUSE_PASSWORD=""
    ```

    Ensuite, nous pouvons exécuter `mcpo` pour créer les points de terminaison Open API :

    ```bash theme={null}
    uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse
    ```

    Vous pouvez consulter la liste des points de terminaison créés en accédant à [http://localhost:8000/docs](http://localhost:8000/docs)

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/0_endpoints.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=d7c649716695f00628ee8657fad6a8a1" alt="Points de terminaison Open API" size="md" width="1455" height="759" data-path="images/use-cases/AI_ML/MCP/0_endpoints.webp" />

    Pour utiliser ces points de terminaison avec Open WebUI, accédez aux paramètres :

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/1_settings.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=696f96fff4092e0684b83dfd4237a979" alt="Paramètres d’Open WebUI" size="md" width="518" height="575" data-path="images/use-cases/AI_ML/MCP/1_settings.webp" />

    Cliquez sur `Tools` :

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/2_tools_page.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=d0599baa28fbebaf80301d11f2f59504" alt="Outils d’Open WebUI" size="md" width="1829" height="1190" data-path="images/use-cases/AI_ML/MCP/2_tools_page.webp" />

    Ajoutez [http://localhost:8000](http://localhost:8000) comme URL de l’outil :

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/3_add_tool.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=dcf958b9eb52ad1b8b19e95c2b7428e6" alt="Outil Open WebUI" size="md" width="1838" height="1201" data-path="images/use-cases/AI_ML/MCP/3_add_tool.webp" />

    Une fois cela fait, vous devriez voir un `1` à côté de l’icône de l’outil dans la barre de chat :

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/4_tools_available.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=60726c02b459783ec9309a197520314c" alt="Outils Open WebUI disponibles" size="md" width="1495" height="229" data-path="images/use-cases/AI_ML/MCP/4_tools_available.webp" />

    Si vous cliquez sur l’icône de l’outil, vous pourrez alors afficher la liste des outils disponibles :

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/5_list_of_tools.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=06cbfa40d3de4e94cfd5151b39ad897f" alt="Liste des outils Open WebUI" size="md" width="1373" height="711" data-path="images/use-cases/AI_ML/MCP/5_list_of_tools.webp" />
  </Step>

  <Step title="Configurer OpenAI" id="configure-openai">
    Par défaut, Open WebUI fonctionne avec les modèles Ollama, mais vous pouvez également ajouter des points de terminaison compatibles avec OpenAI.
    Ceux-ci se configurent via le menu des paramètres, mais cette fois, vous devez cliquer sur l’onglet `Connections` :

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/6_connections.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=15babadb04a4cec8f98e5ad0c5df0347" alt="Connexions Open WebUI" size="md" width="1824" height="1184" data-path="images/use-cases/AI_ML/MCP/6_connections.webp" />

    Ajoutez le point de terminaison et votre clé OpenAI :

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/7_add_connection.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=0404fce2bd39187a801fa14643ed6e40" alt="Open WebUI - Ajouter OpenAI comme connexion" size="md" width="1821" height="1192" data-path="images/use-cases/AI_ML/MCP/7_add_connection.webp" />

    Les modèles OpenAI seront alors disponibles dans le menu supérieur :

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/8_openai_models_more.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=e829a594b93d98e3e3d52667f567d9a6" alt="Open WebUI - Modèles" size="md" width="1574" height="1248" data-path="images/use-cases/AI_ML/MCP/8_openai_models_more.webp" />
  </Step>

  <Step title="Discuter avec le serveur MCP de ClickHouse dans Open WebUI" id="chat-to-clickhouse-mcp-server">
    Vous pouvez ensuite lancer une conversation, et Open WebUI appellera le serveur MCP si nécessaire :

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/9_conversation.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=177845ba46da7b871bd637081d7275b0" alt="Open WebUI - Discuter avec le serveur MCP de ClickHouse" size="md" width="2449" height="1839" data-path="images/use-cases/AI_ML/MCP/9_conversation.webp" />
  </Step>
</Steps>
