Back

Connecta un assistent d'IA al servidor Primo MCP

El servidor Primo MCP permet als assistents d'IA com ChatGPT, Claude o Cursor treballar amb les teves dades IT de Factorial. Utilitza'l quan vulguis preguntar o gestionar els teus dispositius, empleats i tiquets en un llenguatge senzill des de l'assistent que ja utilitzes.


 

Funcionalitat

Visió general

MCP (Model Context Protocol) és un estàndard obert. Permet que un assistent d'IA s'integri directament amb eines i dades externes, incloent Factorial IT.

Un cop connectat, el teu assistent pot llegir i actuar sobre el teu patrimoni IT quan li demanis: llistar dispositius, trobar empleats, gestionar accessoris, obrir tiquets i més.

El que necessites:

  • Un compte de Factorial IT amb accés a l'espai de treball de la teva empresa.
  • Un assistent d'IA que suporti MCP, com ChatGPT, Claude o Cursor.

El registre s'efectua mitjançant OAuth. Quan afegeixes el servidor, l'assistent t'envia a iniciar sessió amb el teu compte de Factorial IT. No es necessita cap clau API.

 

URL del servidor

El servidor es troba a:

https://api.getprimo.com/mcp

De manera predeterminada, la connexió és només lectura: l'assistent pot veure dades però no pot modificar-les.

Per a accés d'escriptura (obrir tiquets, actualitzar accessoris, etc.), utilitza aquesta URL en el seu lloc:

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

 

Com utilitzar: ChatGPT

  1. Obre ChatGPT. El teu pla ha de suportar connectors MCP personalitzats.
  2. Ves a Configuració → Aplicacions connectades, o utilitza el menú "Connectar".
  3. Selecciona Afegeix servidor MCP.
  4. Introdueix https://api.getprimo.com/mcp.
  5. Inicia sessió amb el teu compte de Factorial IT quan s'obri la pàgina d'OAuth.
  6. Autoritza la connexió.

Propostes per provar:

  • "Llista tots els dispositius gestionats a Factorial IT"
  • "Mostra'm els empleats que s'han unit aquest mes"
  • "Quins tiquets estan actualment pendents?"

 

Com utilitzar: Claude Desktop

  1. Obre l'aplicació Claude Desktop.
  2. Ves a Configuració → Desenvolupador → Servidors MCP.
  3. Fes clic a Afegeix servidor.
  4. Dona-li un nom (per exemple "Factorial IT") i introdueix https://api.getprimo.com/mcp.
  5. Completa el registre OAuth amb el teu compte de Factorial IT.
  6. Factorial IT ara apareixen a la caixa d'eines de Claude.

 

Com utilitzar: Cursor

  1. Obre la configuració de Cursor.
  2. Ves a Servidors MCP.
  3. Afegeix un servidor amb l'URL https://api.getprimo.com/mcp.
  4. Completa el registre OAuth amb el teu compte de Factorial IT. L'assistent de Cursor pot llavors utilitzar les eines de Factorial IT.

 

Com utilitzar: altres assistents

Qualsevol aplicació que segueixi l'estàndard MCP pot connectar-se. Apunta a https://api.getprimo.com/mcp i inicia sessió amb el teu compte de Factorial IT a través d'OAuth.

 

Vàries empreses en un compte

Si el teu compte pot accedir a més d'un llogater, el servidor utilitza l'empresa escollida a Empresa MCP per defecte. La trobaràs a la pestanya Empreses de El meu compte, que només apareix quan pertanys a dues o més empreses.

Quan no hi ha cap predeterminat, afegeix el paràmetre x-company-id a l'URL:

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

Es poden combinar paràmetres:

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

Per obtenir el teu ID de llogater, llista les teves empreses a través de l'API o mira l'URL a la consola.

 

El que pot fer l'assistent

L'assistent només veu les eines que el teu rol permet. Està limitat a operacions de lectura fins que et connectis amb readOnly=false.

