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 sobre o gestionar tus dispositivos, empleados/as y tickets en lenguaje sencillo desde el asistente que ya utilizas.
Funcionalidad
Descripción general
MCP (Protocolo de Contexto del Modelo) es un estándar abierto. Permite que un asistente de IA se conecte directamente a herramientas y datos externos, incluidos los de 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/mcpDe forma predeterminada, 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.), utiliza 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 Configuración → Aplicaciones conectadas, o utiliza 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 Configuración → 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 aparecen 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ígete 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 hay un predeterminado establecido, añade el parámetro x-company-id a la URL:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_IDLos parámetros pueden combinarse:
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 |
| Tableros de IA | Ver un tablero y sus instrucciones | Recomponer un tablero; reemplazar sus instrucciones |
| Herramientas de IA | Ver las herramientas de IA encontradas en dispositivos, los hallazgos de riesgos 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 las políticas de equipo y compras | Fijar y desanclar favoritos; actualizar y publicar las políticas de equipo y compras |
| 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 alerta, configuraciones y la política de remediación | Crear y actualizar reglas de alerta; 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 usa; 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 de 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 conocimientos | Listar y ver elementos de la base de conocimientos | Crear, actualizar, publicar, despublicar y eliminar elementos |
| Controles de MDM | Listar, ver y navegar por el catálogo de tipos; listar los controles que se aplican a un dispositivo | Crear, actualizar, eliminar y actualizar etiquetas |
| Offboardings | Listar y ver offboardings | — |
| Onboardings | Listar y ver onboardings y la configuración de onboarding | Crear, completar e ignorar onboardings; 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 las reglas otorgan | 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, estado de instalación y 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 asignación |
| 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 se pueden deshacer: borrar un dispositivo, eliminar permanentemente una identidad de SaaS con su historial, o eliminar un ticket junto con sus tareas. Si deseas mantener el historial de un ticket, pide al asistente que lo cierre en lugar de eliminarlo.
Consejos y mejores prácticas
-
Comienza en modo 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. Esto 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, así que el acceso está limitado por las mismas reglas que la consola.
Resolución de problemas y FAQ
Resolució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. Añádelo 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.
-
¿Verá el asistente 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 ayuda con la configuración?
Contacta al soporte de IT de Factorial o utiliza el chat en la aplicación. La documentación de la API está en api.getprimo.com/apidoc.