Ajouter votre propre serveur MCP
Avec un serveur MCP personnalisé, vous connectez AI-Corporate à une application interne, une source de données ou un service spécialisé. Choisissez d’abord quel transport convient au lieu d’utilisation.
Choisir le bon transport
| Transport | Web | Mobile | Desktop | Utilisation |
|---|---|---|---|---|
| Streamable HTTP | Oui | Oui | Oui | Recommandé pour les serveurs hébergés |
| stdio | Non | Non | Oui | Processus locaux et intégrations desktop |
| SSE | Uniquement les configurations existantes | Uniquement les configurations existantes | Oui | Transport obsolète ; pour les nouveaux serveurs, choisissez Streamable HTTP |
Exigences pour Streamable HTTP
Utilisez l’endpoint public complet, y compris le chemin MCP, par exemple :
https://mcp.example.com/mcp
L’endpoint doit utiliser HTTPS, être accessible via DNS public sans redirection et répondre à un handshake initialize MCP valide. Les noms d’utilisateur et mots de passe ne doivent pas figurer dans l’URL. Les adresses locales, les adresses de réseau privé et les endpoints de métadonnées cloud sont bloqués.
Ajouter un serveur
- Ouvrez Préférences → Tools.
- Choisissez Ajouter des tools ou Ajouter un serveur MCP. Ce bouton n’est visible que si vous avez accès à MCP.
- Consultez les préréglages disponibles adaptés à l’organisation.
- Choisissez Ajouter vous-même un serveur MCP.
- Renseignez le nom, l’endpoint complet et la méthode d’authentification.
- Enregistrez la configuration et attendez la vérification 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 → Tools → MCP.
Authentification et secrets
AI-Corporate prend en charge OAuth pour connecteurs et les secrets statiques. Les tokens OAuth, les refresh tokens, les clés API et les mots de passe sont stockés uniquement côté serveur. 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 vérifiée à nouveau. Si cette vérification échoue, une configuration précédemment approuvée peut rester active jusqu’à ce que le problème soit résolu.
Droits d’outils et gouvernance
N’autorisez que les outils dont les employés ont réellement besoin. Un serveur MCP peut proposer des actions en lecture et en écriture. AI-Corporate filtre les outils découverts via une allowlist côté serveur et vérifie le tenant, le propriétaire et le rôle à chaque utilisation. L’organisation reste responsable des scopes appropriés, de la journalisation, des délais de conservation et de l’autorisation dans le système source.
Serveurs desktop locaux
Vous installez un serveur stdio local dans l’application desktop. Le renderer ne peut pas lancer de commandes shell arbitraires : 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.
Résolution des problèmes
- Endpoint 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, les droits de rôle et l’état actif.
- Fonctionne seulement sur desktop : le serveur utilise probablement stdio ou une adresse locale.
Ressources pour les développeurs
Voir aussi
Lors de la modification, la configuration du serveur enregistré est récupérée. La clé stocké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 raccordement est nécessaire. Une erreur dans un outil MCP n’implique pas que tous les outils de ce serveur soient inaccessibles.