Volver

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

Por 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

  1. Abre ChatGPT. Tu plan debe soportar conectores MCP personalizados.
  2. Ve a Ajustes → Aplicaciones Conectadas, o usa 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 Ajustes → 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 aparecerán 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í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_ID

Los parámetros se pueden combinar:

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
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=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. 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, 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-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. ¿El asistente verá 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 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.

¿Te ha sido ú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