Connecter Tulina à Hermes

Hermes est l'agent open source de Nous Research. Une fois connecté à Tulina, il peut travailler dans vos outils, suivre vos processus et lire votre company brain, comme Claude ou ChatGPT.

Qui peut faire ça. Toute personne qui a un compte Tulina. Hermes obtient ce que votre compte peut voir et faire, et rien de plus.

Combien de temps ça prend. 5 minutes.

Étape 1. Ajouter Tulina à la configuration de Hermes

Ouvrez ~/.hermes/config.yaml et ajoutez ce bloc. Si le fichier contient déjà une section mcp_servers, ajoutez tulina à l'intérieur.

mcp_servers:
  tulina:
    url: "https://mcp.tulina.ai/mcp"
    auth: oauth
    oauth:
      redirect_port: 27890

Gardez la ligne redirect_port. Tulina n'accepte la connexion que sur cinq ports : 27890, 27891, 27892, 27893 et 27894. Si le 27890 est déjà utilisé sur votre machine, prenez l'un des quatre autres.

Laissez le bloc oauth aussi court qu'ici. Ajouter client_secret, client_name ou token_endpoint_auth_method change la façon dont Hermes se connecte, et Tulina la refuse.

Étape 2. Se connecter

Dans un terminal, en dehors de toute conversation Hermes en cours, lancez :

hermes mcp login tulina

Votre navigateur s'ouvre sur la page de connexion de Tulina. Connectez-vous comme vous le faites dans l'app.

Étape 3. Recharger Hermes

De retour dans Hermes, tapez :

/reload-mcp

Redémarrer Hermes fait la même chose. Les outils de Tulina sont maintenant disponibles. Pour vérifier, demandez à Hermes quelque chose que seule votre entreprise sait.

Hermes sur une machine distante

Si Hermes tourne sur un serveur et que votre navigateur est sur votre ordinateur, la page de connexion ne peut pas renvoyer le résultat toute seule. Deux façons de faire :

• Coller l'adresse. Ouvrez le lien que Hermes affiche, connectez-vous, puis copiez l'adresse finale dans la barre de votre navigateur et collez-la dans le terminal où Hermes attend. Le navigateur affiche une erreur de connexion à ce moment-là. C'est attendu.
• Rediriger le port. Depuis votre ordinateur, lancez ssh -N -L 27890:127.0.0.1:27890 user@host avant l'étape 2, puis connectez-vous normalement.

La connexion par code d'appareil (--flow device) ne fonctionne pas avec Tulina.

Un agent sans personne devant l'écran

Un Hermes qui tourne seul, sans personne pour se connecter, utilise une clé d'accès à la place. Dans l'app Tulina, ouvrez les réglages personnels et créez une clé d'accès. Elle n'est affichée qu'une fois, copiez-la tout de suite. Le bloc de configuration devient :

mcp_servers:
  tulina:
    url: "https://mcp.tulina.ai/mcp"
    headers:
      Authorization: "Bearer VOTRE_CLE_D_ACCES"

Une clé ouvre tout ce que son compte peut atteindre, à toute personne qui peut parler à cet agent. Créez un compte qui ne contient que ce dont la tâche a besoin, et supprimez la clé depuis la même page quand vous n'en avez plus besoin.

Dépannage

Une erreur qui mentionne invalid_redirect_uri. Hermes a tenté de se connecter sur un port que Tulina n'accepte pas. Vérifiez que redirect_port est compris entre 27890 et 27894, et que le bloc oauth ne contient rien d'autre.

Une erreur qui mentionne invalid_client. Hermes a gardé un ancien enregistrement. Supprimez les fichiers tulina dans ~/.hermes/mcp-tokens/, puis relancez hermes mcp login tulina.

La connexion a réussi mais Hermes n'affiche aucun outil Tulina. Tapez /reload-mcp. S'ils manquent toujours, lancez hermes mcp test tulina pour voir ce que Tulina a répondu.

Le navigateur ne s'ouvre pas. Hermes affiche le lien de connexion dans le terminal. Ouvrez-le à la main.