Miro MCP Server (guide d’administration) – Centre d'aide de Miro

Qui peut le faire : admin d’entreprise et admin d’équipe sur les forfaits Enterprise

En tant qu’admin d’entreprise pour un abonnement Enterprise, vous contrôlez si Miro MCP Server est disponible pour votre organisation. Ce paramètre détermine si vos équipes peuvent utiliser des intégrations IA qui se connectent à Miro.

Utilisez Miro MCP (Model Context Protocol) pour connecter vos tableaux Miro à des outils d’IA compatibles MCP. Lorsqu’il est activé et autorisé, des agents d’IA peuvent lire le contexte de tableaux spécifiques et, lorsque cela est permis, effectuer des actions comme résumer du contenu ou créer des diagrammes via un ensemble sélectionné d’outils Miro MCP. Ce guide explique les prérequis, l’activation, la gouvernance et le dépannage.

Avant de commencer

Activez MCP pour votre organisation, puis utilisez Contrôle d’accès pour décider qui peut l’utiliser.
Vous pouvez laisser l’accès ouvert à tout le monde, ou le limiter à des équipes sélectionnées et, facultativement, à des groupes d’utilisateurs. Les autorisations au niveau des tableaux restent applicables.

Activer ou désactiver MCP Server

Pour activer MCP Server :

Allez à Paramètres admin > Applications et intégrations > MCP.
Sous Activer MCP, activez Autoriser les utilisateurs de votre organisation à connecter Miro à des clients compatibles MCP.

Les modifications sont appliquées immédiatement.

Pour interrompre temporairement l’utilisation, désactivez ce même interrupteur (cela empêche les nouveaux appels d’outil).

Si vous ne voyez pas les paramètres MCP, contactez votre responsable de compte.

Contrôler l’accès avec des équipes et des groupes d’utilisateurs

Sous Contrôle d’accès > Équipes et groupes d’utilisateurs, choisissez qui peut utiliser Miro MCP après l’avoir activé.

Paramètre	Qui peut utiliser MCP
Tout le monde (par défaut)	Tous les utilisateurs qui sont membres des équipes activées
Équipes et groupes d’utilisateurs spécifiques	Uniquement les utilisateurs qui appartiennent à la fois aux équipes et aux groupes d’utilisateurs que vous sélectionnez

Restreindre l’accès à des équipes et des groupes d’utilisateurs spécifiques

Dans la console d’admin, allez à Applications et intégrations > MCP.
Sous Contrôle d’accès, ouvrez le menu déroulant Équipes et groupes d’utilisateurs, puis sélectionnez Équipes et groupes d’utilisateurs spécifiques.
Le panneau Ajouter l’accès MCP s’ouvre.
Sélectionner les équipes :
1. Choisissez Toutes les équipes de votre organisation, ou Équipes spécifiques.
2. Si vous choisissez Équipes spécifiques, ouvrez le sélecteur d’équipes, recherchez et sélectionnez des équipes, cliquez sur Ajouter des équipes, puis revenez au panneau.
3. Cliquez sur Suivant.
Filtrer par groupe d’utilisateurs :
1. Choisissez Tous les utilisateurs des équipes sélectionnées, ou Uniquement les utilisateurs qui sont également dans des groupes d’utilisateurs spécifiques.
2. Si vous choisissez des groupes d’utilisateurs spécifiques, ouvrez le sélecteur de groupes d’utilisateurs, recherchez et sélectionnez des groupes, cliquez sur Ajouter des groupes d’utilisateurs, puis revenez au panneau.
3. Cliquez sur Suivant.
Examiner et confirmer le résumé (par exemple, les utilisateurs de 6 équipes qui font aussi partie d’un groupe d’utilisateurs auront accès à Miro MCP). Vous pouvez cliquer sur Modifier pour changer les équipes ou les groupes d’utilisateurs.
Cliquez sur Ajouter l’accès.

Comment fonctionne l’accès par équipes et groupes d’utilisateurs

Lorsque vous utilisez Équipes et groupes d’utilisateurs spécifiques, un utilisateur ne peut autoriser Miro MCP que s’il satisfait aux deux conditions que vous avez configurées :

