Ajouter un serveur MCP personnel
Avec un serveur MCP personnel, vous connectez AI-Public à un système de gestion de dossiers, des archives, une source de données ou un autre service spécialisé. Choisissez d’abord quel transport convient au lieu d’utilisation.
Choisir le bon transport
| Transport | Web | Mobile | Bureau | Utilisation |
|---|---|---|---|---|
| Streamable HTTP | Oui | Oui | Oui | Recommandé pour les serveurs hébergés |
| stdio | Non | Non | Oui | Processus locaux et intégrations de bureau |
| SSE | Configurations existantes uniquement | Configurations existantes uniquement | Oui | Transport obsolète ; pour les nouveaux serveurs, choisissez Streamable HTTP |
Prérequis pour Streamable HTTP
Utilisez le point de terminaison public complet, y compris le chemin MCP, par exemple :
https://mcp.organisatie.nl/mcp
Le point de terminaison doit utiliser HTTPS, être accessible via DNS public sans redirection et répondre à une négociation initialize MCP valide. Les noms d’utilisateur et les mots de passe ne doivent pas figurer dans l’URL. Les adresses locales, les adresses de réseau privé et les points de terminaison de métadonnées cloud sont bloqués.
Ajouter un serveur
- Ouvrez Préférences → Outils.
- Choisissez Ajouter des outils ou Ajouter un serveur MCP. Ce bouton n’est visible que si vous avez accès à MCP.
- Consultez les préréglages disponibles.
- Choisissez Ajouter vous-même un serveur MCP.
- Renseignez le nom, le point de terminaison complet et la méthode d’authentification.
- Enregistrez la configuration et attendez le contrôle de connexion.
- Activez le serveur pour votre ensemble d’outils par défaut.
Un administrateur peut enregistrer un serveur pour l’ensemble de l’environnement via Administration → Outils → MCP.
Authentification et secrets
AI-Public prend en charge OAuth de connecteur et des secrets statiques. Les jetons OAuth, les jetons de rafraîchissement, les clés API et les mots de passe sont stockés côté serveur uniquement. Un chat ne reçoit que le connectorId enregistré, jamais la configuration secrète.
En cas de modification de l’URL ou de l’authentification, la nouvelle configuration est d’abord revérifiée. Si ce contrôle échoue, une configuration précédemment approuvée peut rester active jusqu’à ce que le problème soit résolu.
Droits des outils et sécurité de l’information
N’autorisez que les outils réellement nécessaires aux utilisateurs. Un serveur MCP peut proposer des actions de lecture et d’écriture. AI-Public filtre les outils découverts à l’aide d’une allowlist côté serveur et vérifie à chaque utilisation l’environnement, le propriétaire et le rôle. L’organisation reste responsable des scopes appropriés, de la journalisation, des durées de conservation et de l’autorisation dans le système source.
Serveurs locaux de bureau
Un serveur local stdio s’installe dans l’application de bureau. La commande, les arguments, les clés d’environnement et l’accès demandé sont limités et affichés avant approbation. Les secrets sont chiffrés localement.
Dépannage
- Point de terminaison inaccessible : vérifiez HTTPS, DNS, le pare-feu et le chemin complet
/mcp. - Reconnexion requise : renouvelez l’autorisation OAuth ou le secret enregistré.
- Appartient à un autre environnement : enregistrez à nouveau le connecteur dans l’environnement actuel.
- Aucun outil visible : vérifiez l’allowlist, l’accès par rôle et l’état actif.
- Fonctionne uniquement sur le bureau : le serveur utilise probablement stdio ou une adresse locale.
Ressources de développement
Voir aussi
Lors de la modification, la configuration du serveur enregistré est récupérée. La clé enregistrée reste masquée : laissez le champ de clé vide pour la conserver. En cas d’URL ou de méthode d’authentification différente, un nouveau couplage est nécessaire. Une erreur dans un outil MCP n’implique pas que tous les outils de ce serveur soient inaccessibles.