Voltar

Conecta un asistente de IA al servidor Primo MCP

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/mcp

De 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

  1. Abre ChatGPT. Tu plan debe soportar conectores MCP personalizados.
  2. Ve a Configuración → Aplicaciones conectadas, o utiliza el menú "Conectar".
  3. Selecciona Añadir servidor MCP.
  4. Ingresa https://api.getprimo.com/mcp.
  5. Inicia sesión con tu cuenta de IT de Factorial cuando se abra la página de OAuth.
  6. 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

  1. Abre la aplicación Claude Desktop.
  2. Ve a Configuración → Desarrollador → Servidores MCP.
  3. Haz clic en Añadir servidor.
  4. Dale un nombre (por ejemplo "Factorial IT") e ingresa https://api.getprimo.com/mcp.
  5. Completa el inicio de sesión de OAuth con tu cuenta de IT de Factorial.
  6. Guarda y reconéctate. Las herramientas de IT de Factorial ahora aparecen en la caja de herramientas de Claude.

 

Cómo usar: Cursor

  1. Abre la configuración de Cursor.
  2. Ve a Servidores MCP.
  3. Añade un servidor con la URL https://api.getprimo.com/mcp.
  4. 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_ID

Los parámetros pueden combinarse:

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

Para 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=false solo 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-id a 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-id a la URL.
  • El asistente no puede cambiar nada. La conexión es solo lectura por defecto. Reconéctate con readOnly=false.

 

FAQ

  1. ¿Necesito una clave API?
    No. Inicias sesión con tu cuenta de IT de Factorial a través de OAuth.
     
  2. ¿Puede el asistente hacer cambios de inmediato?
    No. Comienza en modo solo lectura. El acceso de escritura necesita la URL readOnly=false.
     
  3. ¿Verá el asistente todo en la consola?
    No. Solo ve las herramientas que tu rol permite.
     
  4. ¿Dónde encuentro mi ID de inquilino?
    Lista tus empresas a través de la API, o verifica la URL en la consola.
     
  5. ¿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.

¿Te fue útil este artículo?

Give feedback about this article

¿No encuentras lo que estás buscando?

Nuestro equipo de servicio al cliente está aquí para ti.

Contáctanos

Knowledge Base Software powered by Helpjuice