Passer au contenu principal

​
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.)
L’authentification est gérée via OAuth : lorsque vous ajoutez le serveur MCP Primo à votre assistant IA, vous serez redirigé pour vous connecter avec votre compte Primo. Aucune clé API requise.

​
URL du serveur MCP

Le serveur Primo MCP est disponible à l’adresse : 
https://api.getprimo.com/mcp
Par défaut, le serveur s’exécute en mode lecture seule : votre assistant IA peut interroger les données mais ne peut pas y apporter de modifications. Pour activer l’accès en écriture (créer des tickets, mettre à jour les accessoires, etc.), utilisez : 
https://api.getprimo.com/mcp?readOnly=false

​
Guide de configuration

​
ChatGPT

  1. Ouvrez ChatGPT (forfait Plus ou Team requis)
  2. Accédez à Paramètres → Applications connectées ou utilisez le menu « Connecter ».
  3. Sélectionnez “Ajouter un serveur MCP”
  4. Entrez l’URL du serveur : https://api.getprimo.com/mcp
  5. Vous serez redirigé vers vous connecter avec votre compte Primo (OAuth)
  6. Autorisez la connexion : vous êtes prêt !
Exemples d’invites :
  • “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 ?”

​
Claude Bureau

  1. Ouvrez l’application Claude Desktop
  2. Accédez à Paramètres → Développeur → Serveurs MCP
  3. Cliquez sur “Ajouter un serveur”
  4. Saisissez un nom (par exemple “Primo”) et l’URL : https://api.getprimo.com/mcp
  5. Complétez le flux de connexion OAuth avec votre compte Primo
  6. Enregistrer et reconnecter — Les outils Primo apparaîtront dans la boîte à outils de Claude

​
Curseur

  1. Ouvrir les paramètres du Curseur
  2. Accédez à Serveurs MCP
  3. Ajoutez un nouveau serveur avec l’URL : https://api.getprimo.com/mcp
  4. Complétez l’authentification OAuth avec votre compte Primo
  5. Les outils Primo seront disponibles dans l’assistant AI de Cursor

​
Autres clients compatibles MCP

Toute application prenant en charge la norme MCP peut se connecter à Primo. Utilisez l’URL du serveur https://api.getprimo.com/mcp — l’authentification est gérée via OAuth.

​
Prise en charge multi-entreprises

Si votre organisation gère plusieurs sociétés dans Primo, le serveur MCP est par défaut votre société principale. Pour cibler une entreprise spécifique, ajoutez le paramètre x-company-id à l’URL : 
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID
Vous pouvez combiner les paramètres : 
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=false
Pour trouver l’identifiant de votre entreprise, utilisez le 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égorieOpérations de lectureOpérations d’écriture
AccessoiresLister et afficher les accessoiresCréer et mettre à jour des accessoires
EntrepriseAfficher les détails de l’entreprise authentifiée—
AppareilsLister, rechercher et afficher les détails des appareilsCréer, verrouiller, déverrouiller, effacer (⚠️)
Groupes d’appareilsLister et afficher les groupes d’appareils—
EmployésLister et afficher les profils des employésCréer des employés
Contrôles MDMLister et afficher les contrôles MDM—
SaaSLister et afficher les applications SaaSMettre à jour les contrats SaaS
LogicielsLister et afficher les logiciels—
TicketsLister, rechercher, filtrer et afficher les ticketsCréer des tickets, ajouter des commentaires, mettre à jour statut/priorité/assigné
Les actions de l’appareil (verrouillage, effacement) sont puissantes et irréversibles. Utilisez le mode écriture avec prudence.

​
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 de la mauvaise entreprise Si vous gérez plusieurs sociétés, spécifiez la société cible à l’aide du paramètre x-company-id (voir Prise en charge multi-sociétés ci-dessus).

​
Besoin d’aide ?

Contactez votre équipe d’assistance Primo ou via le chat intégré à l’application si vous avez besoin d’aide pour configurer MCP. Pour la documentation API, visitez : api.getprimo.com/apidoc