> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser le serveur MCP ClickHouse avec AnythingLLM

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

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

> Ce guide explique comment configurer [AnythingLLM](https://anythingllm.com/) avec un serveur MCP ClickHouse à l’aide de Docker
> et le connecter aux jeux de données d’exemple de ClickHouse.

<Steps>
  <Step>
    ## Installer Docker

    Vous aurez besoin de Docker pour exécuter AnythingLLM et le serveur MCP. Pour installer Docker :

    1. Rendez-vous sur [docker.com](https://www.docker.com/products/docker-desktop)
    2. Téléchargez Docker Desktop pour votre système d’exploitation
    3. Installez Docker en suivant les instructions correspondant à votre système d’exploitation
    4. Ouvrez Docker Desktop et assurez-vous qu’il est en cours d’exécution

    <br />

    Pour plus d’informations, consultez la [documentation Docker](https://docs.docker.com/get-docker/).
  </Step>

  <Step>
    ## Récupérer l’image Docker AnythingLLM

    Exécutez la commande suivante pour récupérer l’image Docker AnythingLLM sur votre machine :

    ```bash theme={null}
    docker pull anythingllm/anythingllm
    ```
  </Step>

  <Step>
    ## Définir l’emplacement de stockage

    Créez un répertoire de stockage et initialisez le fichier d’environnement :

    ```bash theme={null}
    export STORAGE_LOCATION=$PWD/anythingllm && \
    mkdir -p $STORAGE_LOCATION && \
    touch "$STORAGE_LOCATION/.env" 
    ```
  </Step>

  <Step>
    ## Configurer le fichier de config du serveur MCP

    Créez le répertoire `plugins` :

    ```bash theme={null}
    mkdir -p "$STORAGE_LOCATION/plugins"
    ```

    Créez un fichier nommé `anythingllm_mcp_servers.json` dans le répertoire `plugins` et ajoutez-y le contenu suivant :

    ```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_USER": "demo",
            "CLICKHOUSE_PASSWORD": ""
          }
        }
      }
    }
    ```

    Si vous souhaitez explorer vos propres données, vous pouvez le faire en
    utilisant le [host, username and password](/fr/get-started/setup/cloud#connect-with-your-app)
    de votre propre service ClickHouse Cloud.
  </Step>

  <Step>
    ## Démarrer le conteneur Docker AnythingLLM

    Exécutez la commande suivante pour démarrer le conteneur Docker AnythingLLM :

    ```bash theme={null}
    docker run -p 3001:3001 \
    --cap-add SYS_ADMIN \
    -v ${STORAGE_LOCATION}:/app/server/storage \
    -v ${STORAGE_LOCATION}/.env:/app/server/.env \
    -e STORAGE_DIR="/app/server/storage" \
    mintplexlabs/anythingllm
    ```

    Une fois le démarrage terminé, accédez à `http://localhost:3001` dans votre navigateur.
    Sélectionnez le modèle que vous souhaitez utiliser et indiquez votre API key.
  </Step>

  <Step>
    ## Attendre le démarrage des serveurs MCP

    Cliquez sur l’icône d’outil en bas à gauche de l’UI :

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/elHO3NI0U6chx0rg/images/use-cases/AI_ML/MCP/alm_tool-icon.png?fit=max&auto=format&n=elHO3NI0U6chx0rg&q=85&s=359a757c7c121231d2cce0753b567fe2" alt="Icône d’outil" size="md" width="1025" height="617" data-path="images/use-cases/AI_ML/MCP/alm_tool-icon.png" />

    Cliquez sur `Agent Skills` et regardez dans la section `MCP servers`.
    Attendez que `Mcp ClickHouse` passe à `On`

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/elHO3NI0U6chx0rg/images/use-cases/AI_ML/MCP/allm_mcp-servers.png?fit=max&auto=format&n=elHO3NI0U6chx0rg&q=85&s=7d3b6d6637d2ba93aa03bf10f9634176" alt="Serveurs MCP prêts" size="md" width="690" height="933" data-path="images/use-cases/AI_ML/MCP/allm_mcp-servers.png" />
  </Step>

  <Step>
    ## Discuter avec le serveur MCP ClickHouse dans AnythingLLM

    Nous sommes maintenant prêts à démarrer une conversation.
    Pour rendre les serveurs MCP disponibles dans une conversation, vous devrez faire précéder le premier message de `@agent`.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/elHO3NI0U6chx0rg/images/use-cases/AI_ML/MCP/allm_conversation.png?fit=max&auto=format&n=elHO3NI0U6chx0rg&q=85&s=79b6f65bd847e778287e2d24c31cf977" alt="Conversation" size="md" width="1290" height="1575" data-path="images/use-cases/AI_ML/MCP/allm_conversation.png" />
  </Step>
</Steps>
