Skip to main content
Les connecteurs personnalisés permettent aux clients Pro et Enterprise de connecter des API prises en charge qui ne figurent pas dans la bibliothèque d’intégrations de Replit. Utilisez-les pour connecter des services spécialisés sans attendre un connecteur natif. Les connecteurs personnalisés sont ajoutés à votre espace de travail, pas à votre compte personnel. Les administrateurs autorisés de l’espace de travail peuvent les créer et les gérer.
Les connecteurs personnalisés sont en version bêta et disponibles exclusivement pour les clients Enterprise. Les administrateurs de l’espace de travail peuvent les créer et les gérer.

​
Avant de commencer

Préparez les éléments suivants :
  • Un abonnement Pro ou Enterprise actif et l’autorisation de gérer les connecteurs dans votre espace de travail.
  • Une API REST HTTPS publiquement accessible et son URL de base.
  • Les identifiants de l’API et l’accès à sa documentation.
  • Facultativement, un point de terminaison en lecture seule que vous pouvez utiliser pour tester la connexion.
Les connecteurs API personnalisés sont différents des serveurs MCP personnalisés. Utilisez Ajouter un connecteur personnalisé pour une API ; les options de serveur MCP dans le même menu constituent un flux de configuration distinct.
Connectez-vous uniquement à des API auxquelles vous confiez vos données. Gardez les identifiants hors de la description du connecteur et des instructions Agent. Saisissez-les uniquement dans les champs d’authentification.

​
Créer un connecteur personnalisé

1

Ouvrir le formulaire de connecteur personnalisé

Sélectionnez Intégrations dans la barre latérale de votre espace de travail Enterprise. Ouvrez Ajouter personnalisé, puis sélectionnez Ajouter un connecteur personnalisé.
Page Intégrations avec le menu Ajouter personnalisé ouvert et Ajouter un connecteur personnalisé listé sous les options de serveur MCP
2

Décrire l'API

Complétez les champs suivants :Remplacez les valeurs d’exemple par celles de votre service. Les instructions Agent ont une limite de 500 caractères.
Formulaire de création d'un connecteur API personnalisé affichant son nom, sa description, son URL de base, les instructions Agent, l'authentification par jeton porteur et un test de point de terminaison optionnel
3

Configurer l'authentification

Sélectionnez la méthode d’authentification correspondant à votre API et remplissez les champs affichés.Pour une API qui utilise un jeton porteur, sélectionnez Jeton porteur (Bearer token) et saisissez le jeton sans le préfixe Bearer. Replit ajoute le préfixe lors de l’envoi d’une requête.
4

Tester un point de terminaison

Facultativement, saisissez un chemin tel que /health sous Test de point de terminaison et sélectionnez Vérifier.Le test envoie une requête GET avant l’enregistrement. Son résultat n’est pas enregistré. Choisissez un point de terminaison pris en charge par votre API qui ne modifie pas de données.Un test réussi vérifie cette requête, pas tous les points de terminaison ou permissions dont vous pourriez avoir besoin.
5

Enregistrer le connecteur

Vérifiez la configuration, puis sélectionnez Enregistrer.

​
Dépanner un test de point de terminaison

Si le test échoue, vérifiez les éléments suivants par rapport à la documentation de votre API :
  • URL et chemin : Confirmez que l’URL de base et le chemin de test forment le point de terminaison souhaité.
  • Authentification : Confirmez que l’identifiant est valide et dispose de la permission d’accéder au point de terminaison. Pour l’authentification par jeton porteur, omettez le préfixe Bearer dans le champ du jeton.
  • Méthode de requête : Choisissez un point de terminaison qui accepte les requêtes GET.
  • Accessibilité : Confirmez que l’API est publiquement accessible via HTTPS.

​
Documentation associée