Documentation · Connecteur MCP
Connectez vos applications IA à votre base de connaissances Bayan Flow
Recherchez les connaissances de votre entreprise, rédigez et mettez à jour les documents, et consultez votre espace de travail depuis Claude, ChatGPT ou toute application MCP. Vous vous connectez avec votre compte Bayan Flow, choisissez ce que l'application peut faire, et gardez le contrôle.
- OAuth 2.0 avec PKCE
- MCP distant · HTTP diffusable
- Approbation du propriétaire pour les modifications sensibles
Adresse du serveur
https://bayanflow.tech/api/v1/mcpCollez cette adresse dans votre application d'IA en tant que connecteur MCP personnalisé. Il n'y a rien d'autre à copier.
Ce que les applications d'intelligence artificielle peuvent faire avec Bayan Flow
Bayan Flow transforme les documents de l'entreprise en réponses précises pour son équipe de support. Ce connecteur MCP permet aux applications d'intelligence artificielle telles que Claude et ChatGPT d'utiliser les bases de connaissances et l'espace de travail de votre choix, selon vos permissions et rien de plus.
Réponse à partir de vos propres documents
L'application parcourt les bases de connaissances que vous autorisez et lit les passages, de sorte que ses réponses proviennent de vos politiques et informations produit plutôt que de suppositions
Maintenez les connaissances à jour
Créez des bases de connaissances et des documents, et enregistrez les modifications sous forme de nouvelles versions. Rien n'est jamais supprimé de cette manière.
Comprendre votre espace de travail
Consultez les membres (avec e-mail masqué), les équipes, l'utilisation et le journal d'activité. Aucune donnée secrète ou de paiement n'est affichée.
L'application propose, vous décidez
L'application peut proposer l'ajout ou la suppression de membres, le changement de rôles, la modification de paramètres ou la suppression de connaissances. Chaque proposition attend l'approbation du propriétaire de l'espace de travail dans Bayan Flow via son mot de passe.
Ce que vous pouvez demander à votre application IA
- Recherchez dans mes connaissances Bayan Flow notre politique de remboursement et résumez‑la en trois points.
- Quels documents mentionnent les délais de livraison ? Indiquez‑les avec la base de connaissances correspondante
- Créez un document intitulé « Returns checklist » dans la base Centre d’aide avec les étapes que nous venons d’accepter.
- Affiche l'utilisation de ce mois-ci et les dix dernières entrées du journal d'activité.
- Suggérer de retirer le membre qui a quitté l'entreprise. Je l'approuverai dans Bayan Flow.
Connectez Claude en trois étapes
Ceci est pour Claude.ai et Claude Desktop. Il n'y a pas de clé à copier : vous vous connectez à Bayan Flow et approuvez la connexion.
Vous devez disposer d'un compte Bayan Flow dont le propriétaire est le propriétaire d'un espace de travail, ou d'un administrateur autorisé par le propriétaire à gérer les intégrations. Les autres verront qu'ils ne peuvent pas connecter d'application et pourront demander au propriétaire.
Ajoutez le connecteur dans Claude
Ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé, collez l'adresse du serveur ci-dessous et enregistrez.
https://bayanflow.tech/api/v1/mcpCliquez sur Connecter
Une page Bayan Flow s'ouvre dans votre navigateur. Connectez‑vous si vous y êtes invité
Choisir l'espace de travail et les autorisations
Sélectionnez l'espace de travail, cochez les actions que Claude peut effectuer et appuyez sur Autoriser. Tout ce qui dépasse la lecture demande votre mot de passe, puis vous revenez automatiquement à Claude.
Démarrez une nouvelle conversation et demandez : “Recherchez dans mes connaissances Bayan Flow la politique de remboursement.”
Claude Code
Ajoutez le serveur, puis exécutez /mcp dans Claude Code et choisissez Authenticate. Cela ouvre la même page d'approbation.
claude mcp add --transport http bayan-flow https://bayanflow.tech/api/v1/mcpClients ne pouvant pas ouvrir de page de connexion
Pour Cursor, VS Code ou un script, créez une clé MCP dans Intégrations → MCP et envoyez-la en tant qu'en-tête du porteur. Conservez-la dans une variable d'environnement, jamais dans un fichier partagé.
Authorization: Bearer $BAYAN_MCP_KEYPour vous déconnecter, accédez à Intégrations → MCP dans Bayan Flow et révoquez la connexion. L'application perd immédiatement l'accès.
ChatGPT et autres applications d'IA
Toutes les applications prenant en charge les serveurs MCP distants via HTTPS peuvent se connecter. Les applications proposant la connexion OAuth utilisent le même flux en un lien que Claude. Les noms de menu varient selon les applications et évoluent : recherchez « connecteur personnalisé », « mode développeur » ou « ajouter un serveur MCP ».
ChatGPT
Disponible sur les abonnements payants ChatGPT prenant en charge les connecteurs MCP personnalisés. Dans un espace de travail professionnel, un administrateur devra peut-être l'autoriser au préalable.
- Dans les paramètres de ChatGPT, activez le mode développeur (regardez dans Connecteurs ou Sécurité).
- Créez un nouveau connecteur (ou application) : collez l'adresse du serveur et choisissez OAuth comme authentification. Aucun ID client ou secret n'est requis, car ChatGPT s'enregistre lui‑même
- Cliquez sur Connecter. Une page Bayan Flow s'ouvre : choisissez l'espace de travail et les autorisations, puis cliquez sur Autoriser.
https://bayanflow.tech/api/v1/mcpAutres applications avec OAuth
Collez l'adresse du serveur et laissez l'authentification sur OAuth ou automatique. L'application s'enregistre et vous redirige vers la page d'approbation de Bayan Flow.
Applications exécutant uniquement des serveurs locaux
Utilisez l'assistant mcp-remote (nécessite Node.js), qui transforme un serveur distant en serveur local. Des extraits prêts à l'emploi se trouvent dans Intégrations → MCP.
Applications utilisant une clé
Cursor, VS Code, Windsurf, Gemini CLI, Codex CLI et les outils similaires acceptent un en-tête personnalisé. Créez une clé MCP dans Intégrations → MCP et conservez-la dans une variable d'environnement. Les noms de paramètres varient légèrement selon les applications ; l'adresse et l'en-tête sont les éléments importants.
{
"mcpServers": {
"bayan-flow": {
"url": "https://bayanflow.tech/api/v1/mcp",
"headers": { "Authorization": "Bearer ${BAYAN_MCP_KEY}" }
}
}
}La page d'approbation affiche le nom de l'application et l'adresse de retour. Les applications d'Anthropic et d'OpenAI sont signalées comme vérifiées ; pour toute autre application, vérifiez l'adresse avant d'autoriser.
Outils
25 outils, tous répertoriés ci-dessous. Chacun possède un titre et est indiqué comme lecture seule ou non, afin que l'application et ses utilisateurs sachent ce que fait un outil avant son exécution.
LectureOutils en lecture seule
Aucun changement n'a été effectué et aucun crédit n'a été dépensé.
knowledge_list_basesknowledge:readAffiche les bases de connaissances que cette clé peut lire, avec leur niveau d'accès et le nombre de documents.
knowledge_searchknowledge:readEffectue des recherches dans votre base de connaissances et renvoie les meilleurs passages avec leurs sources. Recherche uniquement : aucun texte généré par l'IA, aucun crédit utilisé.
knowledge_list_documentsknowledge:readListe les documents d'une base de connaissances.
knowledge_get_documentknowledge:readLit le texte d'un document, page par page.
workspace_getworkspace:readLe nom de l'espace de travail, les langues, l'abonnement et l'utilisation des licences.
workspace_list_membersworkspace:readMembres avec leur rôle et leur statut. Les adresses e-mail sont masquées.
workspace_list_teamsworkspace:readÉquipes et nombre de membres respectifs.
workspace_usageworkspace:readTotaux des requêtes, des crédits et de l'activité pour les derniers jours.
workspace_audit_logworkspace:readEntrées récentes du journal d'activité : qui a fait quoi, sans jamais inclure le contenu.
workspace_list_pending_actionsworkspace:readLes modifications de clés proposées et ce qu'elles sont devenues.
store_order_statusworkspace:readLe statut d'une commande de la boutique connectée : expédition, suivi, articles, total. Jamais les coordonnées du client.
ÉcritureOutils qui créent des connaissances
Ils créent ou modifient la connaissance. Les modifications sont enregistrées comme de nouvelles versions et rien n'est supprimé.
knowledge_create_baseknowledge:writeCréez une base de connaissances d'entreprise. Non compatible avec des clés limitées à certaines bases.
knowledge_create_documentknowledge:writeAjoute un nouveau document à une base de connaissances. Il est indexé en arrière-plan.
knowledge_update_documentknowledge:writeEnregistre du nouveau texte comme une nouvelle version. Les versions plus anciennes sont conservées, rien n’est supprimé.
Nécessite une approbationOutils qui proposent des changements
Ils ne changent rien eux‑mêmes. Ils créent une proposition que le propriétaire de l'espace de travail approuve ou rejette dans Bayan Flow
knowledge_delete_documentworkspace:adminPropose de supprimer un document. Rien n’est supprimé tant que le propriétaire n’approuve pas.
knowledge_archive_baseworkspace:adminPropose l'archivage d'une base de connaissances pour qu'elle cesse de fournir des réponses.
member_inviteworkspace:adminPropose d'inviter une personne par e-mail. Envoyé uniquement après approbation.
member_change_roleworkspace:adminPropose de modifier le rôle d'un membre en administrateur ou en membre. Jamais le propriétaire.
member_disableworkspace:adminPropose la désactivation d'un membre : il perd son accès et la licence est libérée.
member_removeworkspace:adminPropose de supprimer un membre de l'espace de travail.
team_createworkspace:adminPropose la création d'une équipe.
team_updateworkspace:adminPropose de renommer une équipe ou de modifier sa description.
team_deleteworkspace:adminPropose la suppression d'une équipe.
team_set_membersworkspace:adminPropose de remplacer la liste des membres d'une équipe.
workspace_update_settingsworkspace:adminPropose de changer le nom, les langues ou les actions des admins. Pas d’intégrations ni de facturation.
L'application ne voit que les outils autorisés par vos permissions. Si un outil manque, reconnectez-vous et cochez des permissions supplémentaires.
Permissions
Vous les choisissez sur la page d'approbation. Une connexion ne peut jamais faire plus que ce que vous avez coché, et vous pouvez la révoquer à tout moment.
Lire les connaissances
knowledge:readRechercher et lire les bases de connaissances accessibles par la clé. Rien n'est modifié et aucun crédit n'est consommé.
Un clic pour autoriser.
Rédiger la base de connaissances
knowledge:writeCréer des bases de connaissances et des documents, et enregistrer les modifications sous forme de nouvelles versions. Ne supprime jamais rien.
Demande votre mot de passe.
Lire l'espace de travail
workspace:readVoir les membres (noms, rôles, e-mail masqué), les équipes, l'utilisation et le journal d'activité. Aucun secret ni donnée de paiement.
Un clic pour autoriser.
Proposer des modifications de l'espace de travail
workspace:adminProposer des modifications aux membres, aux équipes, aux paramètres et aux suppressions de connaissances. Chaque action est soumise à l'approbation du propriétaire.
Réservé aux propriétaires d'espaces de travail, demande votre mot de passe, et chaque modification nécessite toujours l'approbation du propriétaire.
Sécurité et confidentialité
Le connecteur est conçu de manière à ce qu'une erreur, un jeton divulgué ou un assistant défectueux ait un impact limité.
Authentification que vous contrôlez
Code d'autorisation OAuth 2.0 avec PKCE. L'application ne voit jamais votre mot de passe et Bayan Flow ne voit jamais les identifiants de l'application. La page d'approbation affiche le nom de l'application et l'adresse vers laquelle elle renverra
Seulement ce que vous autorisez
Une connexion est limitée à un seul espace de travail et aux autorisations sélectionnées. La personne qui l'a approuvée doit encore gérer les intégrations sur cet espace, sinon la connexion s'interrompt
Approbation du propriétaire
Les modifications risquées ne sont que des propositions. Le propriétaire approuve avec son mot de passe ; 5 tentatives erronées bloquent l'approbation pendant 15 minutes, et une proposition non décidée expire après 24 heures.
Accès à durée limitée
Les jetons d'accès durent une heure et se renouvellent automatiquement. Si une copie d'un jeton de renouvellement est utilisée une seconde fois, l'ensemble de la connexion est annulé.
Révoquez à tout moment
Révoquez la connexion depuis Intégrations → MCP, ou depuis l'application. Les propositions en attente sont refusées et l'accès s'arrête immédiatement
Un historique d'audit
Bayan Flow enregistre l'outil appelé et son résultat, mais jamais le contenu. Les propriétaires de l'espace de travail reçoivent également un e-mail lors de l'établissement d'une connexion.
Vos données
Les passages demandés par l'application sont envoyés au fournisseur de cette application et traités conformément aux conditions de votre abonnement auprès de celui-ci. Ne connectez donc que des assistants en qui votre entreprise a confiance. Le texte de vos documents est marqué comme des données et non comme des instructions pour contrer les injections de requêtes (prompt injection). Bayan Flow voit les appels d'outils effectués par l'application, mais pas votre conversation avec celle-ci.
Jamais possible via MCP, peu importe ce que vous autorisez.
- Suppression de l'espace de travail
- Transférer la propriété ou changer le propriétaire
- Mots de passe, sessions, vérification à deux facteurs et connexion
- Création, affichage ou révocation des clés API
- Activer ou désactiver les intégrations, ou choisir qui les gère
- Forfaits, sièges, modes de paiement, factures et remboursements
- Exportation des données personnelles
- Tout ce qui concerne la plateforme Bayan
- Tout élément situé dans un autre espace de travail
Lire notre Politique de confidentialité · Conditions d'utilisation
Dépannage
Le bouton Autoriser est grisé
Choisissez d'abord un espace de travail. Si vous en avez plusieurs, aucun n'est sélectionné par défaut. Une ligne au-dessus du bouton indique ce qui manque.
Aucun espace de travail n’est répertorié sur la page d’approbation
Seuls les propriétaires d'espace de travail, ainsi que les administrateurs que le propriétaire a autorisés à gérer les intégrations, peuvent connecter une application. Demandez au propriétaire de le connecter ou de vous accorder cette permission.
La page indique que l'intégration est désactivée
Bayan Flow a désactivé le MCP pour cet espace de travail. Contactez le support depuis la page de contact.
L'application indique que la connexion a expiré ou nécessite une nouvelle connexion
Les connexions se renouvellent tant qu'elles sont utilisées. Après un an, ou si la connexion a été révoquée, appuyez sur Connecter à nouveau dans l'application.
Pourquoi m'a-t-on demandé mon mot de passe ?
Toute action autre que la lecture demande votre mot de passe, tout comme la création d'une clé API. Si vous vous connectez uniquement avec Google, définissez d'abord un mot de passe dans Paramètres → Sécurité.
Un outil attendu est absent
L'application ne voit que les outils autorisés par vos permissions. Reconnectez‑vous et cochez plus d'autorisations.
L'application signale trop de requêtes
Chaque connexion autorise 120 appels d'outil et 30 écritures par minute. Attendez un instant et réessayez.
L'espace de travail a déjà atteint le nombre maximal de connexions
Un espace de travail peut comporter cinq connexions MCP en même temps. Révoquez celle que vous n'utilisez plus dans Intégrations → MCP.
Vous avez encore besoin d'aide ? Écrivez-nous depuis le page de contact
Référence technique
Pour les développeurs et les réviseurs vérifiant la connexion.
- Adresse du serveur
- https://bayanflow.tech/api/v1/mcp
- Transport
- HTTP transmissible, sans état : uniquement POST, pas de sessions ni de flux d'événements
- Versions du protocole MCP
- 2025-11-25, 2025-06-18, 2025-03-26
- Autorisation
- Code d'autorisation OAuth 2.0 avec PKCE (S256), clients publics, enregistrement dynamique de client (RFC 7591), découverte selon les RFC 9728 et RFC 8414.
- Métadonnées de la ressource protégée
- https://bayanflow.tech/.well-known/oauth-protected-resource/api/v1/mcp
- Métadonnées du serveur d'autorisation
- https://bayanflow.tech/.well-known/oauth-authorization-server
- Point de terminaison d’autorisation
- https://bayanflow.tech/oauth/authorize
- Point de terminaison du token
- https://bayanflow.tech/api/oauth/token
- Inscription du client
- https://bayanflow.tech/api/oauth/register
- Point de terminaison de révocation
- https://bayanflow.tech/api/oauth/revoke
- Jetons
- Le jeton d'accès dure une heure. Le jeton de renouvellement tourne à chaque utilisation : 60 jours après la dernière utilisation, un an maximum. Le jeton de renouvellement précédent devient invalide.
- Portées
- knowledge:read, knowledge:write, workspace:read, workspace:admin
- Limites
- Par connexion : 120 appels d'outils et 30 écritures par minute. Une réponse est coupée à 100 KB.
Prêt à connecter ?
Créez un espace de travail ou connectez‑vous, puis suivez les trois étapes ci‑dessus.

