MCP, ou Model Context Protocol, est un protocole standard ouvert qui permet aux applications IA de se connecter à des outils externes et à des sources de données via un protocole commun. Le serveur MCP de Revizto vous permet de connecter en toute sécurité vos outils IA aux données de votre projet Revizto. Une fois cela fait, vous pouvez poser des questions concernant votre projet, obtenir des informations sur ce dernier et effectuer des actions guidées directement depuis l’assistant IA de votre choix.

• Prérequis
• Paramètres de connexion
• URL du serveur MCP de Revizto
• Configuration de la connexion MCP
• Limites
• Meilleures pratiques
• Dépannage

Voir aussi :

• Portail des développeurs de Revizto

Prérequis

Avant de connecter un outil IA au serveur MCP de Revizto, vérifiez que vous avez :

• Accès à la région Revizto où sont stockées les données de votre projet.
• Accès à un outil IA pris en charge capable de se connecter à des serveurs MCP distants.
• L’URL du serveur MCP de Revizto de votre région.

Vous devrez également vous assurer que l’application Revizto MCP Server est activée pour votre compte d’organisation avant d’ajouter le serveur à votre outil IA. Pour vérifier si l’application Revizto MCP Server est active pour votre compte :

• Propriétaires et administrateurs de compte : Accédez à Gérer les informations du compte > Portail des développeurs.
• Utilisateurs standard : Accédez à Informations du compte > Intégrations d’applications.

Si l’application Revizto MCP Server n’est pas active, demandez au propriétaire ou à un administrateur de votre compte de l’activer. Les propriétaires et les administrateurs de compte peuvent activer l’application Revizto MCP Server depuis le portail des développeurs en suivant les étapes de la section Portail des développeurs Revizto.

Pour garantir la sécurité de vos données Revizto, respectez toujours les politiques de sécurité internes de votre organisation.

• Connectez uniquement des outils IA de confiance au serveur MCP de Revizto.
• Utilisez l’URL du serveur MCP de Revizto correspondant à votre région.
• Passez toujours en revue les actions d’écriture. Demandez à l’assistant IA d’afficher les modifications prévues avant de les appliquer.
• Le serveur MCP de Revizto utilise vos droits d’accès à Revizto. Les actions administratives nécessitent un accès à Revizto de niveau administrateur.
• Respectez les politiques d’utilisation des IA de votre organisation. Vérifiez la liste des outils IA approuvés avant d’en connecter à des données Revizto.

Paramètres de connexion

Le serveur MCP de Revizto utilise Streamable HTTP pour la connectivité. Bien que les noms des champs puissent varier selon les différentes plateformes IA, les principaux prérequis de connexion restent les mêmes. De plus, certains outils IA basés sur le cloud configurent des serveurs MCP en tant que connecteurs personnalisés. Pour faciliter le processus d’authentification, le serveur MCP de Revizto utilise un ID client OAuth. 

Référez-vous aux valeurs des paramètres du tableau lors de la configuration de votre connexion. 

Pour les fichiers de configuration, utilisez cette structure standard Streamable HTTP avec l’URL de votre région :

{
  "mcpServers": {
    "<le nom de votre serveur>": {
      "type": "http",
      "url": "https://api.<région du serveur>.revizto.com/mcp",
      "oauth": {
        "clientID": "revizto-mcp"
      }
    }
  }
}

URL du serveur MCP de Revizto

Lors de la connexion de votre outil IA au serveur MCP de Revizto, vous devrez utiliser l’URL du serveur MCP de la région où vos données Revizto sont hébergées.

Si vous avez des comptes Revizto hébergés dans différentes régions, vous pouvez ajouter plusieurs serveurs MCP de Revizto au même outil IA. Ajoutez l’URL du serveur MCP de chaque région que vous utilisez, puis autorisez chaque connexion. Une fois cela fait, vous pourrez demander à l’assistant IA de travailler sur plusieurs régions pour, par exemple, comparer les nombres d’annotations entre régions, résumer les risques des projets de toutes les régions ou préparer un document de coordination interrégionale.

L’outil IA pourra combiner les données de plusieurs connexions régionales autorisées au sein d’une même conversation. Les données Revizto resteront dans leur région d’origine, et l’assistant ne peut accéder qu’aux comptes, licences et projets auxquels votre compte utilisateur Revizto est autorisé à accéder.

Configuration de la connexion MCP

