El servidor Primo MCP permite que asistentes de IA como ChatGPT, Claude o Cursor trabajen con tus datos de IT de Factorial. Úsalo cuando quieras preguntar o gestionar tus dispositivos, empleados/as y tickets en lenguaje sencillo desde el asistente que ya utilizas.
Funcionalidad
Descripción general
MCP (Modelo de Protocolo de Contexto) es un estándar abierto. Permite que un asistente de IA se conecte directamente a herramientas y datos externos, incluyendo IT de Factorial.
Una vez conectado, tu asistente puede leer y actuar sobre tu infraestructura de IT cuando se lo pidas: listar dispositivos, encontrar empleados/as, gestionar accesorios, abrir tickets y más.
Lo que necesitas:
- Una cuenta de IT de Factorial con acceso al espacio de trabajo de tu empresa.
- Un asistente de IA que soporte MCP, como ChatGPT, Claude o Cursor.
El inicio de sesión utiliza OAuth. Cuando añades el servidor, el asistente te envía a iniciar sesión con tu cuenta de IT de Factorial. No se necesita clave API.
URL del servidor
El servidor se encuentra en:
https://api.getprimo.com/mcpPor defecto, la conexión es solo lectura: el asistente puede ver los datos pero no puede cambiarlos.
Para acceso de escritura (abrir tickets, actualizar accesorios, etc.), usa esta URL en su lugar:
https://api.getprimo.com/mcp?readOnly=false
Cómo usar: ChatGPT
- Abre ChatGPT. Tu plan debe soportar conectores MCP personalizados.
- Ve a Ajustes → Aplicaciones Conectadas, o usa el menú "Conectar".
- Selecciona Añadir servidor MCP.
- Ingresa
https://api.getprimo.com/mcp. - Inicia sesión con tu cuenta de IT de Factorial cuando se abra la página de OAuth.
- Autoriza la conexión.
Prompts para probar:
- "Lista todos los dispositivos gestionados en Factorial IT"
- "Muéstrame los empleados/as que se unieron este mes"
- "¿Qué tickets están actualmente pendientes?"
Cómo usar: Claude Desktop
- Abre la aplicación Claude Desktop.
- Ve a Ajustes → Desarrollador → Servidores MCP.
- Haz clic en Añadir servidor.
- Dale un nombre (por ejemplo "Factorial IT") e ingresa
https://api.getprimo.com/mcp. - Completa el inicio de sesión de OAuth con tu cuenta de IT de Factorial.
- Guarda y reconéctate. Las herramientas de IT de Factorial ahora aparecerán en la caja de herramientas de Claude.
Cómo usar: Cursor
- Abre la configuración de Cursor.
- Ve a Servidores MCP.
- Añade un servidor con la URL
https://api.getprimo.com/mcp. - Completa el inicio de sesión de OAuth con tu cuenta de IT de Factorial. El asistente de Cursor podrá entonces usar las herramientas de IT de Factorial.
Cómo usar: otros asistentes
Cualquier aplicación que siga el estándar MCP puede conectarse. Dirígela a https://api.getprimo.com/mcp e inicia sesión con tu cuenta de IT de Factorial a través de OAuth.
Varias empresas en una cuenta
Si tu cuenta puede acceder a más de un inquilino, el servidor utiliza la empresa elegida en Empresa MCP predeterminada. La encuentras en la pestaña Empresas de Mi cuenta, que solo aparece cuando perteneces a dos o más empresas.
Cuando no se establece un predeterminado, añade el parámetro x-company-id a la URL:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_IDLos parámetros se pueden combinar:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=falsePara obtener tu ID de inquilino, lista tus empresas a través de la API o mira la URL en la consola.
Lo que el asistente puede hacer
El asistente solo ve las herramientas que tu rol permite. Está limitado a operaciones de lectura hasta que te conectes con readOnly=false.
| Categoría | Operaciones de lectura | Operaciones de escritura |
|---|---|---|
| Accesorios | Listar y ver accesorios y sus campos personalizados | Crear, actualizar, asignar y archivar accesorios; establecer valores de campos personalizados |
| Administradores/as | Listar los administradores/as de la empresa | Enviar correos a los administradores/as de la empresa |
| Agentes de IA | Listar agentes y sus ejecuciones; leer el informe y la transcripción de una ejecución | Crear un agente personalizado; reemplazar las instrucciones de un agente |
| Paneles de IA | Ver un panel y sus instrucciones | Recomponer un panel; reemplazar sus instrucciones |
| Herramientas de IA | Ver las herramientas de IA encontradas en dispositivos, los hallazgos de riesgo y la configuración de las herramientas de IA | Aprobar o bloquear herramientas de IA; actualizar la configuración |
| Uso de IA | Ver el uso de créditos de IA de la empresa | — |
| Perfiles de facturación | Listar perfiles de facturación | — |
| Catálogo | Buscar en el catálogo y ver productos, favoritos, países de envío y direcciones de la empresa; ver los equipos y políticas de compra | Fijar y deshacer favoritos; actualizar y publicar los equipos y políticas de compra |
| Empresa | Ver la empresa y su informe de métricas | — |
| Cumplimiento | Listar y buscar alertas de cumplimiento con su contexto de remediación; ver reglas de alertas, configuraciones y la política de remediación | Crear y actualizar reglas de alertas; actualizar la configuración; actualizar, publicar y despublicar la política de remediación |
| Campos personalizados | Listar y ver campos personalizados | Crear, actualizar y archivar campos personalizados |
| Grupos de dispositivos | Listar y ver grupos de dispositivos y qué los utiliza; verificar un objetivo antes de crear un grupo | Crear, actualizar y eliminar grupos de dispositivos |
| Dispositivos | Buscar, contar y ver dispositivos con sus actividades, comandos MDM, cuentas locales y campos personalizados; exportar dispositivos e inventario como CSV | Crear, actualizar y eliminar dispositivos; bloquear, desbloquear, borrar (⚠️), reiniciar, retirar y desinscribir; mover a stock o en uso; ejecutar un script; reenviar un perfil; establecer etiquetas y valores de campos personalizados |
| Empleados/as | Listar, buscar y ver empleados/as y sus campos personalizados | Crear, actualizar, ocultar y mostrar empleados/as; enviar una solicitud de inscripción; establecer valores de campos personalizados |
| Base de conocimiento | Listar y ver artículos de la base de conocimiento | Crear, actualizar, publicar, despublicar y eliminar artículos |
| Controles MDM | Listar, ver y explorar el catálogo de tipos; listar los controles que se aplican a un dispositivo | Crear, actualizar, eliminar y actualizar etiquetas |
| Offboardings | Listar y ver desvinculaciones | — |
| Onboardings | Listar y ver vinculaciones y la configuración de vinculación | Crear, completar e ignorar vinculaciones; ejecutar los pasos de empleado/a, cuenta de correo, equipo y SaaS; actualizar la configuración |
| Órdenes | Listar y ver órdenes y sus campos personalizados | Crear órdenes y órdenes de equipo; establecer valores de campos personalizados |
| SaaS | Listar y ver SaaS, sus problemas y las identidades de cada empleado/a; previsualizar lo que otorgan las reglas | Provisionar, desprovisionar, crear, vincular, archivar y eliminar identidades; restablecer una contraseña; gestionar grupos, roles, licencias y unidades organizativas; actualizar contratos, propietarios/as, estado de aprobación y reglas |
| Scripts | Listar scripts guardados y sus ejecuciones, con el resultado en cada dispositivo | Ejecutar un script en un objetivo |
| Envíos | Listar y ver envíos | Crear un envío |
| Software | Ver el catálogo de software, el software en un dispositivo, el estado de instalación y los registros, y vulnerabilidades CVE | Instalar, desinstalar, actualizar y eliminar software; actualizar scripts de instalación; sincronizar el catálogo o un dispositivo |
| Tareas | Listar tareas | Crear y programar tareas; actualizar su estado y asignado/a |
| Tickets | Listar, contar y ver tickets con sus suscriptores/as; listar etiquetas de tickets | Crear y eliminar tickets; añadir comentarios; actualizar estado, prioridad, asignado/a y agente de IA; gestionar suscriptores/as, objetos vinculados y etiquetas de tickets |
Ten cuidado con el modo de escritura. Algunas acciones no pueden ser revertidas: borrar un dispositivo, eliminar permanentemente una identidad de SaaS con su historial, o eliminar un ticket junto con sus tareas. Si quieres conservar el historial de un ticket, pide al asistente que lo cierre en lugar de eliminarlo.
Consejos y Mejores Prácticas
-
Comienza en solo lectura. Añade
readOnly=falsesolo cuando realmente necesites que el asistente cambie cosas. - Cierra tickets en lugar de eliminarlos. Eliminar quita el ticket y sus tareas para siempre.
- Verifica antes de un borrado. El asistente puede borrar dispositivos en modo de escritura, y un borrado no se puede deshacer.
-
Establece una empresa predeterminada si gestionas varias. Ahorra añadir
x-company-ida cada URL y evita respuestas del inquilino incorrecto. - Otorga el rol correcto. El asistente solo obtiene las herramientas que tu rol permite, por lo que el acceso está limitado por las mismas reglas que la consola.
Solución de Problemas y FAQ
Solución de Problemas
- La URL muestra "404 Not Found" en un navegador. Eso es esperado. El servidor no es una página web; es un endpoint para asistentes de IA. Agrégalo como un servidor MCP en tu asistente en su lugar.
- La autenticación falla. Completa el inicio de sesión de OAuth cuando el asistente lo pida. Tu cuenta de IT de Factorial debe estar activa y tener acceso a la empresa que deseas consultar.
-
El asistente muestra datos de la empresa incorrecta. Establece Empresa MCP predeterminada en la pestaña Empresas de Mi cuenta, o añade el parámetro
x-company-ida la URL. -
El asistente no puede cambiar nada. La conexión es solo lectura por defecto. Reconéctate con
readOnly=false.
FAQ
-
¿Necesito una clave API?
No. Inicias sesión con tu cuenta de IT de Factorial a través de OAuth.
-
¿Puede el asistente hacer cambios de inmediato?
No. Comienza en modo solo lectura. El acceso de escritura necesita la URLreadOnly=false.
-
¿El asistente verá todo en la consola?
No. Solo ve las herramientas que tu rol permite.
-
¿Dónde encuentro mi ID de inquilino?
Lista tus empresas a través de la API, o verifica la URL en la consola.
-
¿A quién contacto para obtener ayuda con la configuración?
Contacta al soporte de IT de Factorial o usa el chat dentro de la aplicación. La documentación de la API está en api.getprimo.com/apidoc.