Aller au contenu

Intégration · Guide pratique

MCP

Connectez un assistant IA à Kokobi Learning avec MCP et OAuth.

Connectez votre assistant IA à Kokobi Learning avec le protocole MCP (Model Context Protocol). Votre assistant peut utiliser des outils pour consulter les données de formation et effectuer les actions autorisées pour votre compte.

Vous avez besoin d’un client IA compatible avec les serveurs MCP distants, Streamable HTTP et OAuth, comme un client Claude ou ChatGPT compatible. La disponibilité dépend de votre forfait et des règles de votre espace de travail. Aucune clé API n’est nécessaire.

Connecter votre assistant

Utilisez cette URL de serveur MCP dans votre client IA :

plaintext
https://learning.kokobi.org/api/mcp

Utilisez l’URL de la plateforme ci-dessus, et non un domaine personnalisé d’organisation.

  1. Copiez l’URL complète du serveur MCP, y compris /api/mcp.
  2. Dans votre client IA, ouvrez les paramètres de connecteurs, d’applications ou de MCP, puis ajoutez un serveur distant.
  3. Nommez-le Kokobi Learning et collez l’URL. Sélectionnez Streamable HTTP et OAuth si nécessaire. Ne configurez pas d’en-têtes personnalisés et ne collez aucun jeton.
  4. Connectez le serveur pour ouvrir le parcours de connexion. Connectez-vous avec votre compte Kokobi, vérifiez les autorisations demandées et acceptez uniquement si vous faites confiance au client.
  5. Revenez à votre client IA pour terminer la connexion. Activez Kokobi Learning dans une conversation.

Autorisez chaque client IA séparément avec votre propre compte.

Essayer une première demande

Demandez à votre assistant :

Liste les cours auxquels j’ai accès dans Kokobi Learning.

Vérifiez les appels d’outils proposés avant d’autoriser des actions qui modifient des données.

Autorisations

Votre client peut demander ces autorisations. OAuth n’accorde pas plus d’accès que ceux de votre compte Kokobi.

AutorisationAccès
mcp:readConsulter les informations accessibles à votre compte.
mcp:writeEffectuer les modifications autorisées pour votre compte.
offline_accessRester connecté sans vous demander de vous reconnecter à chaque fois, jusqu’à la révocation de l’accès.

Les résultats des outils sont partagés avec votre fournisseur d’IA. Respectez les règles de votre organisation concernant les données, connectez uniquement des clients de confiance et ne collez jamais de mots de passe ni de jetons d’accès dans une conversation.

Dépannage

  • Aucune option pour ajouter un serveur : vérifiez que votre client prend en charge MCP distant avec OAuth et que les intégrations personnalisées sont activées pour votre forfait et votre espace de travail.
  • Serveur inaccessible : vérifiez que l’URL utilise le domaine de votre plateforme et se termine par /api/mcp. Les clients hébergés dans le cloud ne peuvent pas accéder à une URL localhost.
  • Connexion expirée : reconnectez-vous depuis les paramètres de votre client IA.
  • Accès refusé : vérifiez le compte autorisé et ses permissions dans l’organisation. Une reconnexion n’accorde aucun accès supplémentaire.

Guides associés