Vertice AI
officielDiscutez avec vos contrats, fournisseurs et dépenses SaaS
Que pouvez-vous faire avec Vertice AI MCP ?
- Analyse des contrats — Interrogez en langage naturel les échéances de contrats, les conditions de renouvellement ou les détails du portefeuille.
- Analyse des dépenses — Interrogez les dépenses annuelles totales par fournisseur ou par catégorie et comparez les fournisseurs.
- Intelligence fournisseur — Récupérez les informations sur un fournisseur et les fournisseurs associés dans la même catégorie.
- Recherche de documents — Trouvez et résumez le dernier contrat signé pour un fournisseur spécifique.
- Création de demande d’achat — Demandez de nouveaux bons de commande, comme des sièges supplémentaires pour le produit d’un fournisseur.
- Statut de conformité — Vérifiez les informations liées à la conformité pour les contrats ou les fournisseurs.
Documentation
1. Qu'est-ce que le connecteur MCP Vertice AI ?
Le connecteur MCP Vertice AI est un point de terminaison hébergé qui permet à un assistant IA externe compatible — par exemple, Claude — d'interroger votre espace de travail d'approvisionnement Vertice et de déclencher des flux de travail Vertice en votre nom, en utilisant le langage naturel. Il implémente le Model Context Protocol (MCP) ouvert au-dessus de la plateforme Vertice existante.
Le connecteur est un canal d'accès supplémentaire à Vertice. Il expose les mêmes données d'approvisionnement et flux de travail que vous pouvez déjà utiliser via l'application web Vertice, régis par les mêmes contrôles d'accès basés sur les rôles.
Connecter un assistant IA ne donne accès à rien que vous ne puissiez déjà voir dans Vertice vous-même.
Tout au long de ce document, nous utilisons Claude comme exemple concret. Le même connecteur fonctionne avec tout assistant IA compatible MCP prenant en charge le transport HTTP Streamable MCP et OAuth 2.1 avec PKCE (S256).
2. Exemples de cas d'utilisation
Le connecteur est destiné aux questions et flux de travail liés à l'approvisionnement. Voici des exemples de questions que vous pourriez poser. Chacune correspond à l'un des outils listés dans la section 4.
- « Quels contrats de notre portefeuille expirent dans les 90 prochains jours ? »
- « Quel est notre dépense annuelle totale avec ce fournisseur, et quels autres fournisseurs sont dans la même catégorie ? »
- « Trouvez le dernier contrat signé pour ce fournisseur et résumez les conditions de renouvellement. »
- « Ouvrez une nouvelle demande d'achat pour 25 sièges supplémentaires du produit de ce fournisseur. »
Ce sont des exemples. L'ensemble exact des outils, paramètres et comportements est déterminé par la couche d'orchestration de Vertice au moment de la requête.
3. Compatibilité et prérequis
| Exigence | Détail |
|---|---|
| Abonnement Vertice actif | Vous devez être un utilisateur sur un locataire Vertice actif. |
| Compte utilisateur Vertice | Un compte utilisateur en règle, avec la permission d'utiliser les fonctionnalités IA Vertice. |
| Authentification | Le connecteur vous authentifie via la configuration d'authentification Vertice existante de votre locataire. Si votre locataire utilise l'authentification unique (SSO) via un fournisseur d'identité SAML 2.0, vous vous connectez avec vos identifiants d'entreprise habituels. Si votre locataire utilise l'authentification native de Vertice, vous vous connectez avec votre nom d'utilisateur et mot de passe Vertice. |
| Abonnement assistant IA | Un abonnement auprès de votre fournisseur d'assistant IA choisi qui prend en charge l'ajout de connecteurs personnalisés. Pour Claude.ai, cela nécessite actuellement un plan Team ou Enterprise ; veuillez consulter la documentation d'Anthropic pour la disponibilité la plus récente des plans. |
Le connecteur lui-même est un service hébergé. Aucun logiciel n'est installé sur votre infrastructure. Aucune clé API personnelle n'est délivrée.
4. Catégories d'outils
Le connecteur expose des outils dans les catégories suivantes liées à l'approvisionnement. Chaque outil annonce des annotations MCP explicites readOnlyHint et destructiveHint, afin que les assistants IA compatibles puissent avertir l'utilisateur avant d'invoquer des actions d'écriture.
| Catégorie | Lecture seule | Effectue des écritures |
|---|---|---|
| Analytique des contrats | ✔ | |
| Analytique des dépenses | ✔ | |
| Intelligence fournisseurs | ✔ | |
| Recherche documentaire | ✔ | |
| Statut de conformité | ✔ | |
| Création de demandes d'achat | ✔ (additif — crée uniquement de nouvelles entités) | |
| Mises à jour des métadonnées de contrats | ✔ (mutation contrôlée) |
La liste faisant autorité des outils est découvrable directement dans votre assistant IA — l'assistant appelle la méthode MCP standard tools/list contre le connecteur et affiche les noms, descriptions et annotations.
L'ensemble exact des outils peut évoluer. Les annotations sur chaque outil continueront d'indiquer s'il lit ou écrit.
5. Connexion de votre assistant IA
Chaque locataire Vertice a sa propre URL de connecteur de la forme :
https://ai.vertice.one/accounts/<your-account-id>/mcp
Remplacez <your-account-id> par votre ID de compte. Si vous ne connaissez pas votre identifiant de locataire, allez dans Paramètres → Intégrations → Accès API. Votre ID de compte est visible dans le coin supérieur droit. Si vous ne parvenez toujours pas à le récupérer, contactez le support Vertice.
Exemple : Ajout du connecteur à Claude
Il y a deux étapes : (1) configurer le connecteur et (2) l'activer pour un usage personnel.
Administrateur : Configurer le connecteur Vertice
Vous devez effectuer une configuration initiale pour le connecteur Vertice–Claude avant que vos collègues puissent l'utiliser. Seul le propriétaire du compte ou le propriétaire principal peut ajouter un connecteur personnalisé. Demandez l'aide de l'administrateur Claude de votre organisation si vous n'avez pas cette capacité.
-
Dans Claude, allez dans Paramètres de l'organisation → Connecteurs
-
Cliquez sur Ajouter
-
Survolez Personnalisé, puis sélectionnez Web
-
Ajoutez l'URL du connecteur ci-dessous, en remplaçant
<your-account-id>par votre ID de compte de 32 caractèreshttps://ai.vertice.one/accounts/<your-account-id>/mcp -
Cliquez sur Ajouter
Le connecteur est prêt à être activé par vos collègues.
Activer le connecteur pour un usage personnel
Les utilisateurs doivent activer le connecteur et authentifier leur compte en se connectant à Vertice via SSO ou connexion directe avant de pouvoir l'utiliser.
- Dans Claude, allez dans Personnaliser → Connecteurs
- Trouvez le connecteur Vertice dans la liste
- Cliquez sur Connecter — vous serez invité à vous authentifier en vous connectant à Vertice
Une fois authentifié, le connecteur sera activé et l'utilisateur pourra poser des questions à Claude sur vos données Vertice liées à l'approvisionnement dans n'importe quelle conversation.
Essayez en posant une question sur l'un de vos contrats ou fournisseurs.
6. Authentification
L'authentification utilise OAuth 2.1 avec PKCE (S256). Le flux est :
- Votre assistant IA récupère les métadonnées de ressource protégée RFC 9728 du connecteur pour découvrir le serveur d'autorisation.
- L'assistant IA récupère les métadonnées du serveur d'autorisation RFC 8414 pour découvrir les points de terminaison OAuth.
- L'assistant IA initie un flux de code d'autorisation OAuth 2.1 avec PKCE.
- Le transmetteur
/authorizede Vertice vous route directement vers le fournisseur d'authentification de votre locataire. Si votre locataire utilise SSO via SAML, Vertice vous route directement vers votre fournisseur d'identité SAML configuré, sans étape de sélection Vertice intermédiaire. Si votre locataire utilise l'authentification native de Vertice, vous voyez le formulaire de connexion Vertice. - Après une connexion réussie, la couche d'identité de Vertice émet un jeton d'accès à courte durée lié à votre utilisateur, votre locataire et la portée de ressource du connecteur.
- L'assistant IA présente ce jeton d'accès comme identifiant Bearer sur chaque requête MCP à Vertice.
Les jetons expirent automatiquement. Vous pouvez déconnecter le connecteur à tout moment depuis les paramètres de votre assistant IA ; cela n'affecte pas votre compte Vertice.
7. Permissions
Le connecteur applique vos contrôles d'accès basés sur les rôles Vertice existants. Les données auxquelles vous pouvez accéder via le connecteur sont exactement celles auxquelles vous pouvez accéder via l'application web Vertice, rien de plus.
Le même modèle de contrôle d'accès est partagé sur toutes les surfaces Vertice — l'application web, les intégrations Vertice pour Slack et Microsoft Teams, et le connecteur MCP Vertice AI. Chaque action qui modifie des données, quel que soit la surface qui l'a initiée, est capturée dans la piste d'audit existante de Vertice.
8. Limites de débit
Pour préserver la qualité de service, le connecteur applique des limites de débit au niveau applicatif :
| Portée | Limite |
|---|---|
| Par utilisateur authentifié | 60 requêtes par minute |
| Par locataire Vertice (tous utilisateurs du compte) | 300 requêtes par minute |
Lorsqu'une limite est atteinte, le connecteur renvoie une erreur JSON-RPC avec le code -32004, mappée sur HTTP 429 Too Many Requests avec les en-têtes suivants :
Retry-After: <seconds> X-RateLimit-Limit: <bucket-capacity> X-RateLimit-Remaining: 0 X-RateLimit-Reset: <unix-timestamp-when-window-resets>
Les assistants IA bien comportés honorent Retry-After. En usage interactif ordinaire, vous ne devriez pas atteindre ces limites. Elles existent principalement pour se protéger contre l'automatisation incontrôlée. Si la charge de travail légitime de votre locataire nécessite des seuils plus élevés, veuillez contacter votre gestionnaire de compte Vertice.
Lorsqu'une limite de débit est atteinte pendant une conversation Claude, le client Claude.ai peut afficher la réponse à l'utilisateur final comme un message d'erreur d'outil générique plutôt que comme un message explicite de limite de débit. La réponse au niveau du protocole est conforme aux spécifications ; le texte affiché à l'utilisateur est déterminé par l'assistant IA, pas par Vertice. Si vous rencontrez une telle erreur, attendez quelques secondes avant de réessayer.
9. Taille des réponses des outils
Le connecteur vise la limite de réponse de 25 000 jetons définie par les directives de l'Anthropic Connectors Directory. Pour garder les résultats utilisables pour de très grandes requêtes, une troncature de sécurité est appliquée à environ 20 000 jetons ; si elle s'active, la réponse inclut un pied de page explicite indiquant que la troncature a eu lieu et comment affiner la requête. En usage normal, l'orchestration Vertice sous-jacente est conçue pour paginer les grandes opérations de liste et vous ne devriez pas voir le pied de page de troncature.
10. Traitement des données
Une description de la posture de sécurité IA plus large de Vertice — SOC 2 Type 2, chiffrement, isolation des locataires, fournisseurs de modèles et contrôles de précision — est présentée dans notre Politique de confidentialité du connecteur MCP IA. Des documents de sécurité supplémentaires sont disponibles dans le Portail de confiance Vertice.
Important
Lorsque vous posez une question à un assistant IA externe qui appelle le connecteur, votre invite et la réponse du connecteur sont transmises au fournisseur de cet assistant IA. Leur politique de confidentialité et leurs conditions régissent ce qu'ils font de ces données.
Vertice ne contrôle ni n'audite le traitement en aval par le fournisseur de l'assistant IA. Veuillez examiner les politiques du fournisseur de l'assistant IA avant d'activer le connecteur.
11. Support
| Motif | Canal |
|---|---|
| Problèmes fonctionnels, aide à la configuration | Support Vertice ([email protected]) |
| Questions sur le compte | Votre gestionnaire de compte |
| Questions de confidentialité, demandes de droits des personnes concernées | [email protected] |
| Divulgation de vulnérabilité de sécurité | [email protected] — voir aussi notre Politique de divulgation des vulnérabilités |
12. Foire aux questions
Le connecteur envoie-t-il mes données Vertice au fournisseur de mon assistant IA ?
Lorsque vous posez une question à un assistant IA externe qui appelle le connecteur, votre invite et la réponse de l'outil du connecteur sont transmises à l'infrastructure du fournisseur de l'assistant IA (par exemple, à Anthropic pour le connecteur Claude.ai). C'est la nature inévitable d'un connecteur MCP. Vertice ne contrôle ni n'audite ce que le fournisseur de l'assistant IA fait de ces données — cela est régi par votre accord avec le fournisseur de l'assistant IA. Nous vous encourageons vivement à examiner la politique de confidentialité du fournisseur de l'assistant IA avant d'activer le connecteur.
Le connecteur voit-il mon historique de chat Claude ou toute autre donnée dans Claude ?
Non. Le connecteur reçoit uniquement les enveloppes de requêtes MCP explicites que Claude envoie — le nom de l'outil et les paramètres de l'outil. Il n'a pas accès à la mémoire de Claude, aux résumés de conversation, aux conversations antérieures ou aux fichiers téléchargés dans Claude.
Le connecteur modifiera-t-il mes données Vertice sans mon approbation ?
Les outils qui effectuent des écritures portent des annotations MCP explicites destructiveHint et readOnlyHint=false, qui signalent aux assistants IA compatibles de confirmer avec l'utilisateur avant de les invoquer. Claude suit ce modèle. Si vous utilisez un assistant IA qui ne respecte pas ces annotations, veuillez utiliser le connecteur uniquement avec des outils de lecture ou le désactiver.
Deux utilisateurs sur le même locataire peuvent-ils partager une configuration de connecteur ?
Chaque utilisateur final s'authentifie individuellement avec sa propre identité. L'URL du connecteur est par locataire ; la connexion elle-même est par utilisateur. Chaque utilisateur ne voit que ce que son propre rôle Vertice permet.
Le connecteur fonctionne-t-il hors ligne ou dans des environnements isolés ?
Non. Le connecteur est un service hébergé. Il nécessite une connectivité HTTPS entrante depuis l'infrastructure du fournisseur de l'assistant IA. Il n'existe pas d'option sur site ou auto-hébergée.
Où puis-je signaler un bug ou demander un nouvel outil ? Les rapports de bugs et les demandes de fonctionnalités sont acheminés via l'équipe de support Vertice. Les problèmes de sécurité doivent être signalés directement à [email protected].