Guide MCP pour Hermes Agent Desktop : configurez les serveurs MCP dans l'application de bureau

Objectifs d'apprentissage

À la fin de ce tutoriel, vous serez en mesure de :

• Comprendre comment fonctionne MCP dans l'application de bureau Hermes Agent
• Savoir que l'application de bureau et la CLI partagent la même configuration MCP
• Configurer un serveur MCP de façon graphique via les Settings du bureau
• Recharger et utiliser les outils MCP dans une session de chat de bureau

Temps nécessaire : 15 minutes

Difficulté : Débutant

Quelle version est couverte ? Ce tutoriel couvre Hermes Agent Desktop — l'application de bureau graphique. Il configure MCP de la même manière que la CLI, car les deux utilisent le même fichier ~/.hermes/config.yaml. Tout ce que vous configurez dans l'application de bureau est disponible pour la CLI et vice versa. Si vous préférez la ligne de commandes, consultez le Guide MCP pour Hermes Agent CLI.

Prérequis

Avant de commencer, assurez-vous d'avoir :

Comment MCP fonctionne dans l'application de bureau

Un point clé sur l'application de bureau Hermes Agent : ce n'est pas un produit différent avec ses propres paramètres. Selon la documentation officielle de Hermes Agent, l'application de bureau exécute le même agent que la CLI et le gateway — même configuration, mêmes clés API, mêmes sessions, mêmes skills, même mémoire. Elle utilise le même noyau et les mêmes paramètres de Hermes Agent, pilotés par une interface conçue avec soin.

Cela signifie que :

• La configuration MCP réside dans le même ~/.hermes/config.yaml, sous mcp_servers, exactement comme en CLI
• Configurer un serveur MCP dans le panneau Settings → MCP Servers du bureau édite ce même fichier, donc la CLI le voit aussi
• Vous pouvez mixer : ajouter un serveur depuis la ligne de commandes avec hermes mcp install github, puis le gérer dans l'application de bureau, ou l'inverse

Étape 1 : Ouvrez les paramètres MCP

Lancez Hermes Agent Desktop. Dans l'application, ouvrez le panneau de paramètres (l'icône engrenage ou le menu des paramètres). Les panneaux couvrent les providers, la sélection du modèle, le gateway, les sessions et MCP servers.

Accédez au panneau de paramètres MCP Servers.

Ce que vous devriez voir : une liste de vos serveurs MCP configurés. Si vous n'en avez pas configuré, la liste sera vide.

Étape 2 : Ajoutez un serveur MCP

Dans le panneau MCP Servers, ajoutez un nouveau serveur. Vous pouvez choisir un serveur dans le catalogue sélectionné de Hermes Agent (le même que la CLI liste avec hermes mcp catalog) ou en ajouter un personnalisé.

Option A — Choisir un serveur du catalogue. Sélectionnez le serveur souhaité (par exemple GitHub). Hermes Agent vous guide à travers les identifiants requis (tels qu'une clé API ou une connexion OAuth) et ajoute l serveur.

Option B — Ajouter un serveur personnalisé. Fournissez les détails du serveur, tels que son command et args pour un serveur stdio local, ou son url et auth pour un serveur HTTP distant / OAuth.

Hermes Agent écrit le serveur dans ~/.hermes/config.yaml sous mcp_servers.

Ce que vous devriez voir : le serveur apparaît dans le panneau MCP Servers avec son statut, par exemple enabled ou installed (disabled).

Étape 3 : Choisissez quels outils activer

Lorsque Hermes Agent ajoute un serveur du catalogue, il sonde le serveur MCP pour lister chaque outil qu'il expose et vous permet de choisir lesquels activer.

Les outils pré-sélectionnés suivent les mêmes règles qu'en CLI :

1. 1Votre sélection précédente, si vous avez déjà installé ce serveur
2. 2Le tools.default_enabled du manifest, si l'entrée en déclare un
3. 3Tout, si aucun des two ne s'applique

Seuls les outils activés finissent dans mcp_servers.<name>.tools.include.

Si vous voulez affiner la sélection plus tard, vous pouvez rouvrir la sélection d'outils depuis les paramètres, ou utiliser la CLI :

hermes mcp configure <name>

Étape 4 : Rechargez et utilisez les outils MCP

Après avoir ajouté ou modifié un serveur, rechargez MCP pour que Hermes Agent prenne en compte les changements. Dans une session de chat de bureau, exécutez la commande :

/reload-mcp

Ce que vous devriez voir : Hermes Agent confirme que la configuration MCP a été rechargée.

Maintenant, démarrez un chat dans l'application de bureau et demandez à Hermes Agent d'utiliser le service connecté, par exemple :

List the open issues in the facebook/react repository

Ce que vous devriez voir : Hermes Agent appelle automatiquement les outils du serveur MCP, récupère les données et les résume pour vous.

Chaque outil MCP est enregistré sous le nom mcp_<server>_<tool>, par exemple mcp_github_list_issues.

Étape 5 : Désactivez ou retirez un serveur

Pour désactiver ou désinstaller un serveur dans l'application de bureau, ouvrez le panneau de paramètres MCP Servers et changez le statut du serveur, ou supprimez-le entièrement. Puisque le bureau et la CLI partagent le même fichier de configuration, un serveur désactivé ici est aussi désactivé pour la CLI.

Vous pouvez aussi éditer ~/.hermes/config.yaml directement et commenter le bloc du serveur avec #, puis recharger avec /reload-mcp dans n'importe quelle session Hermes Agent.

FAQ

L'application de bureau a-t-elle sa propre configuration MCP indépendante ? Non. L'application de bureau et la CLI partagent le même ~/.hermes/config.yaml. Configurer MCP à un endroit s'applique à l'autre.

Où la configuration MCP est-elle stockée ? Dans ~/.hermes/config.yaml, sous mcp_servers. Les identifiants vont dans ~/.hermes/.env.

Puis-je ajouter un serveur depuis la ligne de commandes et le gérer dans l'application de bureau ? Oui — ils partagent la même configuration, vous pouvez donc passer librement de la CLI à l'application de bureau.

Les serveurs du catalogue fonctionnent-ils automatiquement ? Non. Les entrées du catalogue sont revues, fusionnées dans optional-mcps/, et sont désactivées par défaut ; vous devez les installer.

Comment recharger MCP après avoir édité la configuration ? Exécutez la commande /reload-mcp dans n'importe quelle session Hermes Agent, y compris le chat de bureau.

Comment les outils MCP sont-ils nommés ? Chaque outil est enregistré sous la forme mcp_<server>_<tool>.

Étapes suivantes

• Essayez un serveur stdio personnalisé en le pointant vers un outil local
• Explorez le répertoire MCP sur Cataito pour plus de serveurs, ou consultez la documentation officielle de Hermes Agent Agent pour une configuration MCP avancée
• Apprenez le flux en ligne de commandes dans le Guide MCP pour Hermes Agent CLI
• En apprenez davantage sur l'application de bureau dans le Guide de démarrage de Hermes Agent Desktop