Connecteurs MCP gérés
Les connecteurs MCP gérés permettent aux administrateurs d'agents de les connecter à un serveur MCP distant. Créez un connecteur à partir d'un modèle ou d'un endpoint HTTPS personnalisé, testez-le et sélectionnez-le à l'étape MCP de l'agent.
Parcours rapide
- Ouvrez Agents et utilisez l'onglet MCP.
- Choisissez un modèle ou ajoutez un serveur MCP distant personnalisé.
- Saisissez le secret si nécessaire et utilisez Test connection.
- Sélectionnez le connecteur à l'étape MCP de l'agent et enregistrez l'agent.
Modèles disponibles
| Modèle | Objectif | Authentification |
|---|---|---|
| Context7 | Documentation et exemples de bibliothèques selon leur version | Clé API facultative |
| GitHub | Outils de dépôts, incidents, pull requests et Actions | Nécessite un token d'accès personnel GitHub |
| Scraper | Extraction, mappage, exploration et rendu de sites web publics | Nécessite un token Bearer |
GitHub utilise par défaut un accès en lecture seule et un ensemble limité d'outils. Son endpoint et ses champs d'authentification sont fixes dans les connecteurs basés sur un modèle.
Serveurs distants personnalisés
Les connecteurs personnalisés prennent en charge les URL https:// ou http:// et l'un des modes d'authentification suivants : aucune authentification, token Bearer ou en-tête personnalisé. Les URL ne peuvent pas contenir d'identifiants intégrés.
Almirant valide les URL sortantes des connecteurs avant de les enregistrer ou de les mettre à jour. Il rejette les destinations privées ou autres destinations non autorisées afin de réduire le risque de SSRF. Utilisez un endpoint HTTPS accessible publiquement dans la mesure du possible.
Secrets et accès
- Les identifiants de connecteur sont chiffrés sur le serveur.
- L'interface Agents indique uniquement qu'un connecteur contient un secret ; elle ne renvoie pas sa valeur.
- Les secrets ne sont déchiffrés que pour préparer une exécution d'un agent auquel la personne propriétaire peut accéder.
- La propriété des connecteurs est limitée à l'utilisateur dans l'espace de travail actif.
- Un test de connexion renvoie l'état et des données de diagnostic sûres, et non le secret ou l'endpoint brut dans la réponse d'erreur.
Résolution des problèmes
| Problème | Cause probable | Action |
|---|---|---|
| Le test échoue avant la connexion | URL non valide, protocole non pris en charge ou destination bloquée | Utilisez un endpoint MCP HTTP(S) externe valide. |
| Impossible d'enregistrer un connecteur authentifié | Aucun secret n'a été fourni | Fournissez le token Bearer ou la valeur requise de l'en-tête personnalisé. |
| Impossible de modifier un modèle | L'endpoint et l'authentification du modèle sont immuables | Créez un connecteur personnalisé pour un autre serveur. |
| L'agent ne peut pas utiliser un connecteur | Il n'a pas été sélectionné à l'étape MCP de l'agent | Sélectionnez-le, enregistrez l'agent et démarrez un nouveau travail. |