Aller au contenu

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/mcp

Collez 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.

  1. 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/mcp
  2. Cliquez sur Connecter

    Une page Bayan Flow s'ouvre dans votre navigateur. Connectez‑vous si vous y êtes invité

  3. 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/mcp

Clients 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_KEY

Pour 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.

  1. Dans les paramètres de ChatGPT, activez le mode développeur (regardez dans Connecteurs ou Sécurité).
  2. 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
  3. 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/mcp

Autres 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:read

    Affiche les bases de connaissances que cette clé peut lire, avec leur niveau d'accès et le nombre de documents.

  • knowledge_searchknowledge:read

    Effectue 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:read

    Liste les documents d'une base de connaissances.

  • knowledge_get_documentknowledge:read

    Lit le texte d'un document, page par page.

  • workspace_getworkspace:read

    Le nom de l'espace de travail, les langues, l'abonnement et l'utilisation des licences.

  • workspace_list_membersworkspace:read

    Membres 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:read

    Totaux des requêtes, des crédits et de l'activité pour les derniers jours.

  • workspace_audit_logworkspace:read

    Entrées récentes du journal d'activité : qui a fait quoi, sans jamais inclure le contenu.

  • workspace_list_pending_actionsworkspace:read

    Les modifications de clés proposées et ce qu'elles sont devenues.

  • store_order_statusworkspace:read

    Le 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:write

    Créez une base de connaissances d'entreprise. Non compatible avec des clés limitées à certaines bases.

  • knowledge_create_documentknowledge:write

    Ajoute un nouveau document à une base de connaissances. Il est indexé en arrière-plan.

  • knowledge_update_documentknowledge:write

    Enregistre 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:admin

    Propose de supprimer un document. Rien n’est supprimé tant que le propriétaire n’approuve pas.

  • knowledge_archive_baseworkspace:admin

    Propose l'archivage d'une base de connaissances pour qu'elle cesse de fournir des réponses.

  • member_inviteworkspace:admin

    Propose d'inviter une personne par e-mail. Envoyé uniquement après approbation.

  • member_change_roleworkspace:admin

    Propose de modifier le rôle d'un membre en administrateur ou en membre. Jamais le propriétaire.

  • member_disableworkspace:admin

    Propose la désactivation d'un membre : il perd son accès et la licence est libérée.

  • member_removeworkspace:admin

    Propose de supprimer un membre de l'espace de travail.

  • team_createworkspace:admin

    Propose la création d'une équipe.

  • team_updateworkspace:admin

    Propose de renommer une équipe ou de modifier sa description.

  • team_deleteworkspace:admin

    Propose la suppression d'une équipe.

  • team_set_membersworkspace:admin

    Propose de remplacer la liste des membres d'une équipe.

  • workspace_update_settingsworkspace:admin

    Propose 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:read

    Rechercher 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:write

    Cré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:read

    Voir 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:admin

    Proposer 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.

Connecteur MCP pour Claude, ChatGPT et applications d'IA · Bayan Flow