Il appartient à une équipe sélectionnée (ou à n’importe quelle équipe, si vous avez choisi Toutes les équipes).
Si vous avez sélectionné des groupes d’utilisateurs, il appartient également à au moins un de ces groupes d’utilisateurs.

Si vous choisissez Tous les utilisateurs des équipes sélectionnées, seule l’exigence concernant l’équipe s’applique.

L’appartenance à un groupe d’utilisateurs seule n’est pas suffisante. L’utilisateur doit également être dans une équipe sélectionnée.

Lorsque vous sélectionnez plusieurs groupes d’utilisateurs, un utilisateur doit correspondre à n’importe lequel d’entre eux (pas à tous).

Exemples

Tout le monde : Tout utilisateur d’une équipe activée peut autoriser MCP.
Équipes spécifiques (par exemple A et B), tous les utilisateurs des équipes sélectionnées : Les utilisateurs de l’équipe A ou de l’équipe B peuvent autoriser MCP. Les utilisateurs présents uniquement dans l’équipe C ne peuvent pas.
Équipes spécifiques (équipe A) et groupes d’utilisateurs spécifiques (groupe d’utilisateurs 1) : Uniquement les utilisateurs qui sont dans l’équipe A et le groupe d’utilisateurs 1 peuvent autoriser MCP. Par exemple, si l’équipe A compte 100 membres et que le groupe d’utilisateurs 1 en inclut 20, seuls ces 20 peuvent utiliser MCP.
Toutes les équipes et groupes d’utilisateurs spécifiques : Les utilisateurs de n’importe quelle équipe qui sont également dans un groupe d’utilisateurs sélectionné peuvent autoriser MCP.
Revenir à Tout le monde : L’accès n’est plus limité aux équipes et groupes d’utilisateurs que vous avez sélectionnés dans le panneau.

Comment fonctionnent l’accès et les autorisations

Lorsque vous activez MCP, vous autorisez :

Des agents d’IA externes à lire le contenu des tableaux lorsque les utilisateurs l’autorisent.
Des outils d’IA à créer ou modifier du contenu sur les tableaux Miro.
Un échange de données sécurisé entre Miro et des applications tierces.

Considérations de sécurité importantes :

L’accès est authentifié via OAuth 2.1, ou via l’autorisation gérée par l’entreprise (EMA) pour Claude lorsque vous l’activez. Voir Configurer l’autorisation gérée par l’entreprise pour Miro MCP.
Les utilisateurs ne peuvent accorder l’accès qu’aux tableaux qu’ils sont autorisés à consulter.
La conformité en matière de sécurité de l’entreprise est maintenue.
Les limites de taux standard de l’API s’appliquent à toutes les opérations.
Les utilisateurs de votre organisation pourront s’authentifier auprès du MCP Server, permettant à des agents d’IA externes ou tiers de lire et de créer du contenu sur un tableau en leur nom.
Si vous restreignez MCP avec des équipes et des groupes d’utilisateurs, les utilisateurs en dehors de cette sélection ne peuvent pas autoriser MCP via OAuth. L’EMA utilise à la place l’équipe par défaut et les émetteurs de confiance que vous configurez.

Gestion de MCP dans votre organisation

En tant qu’admin, vous devriez envisager :

Communication : Informez vos équipes de la disponibilité de Miro MCP et des cas d’utilisation.
Formation : Fournissez des consignes sur l’utilisation efficace de MCP avec différents outils d’IA.
Gouvernance : Établissez des règles pour l’utilisation appropriée du contenu généré par l’IA.
Surveillance : Passez périodiquement en revue l’utilisation de MCP et ajustez les paramètres si nécessaire.

Pour plus d’informations sur la gestion des applications dans votre environnement Miro, consultez la documentation sur la gestion des applications.

Conseils de déploiement

Commencez petit : sous Contrôle d’accès, choisissez Équipes et groupes d’utilisateurs spécifiques, sélectionnez une ou deux équipes pilotes, et laissez les groupes d’utilisateurs sur Tous les utilisateurs des équipes sélectionnées.
Pour un pilote plus restreint, choisissez également Uniquement les utilisateurs qui sont également dans des groupes d’utilisateurs spécifiques afin que seul ce groupe puisse autoriser MCP.
Renforcez l’hygiène des prompts : exigez que les utilisateurs incluent l’URL complète du tableau dans chaque prompt MCP.

