Connecter un client MCP et gérer ses autorisations

MCP relie un client IA externe compatible à Boldo. Il peut lire des données, envoyer des suggestions ou modifier directement des données, selon ses autorisations. La connexion agit avec vos droits Boldo, dans une organisation.

Vérifier l’accès

Votre offre doit comprendre MCP et l’IA, avec l’IA activée. Votre compte doit disposer de l’Accès IA et de l’Accès MCP. Les exigences de connexion, SSO, double authentification et adresses IP autorisées s’appliquent aussi. Le service du client peut utiliser une autre IP que votre navigateur.

Un Administrateur ou le Propriétaire règle le Niveau MCP dans les paramètres du membre :

Niveau MCP	Actions disponibles
Lecture seule	Consulter les informations accessibles au membre.
Lecture et suggestions	Envoyer aussi des suggestions à valider dans Boldo.
Lecture, suggestions et écriture	Modifier aussi directement les données, si l’organisation l’autorise et que la connexion a reçu l’écriture.

Le Niveau d’accès IA est distinct. Le Niveau 1 - Plateforme uniquement donne accès au schéma et à la documentation. Le Niveau 2 - Données métier ouvre les outils métier dans la limite des droits du membre. Un niveau MCP supérieur ne contourne pas cette restriction.

La page d’administration MCP exige le type Éditeur ou supérieur. Un Lecteur autorisé peut néanmoins se connecter depuis un client compatible et la documentation publique. L’écriture directe exige le type Éditeur ou supérieur et les droits métier correspondants.

Connecter le client

1. Ouvrez /mcp-doc sur votre environnement Boldo, ou Gestion de l’organisation > MCP > Documentation MCP si ce chemin est disponible.
2. Copiez l’endpoint de l’environnement. En production : https://app.boldo.io/api/mcp.
3. Dans le client, ajoutez un serveur MCP distant en Streamable HTTP, avec cette URL et son parcours de connexion OAuth.
4. Connectez-vous à Boldo avec une méthode acceptée par l’organisation.
5. Sur Connecter un client MCP, vérifiez l’organisation, même si une seule est proposée. Chacune affiche le maximum que vos droits y permettent.
6. Sous Niveau d’accès, cliquez jusqu’où va cette connexion : Plateforme, Lecture, Suggestions ou Écriture. Les crans au-delà de vos droits sont verrouillés, et Écriture n’est jamais présélectionnée. Cliquez ensuite sur Autoriser.
7. Revenez au client et chargez ses outils. Commencez par une lecture limitée d’un actif ou d’un type connu.

Vous pouvez donner à une connexion moins que vos droits, par exemple Lecture pour un client strictement en lecture. Boldo applique à chaque requête le plus bas entre ce choix et vos droits du moment : si un administrateur les réduit, la connexion suit aussitôt ; s’il les augmente, l’accès revient dans la limite de votre consentement précédent. Reconnectez le client et consentez à nouveau pour dépasser ce niveau enregistré.

N’ajoutez pas de nom d’organisation à l’endpoint. OAuth lie l’organisation à la connexion ; une clé API v1 ne le remplace pas. Utilisez les exemples de connexion de Boldo pour votre client, dont les menus et formats peuvent varier.

Suggérer ou modifier des données

Selon les droits, les outils de lecture couvrent schémas, documentation, actifs, relations, visualisations, processus, analyses d’impact et scénarios. Les outils de lecture peuvent aussi compter les actifs ou les valeurs distinctes, totaliser une propriété numérique et calculer sa moyenne. Demandez un total ou une répartition selon une ou deux dimensions. Les groupes multivalués peuvent se chevaucher : leur somme peut différer du total général.

MCP fournit aussi les ressources boldo://docs/getting-started et boldo://docs/metamodel-overview.

Demandez au client ce que vous avez à faire : il lit les onglets À faire et Mes suggestions de votre Accueil. Chaque catégorie arrive avec son total, ses premiers actifs et un lien pour l’ouvrir dans Boldo. À compléter exige la qualité du référentiel. À attester exige aussi le contexte réel. Transmettez scenarioId pour lire votre liste dans un scénario.

Si la qualité du référentiel est active, un Administrateur ou le Propriétaire peut aussi demander la vue d’ensemble de la qualité de l’organisation. Elle donne la fraîcheur et la complétude par type et par propriétaire, les propriétaires partis ou qui ne lisent pas leurs actifs, et les suggestions en attente, dont celles sur des actifs sans propriétaire. Transmettez scenarioId pour consulter le scénario, sans indicateurs dédiés de fraîcheur. Les contrôles des propriétaires partis ou sans accès en lecture portent toujours sur les données réelles. Cette vue est en lecture seule : agissez depuis les rapports de qualité ou les liens qu’elle renvoie.

Un client peut demander la charte de Boldo, avec couleurs, polices et logo, même avec l’accès Plateforme. Demandez-lui de l’utiliser pour un rapport ou un graphique. Le style que vous choisissez reste prioritaire ; vérifiez le résultat, car les clients peuvent appliquer ces indications différemment. Boldo est la source des données, pas l’auteur du rapport.

