Agents & gouvernance
Vos agents depuis vos outils (MCP)
Ragnight comme outil de vos assistants
Pour qui : utilisateurs avancés et administrateurs — Où : /connect (connexion de vos outils) et /settings/api
Ragnight expose un serveur MCP (Model Context Protocol) : vos autres assistants IA — Claude, par exemple — peuvent interroger votre base de connaissances, lancer vos agents Ragnight et lire vos skills, avec vos droits.
Utilisation
/connect: suivez le guide pour brancher votre outil (l'authentification se fait via OAuth, à votre nom).- Votre outil voit alors des actions comme : chercher dans la connaissance, lister/exécuter les agents, lire vos skills, consulter vos souvenirs.
- Les permissions restent les vôtres : l'outil connecté ne voit que ce que vous voyez.
Bon à savoir
- L'accès aux souvenirs personnels n'est possible que via votre connexion OAuth personnelle — jamais par une clé d'organisation.
- Les clés API d'organisation (chapitre suivant) offrent l'accès programmatique classique (recherche, documents) pour vos développements.
Brancher un serveur MCP à vos agents
Pour qui : administrateurs — Où : /sources/new → Serveur MCP
C'est le sens inverse : au lieu d'exposer Ragnight à vos outils, vous branchez un serveur MCP externe et chacun des outils qu'il expose devient une action disponible pour vos agents. Un connecteur vous apporte ainsi des dizaines d'actions, sans développement.
Utilisation
- Ajoutez la source : l'URL du serveur MCP et, si nécessaire, un jeton d'authentification.
- Ragnight interroge le serveur et liste les outils qu'il annonce, avec leurs arguments. Le bouton « Rafraîchir les outils » remet la liste à jour quand le serveur évolue.
- Dans le constructeur d'un agent, famille « agir » → action « Appeler un outil MCP » : choisissez le serveur, l'outil, et l'argument qui recevra le texte rédigé par l'agent. Les autres arguments sont fixes, définis par vous.
Bon à savoir
- C'est vous qui figez l'outil, pas le modèle : l'agent ne choisit jamais quel outil appeler, il ne fait que proposer l'appel que vous avez câblé.
- Comme toute action externe, l'appel est enregistré en attente : le valideur voit l'outil et ses arguments au Centre de revue, et rien ne part avant son accord.
- Les adresses privées ou locales sont refusées, et l'URL est revérifiée à chaque appel.
- Un serveur injoignable ne fait pas échouer vos agents : il n'offre simplement plus d'outil jusqu'à son retour.
