Documentation Index
Fetch the complete documentation index at: https://docs.getprimo.com/llms.txt
Use this file to discover all available pages before exploring further.
Qu’est-ce que le MCP ?
Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants d’IA comme ChatGPT, Claude ou Cursor de se connecter directement à des outils et sources de données externes, notamment Primo. Avec le serveur MCP Primo, votre assistant IA peut interroger et gérer votre parc informatique en langage naturel : lister les appareils, rechercher des employés, gérer les accessoires, créer des tickets, etc.Conditions préalables
Pour utiliser le serveur MCP Primo, il vous suffit de :- Un compte Primo avec accès à l’espace de travail de votre entreprise
- Un assistant IA prenant en charge MCP (ChatGPT, Claude, Cursor, etc.)
URL du serveur MCP
Le serveur Primo MCP est disponible à l’adresse :Guide de configuration
- ChatGPT
- Claude Desktop
- Cursor
- Autres clients
- Ouvrez ChatGPT (forfait Plus ou Team requis)
- Accédez à Paramètres → Applications connectées ou utilisez le menu « Connecter ».
- Sélectionnez “Ajouter un serveur MCP”
- Entrez l’URL du serveur :
https://api.getprimo.com/mcp - Vous serez redirigé vers vous connecter avec votre compte Primo (OAuth)
- Autorisez la connexion : vous êtes prêt !
- “Liste de tous les appareils gérés dans Primo”
- “Montrez-moi les employés qui ont rejoint ce mois-ci”
- “Quels billets sont actuellement en attente ?”
Prise en charge multi-tenant
Si votre compte a accès à plusieurs tenants dans Primo, le serveur MCP utilise par défaut le tenant configuré dans votre paramètre Tenant MCP par défaut (dans Mon compte → Paramètres IA). Si aucun tenant par défaut n’est défini, vous pouvez en spécifier un en ajoutant le paramètrex-company-id à l’URL :
Pour trouver l’identifiant de votre tenant, utilisez l’API pour répertorier vos entreprises ou vérifiez l’URL dans votre tableau de bord Primo.
Que pouvez-vous faire ?
Une fois connecté, votre assistant IA peut effectuer les actions suivantes via Primo :| Catégorie | Opérations de lecture | Opérations d’écriture |
|---|---|---|
| Accessoires | Lister et afficher les accessoires | Créer et mettre à jour des accessoires |
| Entreprise | Afficher les détails de l’entreprise authentifiée | — |
| Appareils | Lister, rechercher et afficher les détails des appareils | Créer, mettre à jour l’assigné, verrouiller, déverrouiller, effacer (⚠️) |
| Groupes d’appareils | Lister et afficher les groupes d’appareils | — |
| Employés | Lister et afficher les profils des employés | Créer des employés |
| Contrôles MDM | Lister et afficher les contrôles MDM | — |
| SaaS | Lister et afficher les applications SaaS | Mettre à jour les contrats, provisionner et déprovisionner les identités |
| Logiciels | Lister et afficher les logiciels | — |
| Admins | Lister les admins du workspace | — |
| Tickets | Lister, rechercher, filtrer et afficher les tickets | Créer des tickets, ajouter des commentaires, mettre à jour statut/priorité/assigné |
Dépannage
“404 Not Found” lors de l’ouverture de l’URL dans un navigateur C’est normal. Le serveur MCP n’est pas une page Web : c’est un point de terminaison de protocole conçu pour être utilisé par les assistants IA. Ajoutez-le en tant que serveur MCP dans votre client préféré. Erreur d’authentification Assurez-vous de terminer le processus de connexion OAuth lorsque vous y êtes invité. Vous avez besoin d’un compte Primo actif avec accès à l’entreprise que vous souhaitez interroger. Données provenant du mauvais tenant Si vous avez accès à plusieurs tenants, définissez votre tenant par défaut dans Mon compte → Paramètres IA → Tenant MCP par défaut, ou spécifiez le tenant cible à l’aide du paramètrex-company-id (voir Prise en charge multi-tenant ci-dessus).