Categoria Operacions de lectura Operacions d'escriptura
Accessoris Llistar i veure accessoris i els seus camps personalitzats Crear, actualitzar, assignar i arxivar accessoris; establir valors de camps personalitzats
Administradors Llistar els administradors de l'empresa Enviar correus electrònics als administradors de l'empresa
Agents d'IA Llistar agents i les seves execucions; llegir el informe i la transcripció d'una execució Crear un agent personalitzat; reemplaçar les instruccions d'un agent
Taulers d'IA Veure un tauler i les seves instruccions Recompondre un tauler; reemplaçar les seves instruccions
Eines d'IA Veure les eines d'IA trobades en dispositius, les troballes de risc i la configuració de les eines d'IA Autoritzar o bloquejar eines d'IA; actualitzar la configuració
Ús d'IA Veure l'ús de crèdits d'IA de l'empresa —
Perfils de facturació Llistar perfils de facturació —
Catàleg Cercar al catàleg i veure productes, favorits, països d'enviament i adreces de l'empresa; veure les polítiques d'equipament i adquisició Fixar i desfixar favorits; actualitzar i publicar les polítiques d'equipament i adquisició
Empresa Veure l'empresa i el seu informe de mètriques —
Compliment Llistar i cercar alertes de compliment amb el seu context de remediació; veure les regles d'alerta, configuracions i la política de remediació Crear i actualitzar regles d'alerta; actualitzar la configuració; actualitzar, publicar i despublicar la política de remediació
Camps personalitzats Llistar i veure camps personalitzats Crear, actualitzar i arxivar camps personalitzats
Grups de dispositius Llistar i veure grups de dispositius i què els utilitza; comprovar un objectiu abans de crear un grup Crear, actualitzar i eliminar grups de dispositius
Dispositius Cercar, comptar i veure dispositius amb les seves activitats, ordres MDM, comptes locals i camps personalitzats; exportar dispositius i inventari com a CSV Crear, actualitzar i eliminar dispositius; bloquejar, desbloquejar, esborrar (⚠️), reiniciar, retirar i desinscriure; moure a estoc o en ús; executar un script; reenviar un perfil; establir etiquetes i valors de camps personalitzats
Empleats Llistar, cercar i veure empleats i els seus camps personalitzats Crear, actualitzar, ocultar i desocultar empleats; enviar una sol·licitud d'inscripció; establir valors de camps personalitzats
Base de coneixements Llistar i veure elements de la base de coneixements Crear, actualitzar, publicar, despublicar i eliminar elements
Controls MDM Llistar, veure i navegar pel catàleg de tipus; llistar els controls que s'apliquen a un dispositiu Crear, actualitzar, eliminar i actualitzar etiquetes
Offboardings Llistar i veure processos de desvinculació —
Onboardings Llistar i veure processos d'incorporació i les configuracions d'incorporació Crear, completar i ignorar processos d'incorporació; executar els passos d'empleat, compte de correu electrònic, equipament i SaaS; actualitzar la configuració
Comandes Llistar i veure comandes i els seus camps personalitzats Crear comandes i comandes d'equipament; establir valors de camps personalitzats
SaaS Llistar i veure SaaS, els seus problemes i les identitats de cada empleat; previsualitzar el que atorguen les regles Provisionar, desprovisionar, crear, vincular, arxivar i eliminar identitats; restablir una contrasenya; gestionar grups, rols, llicències i unitats d'organització; actualitzar contractes, propietaris, estat d'aprovació i regles
Scripts Llistar scripts desats i les seves execucions, amb el resultat en cada dispositiu Executar un script en un objectiu
Enviaments Llistar i veure enviaments Crear un enviament
Programari Veure el catàleg de programari, el programari en un dispositiu, l'estat d'instal·lació i els registres, i vulnerabilitats CVE Instal·lar, desinstal·lar, actualitzar i eliminar programari; actualitzar scripts d'instal·lació; sincronitzar el catàleg o un dispositiu
Tasques Llistar tasques Crear i programar tasques; actualitzar el seu estat i assignat
Tiquests Llistar, comptar i veure tiquets amb els seus subscriptors; llistar etiquetes de tiquets Crear i eliminar tiquets; afegir comentaris; actualitzar estat, prioritat, assignat i agent d'IA; gestionar subscriptors, objectes vinculats i etiquetes de tiquets

Vigila amb el mode d'escriptura. Algunes accions no es poden desfer: esborrar un dispositiu, eliminar permanentment una identitat SaaS amb la seva història, o eliminar un tiquet juntament amb les seves tasques. Si vols conservar l'historial d'un tiquet, demana a l'assistent que el tanqui en comptes d'eliminar-lo.


 

Consells i millors pràctiques

  • Comença en només lectura. Afegeix readOnly=false només quan realment necessitis que l'assistent canviï coses.
  • Tanca tiquets en comptes d'eliminar-los. Eliminar elimina el tiquet i les seves tasques per sempre.
  • Comprova abans d'un esborrat. L'assistent pot esborrar dispositius en mode d'escriptura, i un esborrat no es pot desfer.
  • Estableix una empresa predeterminada si gestiones diverses. Això evita haver d'afegir x-company-id a cada URL i evita respostes del llogater incorrecte.
  • Dona el rol correcte. L'assistent només obté les eines que el teu rol permet, així que l'accés està limitat per les mateixes regles que la consola.

 

Resolució de problemes i FAQ

Resolució de problemes

  • L'URL mostra "404 Not Found" en un navegador. Això és d'esperar. El servidor no és una pàgina web; és un punt final per als assistents d'IA. Afegeix-ho com a servidor MCP al teu assistent en comptes d'això.
  • La autenticació falla. Completa el registre OAuth quan l'assistent ho demani. El teu compte de Factorial IT ha d'estar actiu i tenir accés a l'empresa que vols consultar.
  • L'assistent mostra dades de l'empresa equivocada. Estableix Empresa MCP per defecte a la pestanya Empreses de El meu compte, o afegeix el paràmetre x-company-id a l'URL.
  • L'assistent no pot canviar res. La connexió és només lectura per defecte. Torna a connectar-te amb readOnly=false.

 

FAQ

  1. Necessito una clau API?
    No. Inicies sessió amb el teu compte de Factorial IT a través d'OAuth.
     
  2. Podeu fer canvis immediatament?
    No. Comença en mode només lectura. L'accés d'escriptura necessita l'URL readOnly=false.
     
  3. L'assistent veurà tot a la consola?
    No. Només veu les eines que el teu rol permet.
     
  4. On trobo el meu ID de llogater?
    Llista les teves empreses a través de l'API, o comprova l'URL a la consola.
     
  5. Amb qui puc contactar per ajuda amb la configuració?
    Contacta amb el suport de Factorial IT o utilitza el xat dins de l'aplicació. La documentació de l'API és a api.getprimo.com/apidoc.

Was this article helpful?

Give feedback about this article

Can’t find what you’re looking for?

Our customer care team is here for you.

Contact us

Knowledge Base Software powered by Helpjuice