Intégrations

Ce que c'estEn ajouter uneOutils et confirmationsDans le chat et les agentsConfidentialitéAnciens serveurs MCPBientôt disponible

Ce que c'est

Une intégration est un serveur MCP (Model Context Protocol) : un standard ouvert pour donner des outils externes aux modèles, comme une mémoire, des agendas, des bases de données et des services web. Il en existe deux types :

Type	Comment ça marche
Sur ce PC	Un programme que HotMoE lance sur votre ordinateur. Les données restent sur le PC, sauf ce que le programme envoie lui-même sur le réseau.
Distante (en ligne)	Un service en ligne, à une adresse https://. Les demandes du modèle et les réponses passent par internet et par le fournisseur du service. Dans les listes, elle porte l'étiquette EN LIGNE.

Les intégrations sont à vous, pas à un agent en particulier : comme les comptes de messagerie, vous les configurez une fois puis vous les cochez là où vous voulez les utiliser.

Ajouter une intégration

1. Ouvrez la page Intégrations depuis la barre de gauche et choisissez Ajouter une intégration.
2. Remplissez les champs (voir le tableau ci-dessous).
3. Appuyez sur Connecter et afficher les outils. L'app enregistre, se connecte au serveur et liste ses outils.
4. Choisissez les outils à activer, puis cochez l'intégration là où vous voulez l'utiliser : dans le chat ou dans un agent (voir plus bas).

Champ	À quoi il sert
Nom	Comment vous la reconnaissez dans les listes. Dans le chat, c'est aussi le nom de son rôle.
À quoi elle sert	Une phrase, de préférence en anglais, avec les verbes de ce qu'elle fait (par exemple : « the user's GitHub: issues, pull requests, code review »). Le chat s'en sert pour savoir quand ces outils sont utiles ; vide, il utilise les noms des outils.
Où elle tourne	Sur ce PC ou Distante (en ligne).
Commande	Sur ce PC. Le programme à lancer avec ses arguments, comme dans la documentation du serveur : par exemple npx -y @modelcontextprotocol/server-memory.
Clés et variables	Sur ce PC, facultatives. Les variables d'environnement que le serveur demande, par exemple GITHUB_TOKEN. Les valeurs sont enregistrées chiffrées et ne s'affichent plus : pour en changer une, tapez la nouvelle ; laissez le champ vide pour garder celle enregistrée.
Adresse	Distante. L'adresse du service, qui commence par https://.
Connexion	Distante. Aucune, Jeton (clé personnelle) ou Connexion par le navigateur (OAuth).

Connexion par le navigateur (OAuth)

Avec OAuth, Connecter et afficher les outils ouvre le navigateur pour vous connecter au service. HotMoE ne voit pas votre mot de passe : il n'enregistre que l'autorisation, chiffrée, et la renouvelle tout seul.

Si la connexion expire, le chat n'ouvre pas le navigateur de lui-même : il affiche une note qui vous demande de vous reconnecter depuis la page Intégrations.

S'il manque un programme

Beaucoup d'intégrations sur le PC se lancent avec npx (Node.js), uvx (uv) ou Docker. Si le programme n'est pas installé, la page vous le dit avant d'essayer de se connecter, avec le lien Où le télécharger.

Outils et confirmations

• Une fois connecté, sous Outils, chaque outil du serveur apparaît avec un interrupteur.
• Par défaut, seuls les outils que le serveur déclare en lecture seule sont activés (marqués lecture seule). Activez les autres si vous voulez que le modèle puisse aussi modifier des choses.
• Chaque appel à un outil vous demande quand même confirmation, en vous montrant les données qu'il va recevoir.
• Toujours autoriser s'applique à l'outil concerné, pas à toute l'intégration. Vous le révoquez dans Accès › Autorisations (pour un agent, dans son éditeur).
• Chaque appel va dans le Journal, y compris ceux que vous avez refusés. Ils ne s'annulent pas.

Dans le chat et les agents

Une intégration configurée ne fait rien tant que vous ne la cochez pas :

• Dans le chat : dans les Accès, section Intégrations, cochez celles que le chat peut utiliser.
• Dans un agent : dans l'éditeur de l'agent, section Intégrations.

À côté des cases, le lien Configurer dans la page Intégrations vous amène ici, pour en ajouter ou en modifier une.

Dans le chat, chaque intégration cochée est un rôle, comme Fichiers, E-mail ou Écran, qui porte le nom de l'intégration. Le chat ne l'active que lorsque la demande concerne ce service, et c'est seulement alors que le modèle reçoit ses outils. Les modèles locaux ont peu de contexte : ainsi, il ne se remplit pas d'outils inutiles.

Confidentialité

• Sur ce PC : les données restent sur votre ordinateur, sauf ce que le programme envoie lui-même sur le réseau.
• Distante : les demandes du modèle et les réponses passent par internet et arrivent au fournisseur du service. Ne la connectez que si vous lui faites confiance.
• L'en-tête du chat vous le dit. D'habitude, à côté du modèle, on lit « · local, rien ne quitte votre PC ». Quand vous cochez une intégration distante, il devient « · utilise aussi des services en ligne : » suivi de leurs noms.
• Les valeurs des variables, les jetons et les autorisations de connexion sont enregistrés chiffrés et ne s'affichent plus.

Anciens serveurs MCP des agents

Avant, les serveurs MCP s'ajoutaient dans chaque agent, dans la section Serveurs MCP de l'éditeur. Ces serveurs sont devenus des intégrations automatiquement : vous les trouvez dans la page Intégrations, déjà cochés dans les agents qui les utilisaient. Un même serveur présent dans plusieurs agents est devenu une seule intégration.

Bientôt disponible

HotMoE est un projet Virsion. Ce guide décrit l'app telle qu'elle est aujourd'hui : ce qui est encore à venir est indiqué comme tel.