Le serveur MCP de Revizto est un serveur MCP distant qui utilise le protocole HTTPS. Dans les outils qui demandent un type de transport, choisissez Streamable HTTP ou Serveur MCP distant.

Les étapes de configuration varient selon l’outil, mais généralement, voici ce qu’il faut faire :

1. Ouvrez les paramètres de l’outil.
2. Dans les paramètres, recherchez Connecteurs, Applications, MCP, Outils ou Intégrations.
3. Ajoutez un nouveau connecteur personnalisé, une application personnalisée ou un serveur MCP.
4. Repérez le paramètre d’URL et renseignez l’URL du serveur MCP de Revizto de votre région.
5. Repérez le champ ID client OAuth et renseignez l’ID client du MCP de Revizto.
6. Laissez le secret client OAuth vide.
7. Enregistrez la connexion.
8. Lorsque vous êtes invité à vous authentifier, connectez-vous à votre compte Revizto.
9. Demandez à l’assistant IA de lister les outils Revizto disponibles ou de confirmer la connexion.

Selon l’outil IA, il peut vous être demandé de vous connecter à votre compte Revizto immédiatement après l’ajout du serveur MCP ou dès la première invite nécessitant des données Revizto. Au démarrage de l’authentification, votre outil IA ouvrira une fenêtre de connexion à Revizto. Connectez-vous en utilisant la méthode d’authentification requise pour votre compte Revizto (e-mail et mot de passe ou SSO).

Une fois l’autorisation effectuée, l’outil IA reçoit un accès uniquement pour l’utilisateur Revizto authentifié. Cela signifie qu’il aura les mêmes droits d’accès au compte, licences et projets que cet utilisateur. Seules les actions et les données disponibles à cet utilisateur seront disponibles à l’outil IA.

Les sections suivantes fournissent des détails supplémentaires concernant la configuration d’outils IA populaires.

{
  "servers": {
    "<le nom de votre serveur>": {
      "type": "http",
      "url": "https://api.<région du serveur>.revizto.com/mcp",
      "oauth": {
        "clientId": "Revizto MCP"
      }
    }
  }
}

Pour confirmer que l’installation a bien fonctionné, utilisez l’invite suivante : 

Vérifie ma connexion MCP pour Revizto. Dis-moi à quel compte Revizto et à quelle région tu peux accéder, puis liste les outils Revizto disponibles en langage courant.

Si l’assistant IA indique qu’il ne peut pas accéder à Revizto, vérifiez les points suivants :

• Le serveur MCP de Revizto est actif pour votre compte. Les membres de compte standard peuvent consulter la page Intégrations d’applications. Les propriétaires et les administrateurs de compte peuvent consulter la page Portail des développeurs.
• Vous avez utilisé l’URL régionale correcte.
• Vous avez terminé la connexion OAuth de Revizto.
• Votre outil IA prend en charge les serveurs MCP distants.
• Votre compte utilisateur Revizto a accès au compte, à la licence et aux projets sur lesquels vous vous renseignez auprès de l’IA.

Limites

Bien que le serveur MCP de Revizto couvre de nombreux flux de travail de coordination, certains ne sont pas pris en charge actuellement. Gardez à l’esprit les éléments suivants :

• Les propriétés de modèles et d’objets ne sont pas exposées via MCP, y compris la recherche d’objets, les éléments modifiés, la lecture des propriétés d’objets et le raisonnement annotation‑objet. (Bientôt disponible !)
• Les captures d’écran et les images ne sont pas exposées via MCP.
• Les abonnements aux événements ainsi que les webhooks ne sont pas exposés via MCP.
• Les registres de projet, de licence et de compte ne sont pas exposés via MCP.
• L’importation et l’exportation de modèles ne sont pas exposées via MCP.
• Les grands projets peuvent nécessiter un filtrage minutieux pour éviter des réponses IA lentes ou coûteuses.
• Certains outils IA limitent le nombre d’outils MCP qu’ils peuvent utiliser simultanément. S’il manque des outils, désactivez les serveurs MCP non utilisés ou les outils non utilisés dans votre outil IA.

Meilleures pratiques

Une fois le serveur MCP de Revizto configuré, votre assistant IA peut utiliser les outils de Revizto pour lire des données de coordination telles que les annotations, les commentaires, les conflits, les feuilles, les rapports, les flux de travail, les modèles de tampons, les licences, les projets et les utilisateurs. Selon vos droits d’accès et la configuration de la version finale, l’assistant pourrait également aider à préparer ou appliquer les mises à jour choisies.

