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/mcpPar 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
- Ouvrez ChatGPT. Votre plan doit prendre en charge les connecteurs MCP personnalisés.
- Allez dans Paramètres → Applications connectées, ou utilisez le menu "Connecter".
- Sélectionnez Ajouter un serveur MCP.
- Entrez
https://api.getprimo.com/mcp. - Connectez-vous avec votre compte IT Factorial lorsque la page OAuth s'ouvre.
- 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
- Ouvrez l'application Claude Desktop.
- Allez dans Paramètres → Développeur → Serveurs MCP.
- Cliquez sur Ajouter un serveur.
- Donnez-lui un nom (par exemple "Factorial IT") et entrez
https://api.getprimo.com/mcp. - Complétez la connexion OAuth avec votre compte IT Factorial.
- Enregistrez et reconnectez. Les outils IT Factorial apparaissent maintenant dans la boîte à outils de Claude.
Comment utiliser : Cursor
- Ouvrez les paramètres de Cursor.
- Allez dans Serveurs MCP.
- Ajoutez un serveur avec l'URL
https://api.getprimo.com/mcp. - 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_IDLes paramètres peuvent être combinés :
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=falsePour 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=falseseulement 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
-
Ai-je besoin d'une clé API ?
Non. Vous vous connectez avec votre compte IT Factorial via OAuth.
-
L'assistant peut-il apporter des modifications immédiatement ?
Non. Il commence en mode lecture seule. L'accès en écriture nécessite l'URLreadOnly=false.
-
L'assistant verra-t-il tout dans la console ?
Non. Il ne voit que les outils que votre rôle permet.
-
Où puis-je trouver mon ID de locataire ?
Listez vos entreprises via l'API, ou vérifiez l'URL dans la console.
-
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.