Aller au contenu principal

Ajouter un serveur MCP personnel

Avec un serveur MCP personnel, vous reliez AI-School à votre propre application, source de données ou service spécialisé. Choisissez d’abord le transport qui convient à l’endroit où il sera utilisé.

Choisir le bon transport​

TransportWebMobileBureauUtilisation
Streamable HTTPOuiOuiOuiRecommandé pour les serveurs hébergés
stdioNonNonOuiProcessus locaux et intégrations de bureau
SSEUniquement les configurations existantesUniquement les configurations existantesOuiTransport 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.nl/mcp

L’endpoint doit :

  • utiliser HTTPS ;
  • fonctionner sans nom d’utilisateur ni mot de passe dans l’URL ;
  • ne nécessiter aucune redirection ;
  • être accessible via DNS public ;
  • répondre à un handshake MCP initialize valide ;
  • disposer d’un ensemble explicite d’outils autorisés.

Les adresses locales, les adresses de réseau privé et les endpoints de métadonnées cloud sont bloqués. Cela signifie que vous ne pouvez pas enregistrer un serveur sur localhost depuis l’application web.

Ajouter un serveur​

  1. Ouvrez Préférences → Outils.
  2. Choisissez Ajouter des outils ou Ajouter un serveur MCP. Ce bouton n’est visible que si vous avez accès à MCP.
  3. Consultez d’abord les presets disponibles.
  4. Choisissez Ajouter vous-même un serveur MCP.
  5. Renseignez le nom, l’endpoint complet et la méthode d’authentification.
  6. Enregistrez la configuration et attendez la vérification de connexion.
  7. Activez le serveur pour votre ensemble d’outils par défaut.

Un administrateur peut également enregistrer un serveur pour l’ensemble de l’environnement via Administration → Paramètres IA → Outils → MCP.

Authentification et secrets​

AI-School prend en charge OAuth de connecteur et les secrets statiques. Les jetons OAuth, les refresh tokens, 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 cette vérification échoue, une configuration déjà approuvée peut rester active jusqu’à ce que le problème soit résolu.

Droits des outils​

N’autorisez que les outils réellement nécessaires aux utilisateurs. Un serveur MCP peut proposer des actions de lecture et d’écriture, comme supprimer des fichiers, envoyer des e-mails ou modifier des enregistrements. AI-School filtre les outils détectés selon la liste d’autorisation côté serveur, mais l’administrateur du serveur reste responsable des scopes et de l’autorisation appropriés.

Tests locaux​

Vous testez un serveur stdio local dans l’application de bureau. Le renderer ne peut pas lancer de commandes shell arbitraires : l’installation passe par un preset approuvé ou par le flux de bureau sécurisé. La commande, les arguments, les clés d’environnement et les accès demandés sont affichés avant l’installation.

Résolution des problèmes​

  • Endpoint inaccessible : vérifiez HTTPS, le DNS, le pare-feu et le chemin /mcp complet.
  • Nouvelle connexion requise : actualisez le consentement OAuth ou le secret enregistré.
  • Appartient à un autre environnement : enregistrez de nouveau le connecteur dans l’environnement actuel.
  • Aucun outil visible : vérifiez la liste d’autorisation des outils, votre accès MCP et si le serveur est actif.
  • Ne fonctionne que sur bureau : le serveur utilise probablement stdio ou une adresse locale.

Ressources de développement​

Voir aussi​

Lors de la modification, la configuration enregistrée du serveur 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, une nouvelle connexion est nécessaire. Une erreur dans un outil MCP ne signifie pas que tous les outils de ce serveur sont inaccessibles.

Sur cette page