Le MCP de Revizto est utile pour trois types de flux de travail.

Les grands projets peuvent contenir beaucoup de données. Commencez par une invite ciblée, puis posez d’autres questions. Cela permet d’obtenir des réponses plus rapides, plus claires et moins coûteuses dans les outils IA qui facturent leur usage avec des jetons.

Pour de meilleurs résultats, suivez ces conseils :

• Commencez par un projet, un lot, une zone ou un destinataire.
• Demandez d’abord des décomptes et des résumés avant de demander de longues listes.
• Demandez à l’assistant d’afficher les filtres qu’il a utilisés.
• Demandez d’abord les 10 premiers exemples, puis élargissez si nécessaire.
• Pour les actions d’écriture, incluez « attendre l’approbation avant d’appliquer les modifications » dans votre invite.
• Pour les grands projets, évitez les invites qui demandent toutes les annotations, tous les commentaires, tous les conflits et toutes les feuilles en une seule fois.
• Si le résultat semble surprenant, demandez à l’assistant d’afficher les documents sources qu’il a utilisés.

Pour commencer, essayez les prompts suivants : 

• Combien de feuilles de dessin y a-t-il dans <nom du projet> ?
• Combien d’annotations ont à la fois l'état Ouvert et la sévérité Critique dans <nom du projet> ?
• Réattribue les annotations de <utilisateur A> ayant l'état Ouvert à <utilisateur B> et ajoute en commentaire "réattribué par <utilisateur A>" dans <nom du projet>. 
• Ferme les annotations de <utilisateur A> ayant l'état Résolu créées il y a plus que 30 jours dans <nom du projet>.
• Définis une date d’échéance au vendredi suivant pour les annotations de <utilisateur A> ayant l'état Ouvert dans <nom du projet>.
• Déplace les annotations de <utilisateur A> ayant l'état Ouvert vers les annotations ayant l'état En cours dans <nom du projet>. 
• Définis les annotations Conduite vs Structure de <utilisateur A> ayant l'état Ouvert sur la sévérité Critique dans <nom du projet>.

Dépannage

Q : L’outil IA ne peut pas se connecter au serveur MCP de Revizto. 

R : Confirmez que l’URL régionale est correcte et que l’outil IA prend en charge les serveurs MCP distants. 

Q :  J’ai plusieurs comptes Revizto. Ils n’utilisent pas tous les mêmes méthodes d’authentification SSO et le serveur MCP ne s’est pas connecté à tous les comptes. Comment effectuer l’authentification pour ces comptes ?

R : Le serveur MCP de Revizto ne peut accéder qu’aux comptes utilisant les méthodes d’authentification utilisées lors du flux d’autorisation le plus récent. Pour autoriser des comptes utilisant une méthode d’authentification différente, accédez à votre profil dans Revizto Workspace, puis à Sessions actives > API et autorisez les comptes nécessaires.

Q : L’outil IA me demande de me connecter à nouveau. 

R : Terminez le processus de connexion Revizto. Si vous avez plusieurs comptes Revizto et qu’ils utilisent chacun des méthodes d’authentification SSO différentes, autorisez le compte nécessaire depuis votre profil dans Revizto Workspace, puis accédez à Sessions actives > API.

Q : L’assistant IA ne voit pas un projet.

R : Confirmez que l’application Revizto MCP Server est active pour votre compte, que vous êtes connecté dans la bonne région pour le projet en question et que l’utilisateur Revizto authentifié a accès à ce projet. Si le serveur Revizto MCP doit être activé, réauthentifiez-vous dans l’outil IA pour vous assurer que le compte est accessible via MCP. 

Q : Certains outils sont indisponibles.

R : Votre outil IA peut limiter le nombre d’outils actifs ou bien vous n’avez pas les droits nécessaires dans Revizto pour utiliser ces outils. 

Q : Une action d’écriture a échoué. 

R : Confirmez que votre rôle Revizto autorise cette action dans le compte, la licence ou le projet en question. 

Q : La réponse de l’IA est lente ou trop coûteuse. 

R : Restreignez l’invite par projet, date, état, destinataire, zone, priorité, nombres de résultats. Reportez-vous aux meilleures pratiques pour obtenir des conseils supplémentaires.