Si les suggestions sont autorisées, demandez au client de suggérer une création d’actif, une correction de propriété, une modification de relation ou un archivage d’actif. Examinez-les dans le parcours de suggestions de Boldo. Vous pouvez aussi demander au client de lister les suggestions d’un actif et de retirer une suggestion en attente que vous avez envoyée. Une suggestion de création peut inclure jusqu’à 50 relations vers des actifs existants ou d’autres suggestions de création en attente. Chaque relation compte aussi dans la limite commune d’écriture. L’envoi d’une suggestion n’applique pas le changement suggéré.

Vous pouvez aussi faire corriger une suggestion de création en attente dont vous êtes l’auteur ou que vous pouvez créer. Le client peut modifier son nom, ses propriétés, domaines, propriétaires et sa note, sans la retirer d’abord. Pour corriger ses relations ensuite, envoyez ou retirez les suggestions de relation correspondantes. Relisez la suggestion de création dans Boldo avant de créer l’actif.

L’écriture directe exige trois autorisations :

1. Un Administrateur ou le Propriétaire active Autoriser les écritures directes via MCP dans Gestion de l’organisation > MCP.
2. Votre Niveau MCP est Lecture, suggestions et écriture.
3. Vous choisissez Écriture en connectant le client.

Le client peut alors créer, modifier, archiver et restaurer des actifs, puis créer, modifier ou retirer des relations. Il peut aussi attester dans les données réelles les actifs dont vous êtes propriétaire si la qualité du référentiel est active, et accepter ou refuser les suggestions en attente que vous pouvez traiter. La création et la modification d’actifs, les attestations et le traitement des suggestions acceptent des lots de 50 éléments au maximum. Une suggestion dont la valeur a changé depuis son envoi est ignorée, jamais écrasée, et accepter un archivage demande une confirmation explicite. Lisez chaque résultat, y compris les éléments ignorés : une réponse réussie peut contenir des échecs partiels.

Les écritures directes prennent effet immédiatement

Ces outils n’ouvrent pas de carte de proposition IA dans le chat Boldo. Une éventuelle confirmation relève de votre client externe. Précisez le périmètre et le contexte souhaités, puis contrôlez le résultat enregistré dans Boldo. Une réponse interrompue ne prouve pas l’absence de modification.

Suggestions et écritures directes partagent une limite de 100 éléments par période de 60 secondes, par membre et organisation. Un lot compte un élément par entrée. Respectez le délai indiqué avant de réessayer. Si cette limite ne peut pas être vérifiée, écritures et suggestions deviennent temporairement indisponibles ; la lecture reste disponible.

Travailler dans un scénario

Demandez au client de lister les scénarios avec listScenarios. Choisissez un scénario accessible, actif et prêt. Transmettez scenarioId à chaque appel concerné, y compris getScenarioDiff. Sans ce paramètre, l’appel vise les données réelles ; aucun basculement persistant de session MCP n’existe.

Les lectures, suggestions et écritures compatibles utilisent ce contexte de scénario. Leur disponibilité dépend toujours de l’offre et de vos droits. MCP ne peut ni créer, ni appliquer, ni abandonner un scénario. Utilisez l’interface des scénarios pour ces actions.

Retirer une connexion

Pour votre connexion, ouvrez Paramètres du compte > Sécurité > Apps connectées. Retrouvez le client et l’organisation, cliquez sur Révoquer, puis confirmez avec Révoquer dans Révoquer l’accès.

Comme Administrateur ou Propriétaire, ouvrez Gestion de l’organisation > MCP > Agents connectés. Retrouvez le client et le membre, cliquez sur Révoquer, puis confirmez dans Révoquer l’accès de l’agent. Les autres connexions restent distinctes.

La révocation coupe la connexion aussitôt, jetons d’accès déjà émis compris, et impose un nouveau consentement pour se reconnecter. L’appartenance, les droits et l’accès MCP sont revérifiés lors des requêtes. Désactiver l’écriture directe dans l’organisation bloque les écritures suivantes, sans annuler les changements ni désactiver les suggestions autorisées.

Diagnostiquer une connexion

Symptôme	Vérification
Organisation absente de l’écran de connexion	Offre, activation IA, autorisations IA/MCP et méthode de connexion acceptée.
Authentification refusée	Session, expiration du jeton, SSO, double authentification et règles IP.
Outils de schéma uniquement	Niveau d’accès IA du membre.
Résultats métier vides	Organisation, scénario et droits métier.
Outil de suggestion absent	Accès IA aux données métier, niveau MCP autorisant les suggestions et accès choisi à la connexion.
Outil d’écriture absent	Réglage de l’organisation, niveau MCP et type du membre, accès choisi à la connexion et droits métier.
Limite de débit atteinte	Respecter le délai indiqué ; les limites de requêtes et d’éléments modifiés sont distinctes.

MCP limite les requêtes à 60 par période de 60 secondes, par jeton. Cela diffère de l’API v1, limitée par organisation. Faites corriger les accès par un administrateur plutôt que de désactiver les protections.