Connexions directes

Afficher en Markdown

Une connexion directe relie vos agents à un serveur que vous gérez : un serveur MCP distant ou une API HTTP. Vous indiquez à endue son point de terminaison et les en-têtes dont il a besoin, et les agents auxquels vous l’associez peuvent l’appeler.

Quand l’utiliser

Utilisez une connexion directe pour un service qui n’a pas de connecteur dans le catalogue : une API interne, votre propre serveur MCP, un outil développé par votre équipe. Si le service figure dans Connecteurs disponibles, utilisez plutôt ce connecteur. Ses opérations sont déjà classées : seuls l’envoi et la suppression vous demandent d’abord votre accord.

Serveur MCP ou serveur HTTP

	Serveur MCP	Serveur HTTP
Point de terminaison	Le point de terminaison MCP du serveur, avec le transport Streamable HTTP	Une URL de base
Ce que reçoit l’agent	Chaque outil listé par le serveur, avec les noms et les descriptions du serveur	Un outil de requête qui envoie des requêtes GET, POST, PUT, PATCH ou DELETE vers les chemins situés sous l’URL de base
Description	Facultative. Elle vous aide à reconnaître le serveur dans la liste.	Obligatoire. L’agent la lit pour savoir quels chemins et quelles méthodes utiliser.

Ajouter une connexion directe

Ouvrez Ressources › Connecteurs depuis la barre latérale gauche, sélectionnez l’onglet Connexions directes, puis Ajouter une connexion directe.
Choisissez le type : Serveur MCP ou Serveur HTTP. Il ne peut plus être modifié après l’enregistrement.
Remplissez les champs.
- Nom : affiché dans les listes et dans la conversation.
- URL du point de terminaison : une adresse https:// accessible sur Internet. Pour un serveur HTTP, c’est l’URL de base, et l’agent ne peut atteindre que les chemins situés en dessous.
- En-têtes : une ligne par en-tête requis par le serveur, par exemple Authorization avec Bearer ….
- Description : pour un serveur HTTP, écrivez ce que l’agent doit savoir : les chemins, les méthodes et un exemple. Par exemple : GET items?q=terme trouve des éléments. POST items avec {"title": "…"} en crée un.
Sélectionnez Vérifier la connexion. Rien n’est encore enregistré.
- Pour un serveur MCP, vous voyez le nom du serveur, la version du protocole MCP, les outils qu’il propose, et les éventuels outils que l’agent ne peut pas utiliser, avec la raison.
- Pour un serveur HTTP, endue envoie une requête GET à l’URL de base, ou au Chemin à vérifier situé sous celle-ci si vous l’avez renseigné, puis affiche le code de statut et le début de la réponse.
Sélectionnez Enregistrer. Pour un serveur MCP, la liste des outils est récupérée pendant l’enregistrement. Si le serveur est injoignable, rien n’est enregistré.
Associez-la à un agent. Dans l’Agent Builder de cet agent, ouvrez Ressources › Connecteurs et choisissez-la comme n’importe quelle autre connexion. Elle s’affiche avec un badge Connexion directe et son hôte.

En-têtes

Les valeurs d’en-tête, comme les jetons, sont stockées chiffrées. Une fois enregistrées, elles ne sont plus affichées, pas même à vous, et n’atteignent jamais l’agent ni la conversation : endue les ajoute lui-même à chaque requête, et l’agent ne peut pas ajouter ses propres en-têtes.

Quand vous modifiez une connexion, laissez une valeur vide pour la conserver, ou saisissez-en une nouvelle pour la remplacer. Comme les valeurs enregistrées ne sont pas renvoyées à votre navigateur, Vérifier la connexion sur une connexion existante exige de ressaisir toutes les valeurs d’en-tête.

Host, Content-Length, Connection et les en-têtes qui commencent par Proxy-, CF-, X-Forwarded- ou Mcp- sont gérés par la connexion et ne peuvent pas être définis.

Approbations

Par défaut, chaque appel à une connexion directe demande votre approbation. endue ne sait pas ce que fait un outil de votre serveur, et ne considère pas la description qu’en donne le serveur comme une raison de se passer de la question.

Pour que les appels passent sans demander, sélectionnez Modifier sur la connexion dans l’onglet Connexions directes et activez Toujours autoriser :

Serveur MCP : par outil.
Serveur HTTP : par méthode, par exemple GET.

Les exécutions que personne ne surveille, comme les routines et les canaux, ne peuvent utiliser que ce que vous avez réglé sur Toujours autoriser. Les autres appels de ces exécutions sont refusés.

Règles réseau

endue appelle votre serveur depuis sa propre infrastructure, et non depuis votre ordinateur. Le serveur doit être joignable depuis Internet :

https:// uniquement, sur le port 443 ou 8443.
Un nom de domaine public. Les adresses IP, localhost, les noms qui se résolvent en adresses privées et les adresses d’endue lui-même sont refusés. Une URL qui contient un nom d’utilisateur ou un mot de passe l’est aussi ; placez les identifiants dans un en-tête.
Les redirections ne sont suivies que vers le même hôte.
Chaque appel dispose de 30 secondes. Une réponse HTTP de plus de 256 Ko est tronquée à 256 Ko. Une réponse MCP de plus de 256 Ko échoue. Un corps de requête de plus de 256 Ko n’est pas envoyé.

Les requêtes proviennent du réseau de Cloudflare. Si votre serveur est protégé par un pare-feu ou une liste d’autorisation, autorisez les plages d’adresses IP de Cloudflare.

Gérer une connexion

L’onglet Connexions directes liste chaque connexion avec son type, son hôte, son nombre d’outils, son état et les agents qui l’utilisent.

Récupérer à nouveau relit la liste des outils d’un serveur MCP. Faites-le après avoir modifié les outils sur le serveur. La liste est aussi récupérée à nouveau quand vous modifiez le point de terminaison ou les en-têtes.
Erreur signifie qu’endue n’a pas pu joindre le serveur lors de sa dernière tentative. Ouvrez la connexion pour en voir la raison.
Supprimer efface les valeurs d’en-tête enregistrées et retire la connexion de tous les agents qui l’utilisent. Cette action est irréversible.

Limites

Jusqu’à 20 connexions directes par compte.
Les serveurs MCP doivent utiliser le transport Streamable HTTP. Les serveurs qui utilisent l’ancien transport HTTP avec SSE, ou qui exigent une connexion OAuth, ne sont pas pris en charge.
Un serveur HTTP donne à l’agent un outil de requête et votre description. endue ne lit pas de document OpenAPI. L’agent traite les réponses JSON et texte, mais pas les envois de fichiers ni les réponses en streaming.
Les serveurs d’un réseau privé sont injoignables. Le serveur doit avoir une adresse HTTPS publique.
Les outils dont l’agent ne peut pas utiliser le format d’entrée sont écartés et listés comme inutilisables, avec la raison.
Une connexion directe appartient à votre compte. Elle n’apparaît pas dans le catalogue.

Voir aussi

Présentation des connecteursConnexions, association et connecteurs du catalogue.

ApprobationsCe que vous voyez quand un appel demande d'abord votre accord.

Sécurité et autorisationsCe à quoi un agent a accès, et comment les identifiants sont conservés.