Sommaire de la documentation14 / 16

Réglages et aide14 / 16

Ajouter des serveurs MCP et des Skills

Sur cette page

Ajoutez un serveur MCP lorsqu’un Agent a besoin d’outils ou de connexions à des services supplémentaires. Ajoutez un Skill pour réutiliser des instructions et ressources pour un type de travail. Noea gère ces extensions de façon centralisée pour les conversations ordinaires des différents Agents.

Les extensions sont facultatives : elles ne sont pas nécessaires pour commencer. Les tâches Expliquer et d’organisation n’utilisent pas les extensions ajoutées ici.

Choisir l’extension nécessaire

TypeRôleRéglages
Serveur MCPFournir des outils ou connexions à des services supplémentaires.Réglages → Serveurs MCP
SkillFournir instructions et ressources pour un type de travail.Réglages → Skills

La disponibilité d’un serveur dépend aussi de la prise en charge de sa méthode de connexion par l’Agent. Pour les commandes de Skills, utilisez la liste réellement affichée dans la conversation.

Ajouter un serveur MCP

Ouvrez Réglages → Serveurs MCP, ajoutez un serveur, saisissez un nom et choisissez sa méthode de connexion.

  • stdio : démarrer un service localement. Saisissez sa commande, ses arguments et les variables d’environnement nécessaires, avec un argument par ligne.
  • HTTP : se connecter à un service par URL. Saisissez l’adresse du serveur et les en-têtes requis.

Si le service fournit une configuration JSON compatible, utilisez Coller du JSON pour remplir le formulaire. Vérifiez commande, adresse et champs d’authentification avant d’enregistrer.

Les noms doivent être uniques sans distinction de casse. Ceux commençant par noea sont réservés. La première ligne est le serveur intégré de Noea, toujours activé et impossible à supprimer.

Tester la connexion

Tester la connexion dans le panneau d’édition utilise les valeurs actuelles du formulaire. Un test depuis la liste utilise la configuration enregistrée.

Un test réussi affiche les noms des outils et leur nombre. Un échec indique son étape : commande manquante, arrêt du processus, délai dépassé, requête refusée ou échec de négociation. Si un service HTTP exige une autorisation, suivez le processus de l’Agent sélectionné.

Un test réussi signifie que la configuration peut établir une connexion. Il ne garantit pas sa compatibilité avec tous les Agents et n’active pas automatiquement le serveur pour une conversation.

Activer un serveur pour une conversation

Le réglage par défaut pour les nouvelles conversations, dans la liste des serveurs, détermine la sélection initiale. Vous pouvez aussi choisir les serveurs MCP d’une conversation dans son menu de configuration.

Le choix est enregistré avec la conversation. Un Agent connecté ne recharge pas immédiatement les réglages modifiés ; ils prennent effet à sa prochaine connexion. Pour utiliser une nouvelle configuration, démarrez une nouvelle conversation et vérifiez les serveurs sélectionnés.

Le menu explique l’indisponibilité d’un serveur, par exemple une variable d’environnement manquante ou une méthode de connexion non prise en charge.

Utiliser les variables d’environnement

Les valeurs des variables d’environnement et des en-têtes acceptent les références ${VAR} aux variables de l’environnement d’exécution de Noea. Elles sont lues à la connexion. Testez ensuite la connexion. Exécuter export dans un terminal ne garantit pas qu’un processus Noea déjà lancé possède cette valeur.

Les champs masquent les valeurs par défaut et les révèlent sur clic. Ce masquage évite seulement leur affichage ; il ne change ni leur enregistrement ni leur utilisation.

Ajouter un Skill

Ouvrez Réglages → Skills, choisissez l’ajout et sélectionnez un dossier contenant SKILL.md. L’application explique les éventuels problèmes de format.

Le Skill est ajouté à la bibliothèque de Noea. Ajouts et suppressions prennent effet dans les nouvelles conversations. Vous pouvez afficher son emplacement dans le gestionnaire de fichiers. Le supprimer retire la copie de la bibliothèque, pas le dossier original sélectionné.

La même page affiche en lecture seule les Skills utilisateur et projet détectés dans les répertoires des Agents. Consultez leurs emplacements ou choisissez Copier dans Noea. Cette liste n’inclut pas tous les Skills intégrés aux Agents ou fournis par leurs plugins.

Utiliser les extensions dans une conversation

Démarrez une nouvelle conversation et saisissez / au début de la saisie pour parcourir les Skills Noea et commandes de l’Agent. Choisissez un élément disponible, ajoutez les exigences de la tâche actuelle et envoyez-le.

Si une extension manque, vérifiez que vous avez démarré une nouvelle conversation et que l’Agent la prend en charge, puis consultez Dépannage.