Model Context Protocol (MCP) est la norme ouverte qui permet d’exposer des outils et des sources de données à un modèle d’IA. Attacher un serveur MCP à un ClickHouse Agent permet à l’agent d’accéder à toutes les capacités exposées par ce serveur — systèmes de suivi des tickets, backends d’observabilité, API internes, SaaS tiers ou toute autre ressource disposant d’un endpoint MCP.
Dans l’Agent Builder, ouvrez la section serveurs MCP et cliquez sur Add server. Saisissez l’URL du serveur et les paramètres d’authentification, puis choisissez les outils du serveur que cet agent spécifique doit utiliser. Enregistrez l’agent.
Vous pouvez attacher plusieurs serveurs à un même agent. Chaque outil appelé par l’agent est consigné dans la conversation afin que les utilisateurs puissent voir ce que l’agent a fait.
ClickHouse Agents utilise Streamable HTTP — le transport MCP adapté à la production. Le serveur que vous associez doit être accessible en HTTP(S) depuis ClickHouse Cloud.
Les serveurs MCP peuvent nécessiter des identifiants. ClickHouse Agents prend en charge :
- Les jetons Bearer et autres en-têtes statiques - des valeurs fixes que vous fournissez lors de la configuration du serveur.
- OAuth 2.0 - flux interactif. La première fois que vous (ou tout autre utilisateur ayant accès) appelez un outil sur le serveur, le navigateur ouvre une fenêtre de connexion ; les jetons sont gérés et renouvelés automatiquement.
- Identifiants par utilisateur - variables de la config du serveur remplacées à partir du profil de l’utilisateur appelant, afin que chaque utilisateur s’authentifie avec sa propre identité plutôt qu’avec un compte de service partagé.
Les identifiants fournis par l’utilisateur sont stockés de manière chiffrée et associés uniquement à l’utilisateur qui les a saisis. Les identifiants d’un utilisateur ne sont jamais visibles dans les exécutions d’agent d’un autre utilisateur.
Une exécution d’agent ne peut référencer qu’un maximum de 50 cibles distinctes de serveur MCP et de 100 configurations d’outils étendues par requête. Les agents qui ont besoin de plus doivent être décomposés à l’aide de subagents. Dernière modification le 3 juillet 2026
