Retour

Connecter un assistant IA au serveur Primo MCP

Le serveur Primo MCP permet aux assistants IA tels que ChatGPT, Claude ou Cursor de travailler avec vos données IT Factorial. Utilisez-le lorsque vous souhaitez poser des questions ou gérer vos appareils, employés et tickets en langage simple avec l'assistant que vous utilisez déjà.


 

Fonctionnalité

Aperçu

MCP (Modèle de Contexte de Protocole) est une norme ouverte. Elle permet à un assistant IA de se connecter directement à des outils et données externes, y compris les données IT Factorial.

Une fois connecté, votre assistant peut lire et agir sur votre parc informatique lorsque vous lui demandez : lister des appareils, trouver des employés, gérer des accessoires, ouvrir des tickets, et plus encore.

Ce dont vous avez besoin :

  • Un compte IT Factorial avec accès à l'espace de travail de votre entreprise.
  • Un assistant IA qui prend en charge MCP, comme ChatGPT, Claude ou Cursor.

La connexion utilise OAuth. Lorsque vous ajoutez le serveur, l'assistant vous demande de vous connecter avec votre compte IT Factorial. Aucun clé API n'est nécessaire.

 

URL du serveur

Le serveur se trouve à :

https://api.getprimo.com/mcp

Par défaut, la connexion est en lecture seule : l'assistant peut consulter les données mais ne peut pas les modifier.

