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/mcpDe 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
- Obre ChatGPT. El teu pla ha de suportar connectors MCP personalitzats.
- Ves a Configuració → Aplicacions connectades, o utilitza el menú "Connectar".
- Selecciona Afegeix servidor MCP.
- Introdueix
https://api.getprimo.com/mcp. - Inicia sessió amb el teu compte de Factorial IT quan s'obri la pàgina d'OAuth.
- 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
- Obre l'aplicació Claude Desktop.
- Ves a Configuració → Desenvolupador → Servidors MCP.
- Fes clic a Afegeix servidor.
- Dona-li un nom (per exemple "Factorial IT") i introdueix
https://api.getprimo.com/mcp. - Completa el registre OAuth amb el teu compte de Factorial IT.
- Factorial IT ara apareixen a la caixa d'eines de Claude.
Com utilitzar: Cursor
- Obre la configuració de Cursor.
- Ves a Servidors MCP.
- Afegeix un servidor amb l'URL
https://api.getprimo.com/mcp. - 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_IDEs poden combinar paràmetres:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=falsePer 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=falsenomé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-ida 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-ida l'URL. -
L'assistent no pot canviar res. La connexió és només lectura per defecte. Torna a connectar-te amb
readOnly=false.
FAQ
-
Necessito una clau API?
No. Inicies sessió amb el teu compte de Factorial IT a través d'OAuth.
-
Podeu fer canvis immediatament?
No. Comença en mode només lectura. L'accés d'escriptura necessita l'URLreadOnly=false.
-
L'assistent veurà tot a la consola?
No. Només veu les eines que el teu rol permet.
-
On trobo el meu ID de llogater?
Llista les teves empreses a través de l'API, o comprova l'URL a la consola.
-
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.