Configurer l’autorisation gérée par l’entreprise pour Claude

L’autorisation gérée par l’entreprise (EMA) permet à votre fournisseur d’identité d’accorder l’accès Miro MCP pour Claude, de sorte que les utilisateurs n’effectuent pas une connexion OAuth Miro séparée. Les autres clients MCP continuent d’utiliser OAuth.

Sur la page MCP, sous Autorisation gérée par l’entreprise, vous sélectionnez une équipe par défaut, ajoutez des émetteurs de confiance depuis votre fournisseur d’identité (Okta dans la première version), et terminez la configuration dans la console d’admin Anthropic.

Plus d’informations : Voir Configurer l’autorisation gérée par l’entreprise pour Miro MCP.

Contrôler quels clients MCP peuvent se connecter à Miro

En tant qu’admin d’entreprise, vous pouvez autoriser tous les clients à accéder à Miro depuis votre organisation, ou gérer une liste d’autorisation de clients, y compris vos propres clients MCP personnalisés.

Suivez les étapes suivantes :

Dans la console d’admin, allez à Applications et intégrations > MCP. Si vous n’avez pas encore activé MCP, voir Activer ou désactiver MCP Server.
Sous Contrôle d’accès, Tous les clients est le réglage par défaut. Pour modifier, cliquez sur Tous les clients, puis cliquez sur Clients spécifiques.
Le panneau Clients MCP spécifiques s’ouvre.
Activez les commutateurs des clients que vous souhaitez autoriser. Pour autoriser un client MCP personnalisé, saisissez le nom de votre client dans la barre de recherche (en haut), puis cliquez sur Ajouter. Pour plus d’informations, voir la documentation développeur Miro MCP.
Cliquez sur Enregistrer.
Le panneau se ferme, et les clients spécifiés s’affichent en ligne sous Contrôle d’accès.

Pour interdire un client, revenez à Applications et intégrations > MCP > Tous les clients (sous Contrôle d’accès) et désactivez le client.

Si vous ajoutez un client MCP personnalisé puis que vous l’interdisez ultérieurement, le client est supprimé de la liste. Pour le réautoriser, vous devez le rajouter. Voir l’étape 3 dans Contrôler quels clients MCP peuvent se connecter à Miro.

Dépannage

« Je ne vois pas les outils Miro MCP dans mon client »
- Confirmez que MCP est activé pour l’organisation.
- Sous Contrôle d’accès > Équipes et groupes d’utilisateurs, confirmez que l’utilisateur est inclus (dans une équipe sélectionnée, et dans un groupe d’utilisateurs sélectionné si vous en avez configuré un).
- Relancez le flux OAuth et sélectionnez une équipe qui a accès à MCP.
- Pour Claude avec l’autorisation gérée par l’entreprise, confirmez que l’EMA est activée, que l’utilisateur fait partie de l’équipe EMA par défaut, que l’émetteur de confiance affiche Discovery resolved et Keys reachable, et que l’EMA est activée pour le connecteur Miro dans la console d’admin Anthropic.
- Vérifiez que le client prend en charge MCP et figure parmi les clients que nous ciblons/documentons.
« Accès refusé lors de l’envoi d’un prompt »
- Assurez-vous que le prompt inclut l’URL complète du tableau ; les agents ne découvriront pas automatiquement les tableaux.
- Confirmez que l’utilisateur a déjà accès à ce tableau dans Miro.
- Si l’utilisateur avait précédemment accès et que cela a cessé de fonctionner, vérifiez si le contrôle d’accès Équipes et groupes d’utilisateurs a été modifié, ou s’il a été retiré d’une équipe ou d’un groupe d’utilisateurs sélectionnés.
« Nous devons suspendre l’utilisation maintenant »
- Désactivez MCP dans Paramètres admin > Applications et intégrations > MCP.
« Le client d’un utilisateur est bloqué / renvoie une erreur d’accès »
- Confirmez que le client est activé sous Contrôle d’accès, ou ajoutez-le comme client personnalisé.