Pour un accès en écriture (ouverture de tickets, mise à jour d'accessoires, etc.), utilisez plutôt cette URL :

https://api.getprimo.com/mcp?readOnly=false

 

Comment utiliser : ChatGPT

  1. Ouvrez ChatGPT. Votre plan doit prendre en charge les connecteurs MCP personnalisés.
  2. Allez dans Paramètres → Applications connectées, ou utilisez le menu "Connecter".
  3. Sélectionnez Ajouter un serveur MCP.
  4. Entrez https://api.getprimo.com/mcp.
  5. Connectez-vous avec votre compte IT Factorial lorsque la page OAuth s'ouvre.
  6. Autorisez la connexion.

Invitations à essayer :

  • "Lister tous les appareils gérés dans Factorial IT"
  • "Montrez-moi les employés qui ont rejoint ce mois-ci"
  • "Quels tickets sont actuellement en attente ?"

 

Comment utiliser : Claude Desktop

  1. Ouvrez l'application Claude Desktop.
  2. Allez dans Paramètres → Développeur → Serveurs MCP.
  3. Cliquez sur Ajouter un serveur.
  4. Donnez-lui un nom (par exemple "Factorial IT") et entrez https://api.getprimo.com/mcp.
  5. Complétez la connexion OAuth avec votre compte IT Factorial.
  6. Enregistrez et reconnectez. Les outils IT Factorial apparaissent maintenant dans la boîte à outils de Claude.

 

Comment utiliser : Cursor

  1. Ouvrez les paramètres de Cursor.
  2. Allez dans Serveurs MCP.
  3. Ajoutez un serveur avec l'URL https://api.getprimo.com/mcp.
  4. Complétez la connexion OAuth avec votre compte IT Factorial. L'assistant de Cursor pourra alors utiliser les outils IT Factorial.

 

Comment utiliser : autres assistants

Toute application qui suit la norme MCP peut se connecter. Dirigez-la vers https://api.getprimo.com/mcp et connectez-vous avec votre compte IT Factorial via OAuth.

 

Plusieurs entreprises sur un seul compte

Si votre compte peut accéder à plus d'un locataire, le serveur utilise l'entreprise choisie dans Entreprise MCP par défaut. Vous la trouverez dans l'onglet Entreprises de Mon compte, qui n'apparaît que lorsque vous appartenez à deux entreprises ou plus.

Lorsque aucun défaut n'est défini, ajoutez le paramètre x-company-id à l'URL :

https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID

Les paramètres peuvent être combinés :

https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=false

Pour obtenir votre ID de locataire, listez vos entreprises via l'API ou regardez l'URL dans la console.

 

Ce que l'assistant peut faire

L'assistant ne voit que les outils que votre rôle permet. Il est limité aux opérations de lecture jusqu'à ce que vous vous connectiez avec readOnly=false.

Catégorie Opérations de lecture Opérations d'écriture
Accessoires Lister et visualiser les accessoires et leurs champs personnalisés Créer, mettre à jour, attribuer et archiver des accessoires ; définir des valeurs de champs personnalisés
Administrateurs Lister les administrateurs de l'entreprise Envoyer des e-mails aux administrateurs de l'entreprise
Agents IA Lister les agents et leurs exécutions ; lire le rapport et la transcription d'une exécution Créer un agent personnalisé ; remplacer les instructions d'un agent
Tableaux de bord IA Voir un tableau de bord et ses instructions Recomposer un tableau de bord ; remplacer ses instructions
Outils IA Voir les outils IA trouvés sur les appareils, les résultats des risques et les paramètres des outils IA Approuver ou bloquer des outils IA ; mettre à jour les paramètres
Utilisation IA Voir l'utilisation des crédits IA de l'entreprise —
Profils de facturation Lister les profils de facturation —
Catalogue Rechercher dans le catalogue et visualiser des produits, favoris, pays d'expédition et adresses d'entreprise ; voir les politiques d'équipement et d'achat Épingler et désépingler des favoris ; mettre à jour et publier les politiques d'équipement et d'achat
Entreprise Voir l'entreprise et son rapport de métriques —
Conformité Lister et rechercher des alertes de conformité avec leur contexte de remédiation ; voir les règles d'alerte, les paramètres et la politique de remédiation Créer et mettre à jour des règles d'alerte ; mettre à jour les paramètres ; mettre à jour, publier et retirer la politique de remédiation
Champs personnalisés Lister et visualiser des champs personnalisés Créer, mettre à jour et archiver des champs personnalisés
Groupes d'appareils Lister et visualiser des groupes d'appareils et ce qui les utilise ; vérifier une cible avant de créer un groupe Créer, mettre à jour et supprimer des groupes d'appareils
Appareils Rechercher, compter et visualiser des appareils avec leurs activités, commandes MDM, comptes locaux et champs personnalisés ; exporter des appareils et de l'inventaire au format CSV Créer, mettre à jour et supprimer des appareils ; verrouiller, déverrouiller, effacer (⚠️), redémarrer, retirer et désinscrire ; déplacer vers le stock ou en cours d'utilisation ; exécuter un script ; renvoyer un profil ; définir des étiquettes et des valeurs de champs personnalisés
Employés Lister, rechercher et visualiser des employés et leurs champs personnalisés Créer, mettre à jour, cacher et révéler des employés ; envoyer une demande d'inscription ; définir des valeurs de champs personnalisés
Base de connaissances Lister et visualiser des éléments de la base de connaissances Créer, mettre à jour, publier, retirer et supprimer des éléments
Contrôles MDM Lister, visualiser et parcourir le catalogue de types ; lister les contrôles qui s'appliquent à un appareil Créer, mettre à jour, supprimer et mettre à jour des étiquettes
Offboarding Lister et visualiser les démissions —
Onboarding Lister et visualiser les intégrations et les paramètres d'intégration Créer, compléter et ignorer des intégrations ; exécuter les étapes d'employé, de compte e-mail, d'équipement et de SaaS ; mettre à jour les paramètres
Commandes Lister et visualiser des commandes et leurs champs personnalisés Créer des commandes et des commandes d'équipement ; définir des valeurs de champs personnalisés
SaaS Lister et visualiser des SaaS, leurs problèmes et les identités de chaque employé ; prévisualiser ce que les règles accordent Provisionner, déprovisionner, créer, lier, archiver et supprimer des identités ; réinitialiser un mot de passe ; gérer des groupes, rôles, licences et unités organisationnelles ; mettre à jour des contrats, propriétaires, statut d'approbation et règles
Scripts Lister les scripts sauvegardés et leurs exécutions, avec le résultat sur chaque appareil Exécuter un script sur une cible
Expéditions Lister et visualiser des expéditions Créer une expédition
Logiciels Voir le catalogue de logiciels, les logiciels sur un appareil, l'état d'installation et les journaux, et les vulnérabilités CVE Installer, désinstaller, mettre à jour et supprimer des logiciels ; mettre à jour les scripts d'installation ; synchroniser le catalogue ou un appareil
Tâches Lister des tâches Créer et programmer des tâches ; mettre à jour leur statut et leur assignation
Tickets Lister, compter et visualiser des tickets avec leurs abonnés ; lister les étiquettes de tickets Créer et supprimer des tickets ; ajouter des commentaires ; mettre à jour le statut, la priorité, l'assigné et l'agent IA ; gérer les abonnés, objets liés et étiquettes de tickets

Attention avec le mode écriture. Certaines actions ne peuvent pas être annulées : effacer un appareil, supprimer définitivement une identité SaaS avec son historique, ou supprimer un ticket avec ses tâches. Si vous souhaitez conserver l'historique d'un ticket, demandez à l'assistant de le fermer plutôt que de le supprimer.


 

Conseils et Meilleures Pratiques

  • Commencez en lecture seule. Ajoutez readOnly=false seulement lorsque vous avez réellement besoin que l'assistant modifie des choses.
  • Fermez les tickets au lieu de les supprimer. Supprimer retire le ticket et ses tâches pour de bon.
  • Vérifiez avant un effacement. L'assistant peut effacer des appareils en mode écriture, et un effacement ne peut pas être annulé.
  • Définissez une entreprise par défaut si vous en gérez plusieurs. Cela évite d'ajouter x-company-id à chaque URL et évite des réponses du mauvais locataire.
  • Donnez le bon rôle. L'assistant ne reçoit que les outils que votre rôle permet, donc l'accès est limité par les mêmes règles que la console.

 

Dépannage et FAQ

Dépannage

  • L'URL affiche "404 Not Found" dans un navigateur. C'est attendu. Le serveur n'est pas une page web ; c'est un point de terminaison pour les assistants IA. Ajoutez-le comme un serveur MCP dans votre assistant à la place.
  • L'authentification échoue. Terminez la connexion OAuth lorsque l'assistant le demande. Votre compte IT Factorial doit être actif et avoir accès à l'entreprise que vous souhaitez interroger.
  • L'assistant affiche des données de la mauvaise entreprise. Définissez Entreprise MCP par défaut dans l'onglet Entreprises de Mon compte, ou ajoutez le paramètre x-company-id à l'URL.
  • L'assistant ne peut rien changer. La connexion est en lecture seule par défaut. Reconnectez-vous avec readOnly=false.

 

FAQ

  1. Ai-je besoin d'une clé API ?
    Non. Vous vous connectez avec votre compte IT Factorial via OAuth.
     
  2. L'assistant peut-il apporter des modifications immédiatement ?
    Non. Il commence en mode lecture seule. L'accès en écriture nécessite l'URL readOnly=false.
     
  3. L'assistant verra-t-il tout dans la console ?
    Non. Il ne voit que les outils que votre rôle permet.
     
  4. Où puis-je trouver mon ID de locataire ?
    Listez vos entreprises via l'API, ou vérifiez l'URL dans la console.
     
  5. Qui dois-je contacter pour obtenir de l'aide avec la configuration ?
    Contactez le support IT Factorial ou utilisez le chat intégré à l'application. La documentation de l'API est disponible sur api.getprimo.com/apidoc.

Cet article vous a-t-il aidé ?

Give feedback about this article

Vous ne trouvez pas ce que vous cherchez ?

Notre équipe de service client est là pour vous.

Nous contacter

Knowledge Base Software powered by Helpjuice