Serveurs MCP personnalisés
Au-delà des connecteurs présents dans le catalogue de Rephlo, vous pouvez connecter un serveur MCP personnalisé que vous exploitez vous-même — ou qu'exploite une personne de confiance. Cette fonctionnalité s'adresse aux utilisateurs avancés qui disposent déjà d'un serveur MCP et d'un jeton pour y accéder.
Les serveurs personnalisés s'ajoutent dans l'application de bureau, sous Settings → Connectors → Add custom connector. Il n'existe pas d'interface web pour cela ; tout se passe localement sur votre machine.
Avant de commencer
Vous aurez besoin de :
- Un serveur MCP que vous pouvez joindre (sa commande, ou son URL).
- Un jeton porteur (bearer token) pour ce serveur, s'il nécessite une authentification.
L'authentification est aujourd'hui limitée au jeton porteur. Les serveurs personnalisés s'authentifient actuellement au moyen d'un seul jeton porteur pré-partagé — vous collez un jeton, et Rephlo l'envoie avec chaque requête. Les serveurs personnalisés basés sur OAuth (où vous vous connectez via un navigateur, comme pour Notion) ne sont pas encore pris en charge et arriveront dans une version ultérieure.
Ajouter un serveur personnalisé
- Ouvrez Settings → Connectors et cliquez sur Add custom connector.
- Donnez un nom au serveur pour pouvoir le reconnaître plus tard.
- Choisissez un transport — la façon dont Rephlo communique avec le serveur :
- Streamable HTTP — Rephlo se connecte à une URL de serveur sur le réseau.
- Stdio — Rephlo lance un exécutable local et communique directement avec lui sur votre machine.
- Renseignez les paramètres spécifiques au transport (voir le tableau ci-dessous).
- Collez le jeton porteur du serveur.
- Enregistrez. Rephlo se connecte, demande au serveur quels outils il propose, et les outils du serveur deviennent disponibles dans le chat.
Le panneau d'ajout de connecteur personnalisé, avec la sélection du transport et le champ du jeton porteur.
Paramètres de transport
| Transport | Requis | Optionnel |
|---|---|---|
| Streamable HTTP | URL du serveur | Un jeton porteur pour l'authentification |
| Stdio | Chemin de l'exécutable à lancer | Arguments |
Le catalogue de connecteurs propre à Rephlo épingle certains serveurs à une empreinte binaire SHA-256 pour une vérification supplémentaire, mais cela est géré du côté de Rephlo — ce n'est pas un champ que vous définissez lors de l'ajout de votre propre connecteur personnalisé.
Où vivent vos données
- Les serveurs personnalisés et leurs jetons porteurs sont stockés sur votre appareil, chiffrés au repos. Ils ne sont pas envoyés au backend de Rephlo.
- Les appels d'outils des serveurs personnalisés s'exécutent directement depuis votre poste vers le serveur — ils ne transitent pas par le cloud de Rephlo.
- Comme pour tous les connecteurs, les résultats des outils vivent en mémoire pendant la session, et le journal d'audit local n'enregistre que le nom de l'outil, sa durée et son statut — jamais les arguments ni le contenu.
Dépannage
Le serveur rejette la connexion (401 / non autorisé). Le jeton porteur est incorrect ou a été renouvelé. Supprimez le serveur et rajoutez-le avec le bon jeton.
La connexion expire. Vérifiez que l'URL du serveur est joignable et que le serveur répond raisonnablement vite — les appels d'outils sont soumis à un délai fixe. Si le serveur est simplement lent, examinez ses performances ou sa disponibilité.
Les outils n'apparaissent pas, ou les appels d'outils échouent à l'analyse. Le serveur doit parler un MCP valide et déclarer ses outils lors de la connexion de Rephlo. Vérifiez que le serveur émet des définitions et des réponses d'outils MCP correctement formées.