API y MCP de PULT (Beta): Conecta PULT con herramientas de IA y tus propios sistemas

Last updated: November 20, 2026

Con la API de PULT (beta), puedes leer los datos de PULT de tu organización en tus propias herramientas, por ejemplo, en un panel de BI, tu sistema de RR. HH. o tus propios informes. Con el servidor MCP de PULT, los asistentes de IA como Claude pueden acceder directamente a los mismos datos, para que puedas hacer preguntas como «¿Cuántas personas estuvieron en la oficina la semana pasada?». Este artículo muestra a los administradores qué datos están disponibles y cómo conectarse, ya sea iniciando sesión con tu cuenta de PULT (OAuth) o mediante una clave de API.


📌 Antes de empezar: Necesitas derechos de administrador en PULT. PULT activa la API por organización; si no ves Claves de API en Configuración → Seguridad, contáctanos en support@pult.com y la activaremos por ti.

📘 Documentación técnica: Todos los endpoints, parámetros, detalles de autenticación y límites de velocidad para desarrolladores: docs.pult.dev


Qué puedes hacer con la API y MCP

La API es de solo lectura: puedes leer datos, pero no crear ni cambiar nada en PULT. Estos datos están disponibles:

Datos

Qué obtienes

Requiere

Usuarios

Lista y usuarios individuales, filtrar por estado (activos, archivados), grupo o correo electrónico

cualquier producto de PULT

Grupos

Lista y grupos individuales

cualquier producto de PULT

Oficinas

Lista y oficinas individuales, filtrar por estado

Lugar de trabajo

Reservas

Reservas para un periodo de hasta 31 días, filtrar por tipo, oficina, grupo o hasta 50 usuarios

Lugar de trabajo

Ubicaciones de presencia

Lista y ubicaciones individuales

Presencia

Días de presencia

Por persona, día y ubicación: cómo se detectó a la persona (WiFi o agente de escritorio), además de la hora de la primera y última detección, durante un máximo de 31 días

Presencia

Recuentos de ubicaciones de presencia

Número de personas por ubicación y día, durante un máximo de 31 días

Presencia

Visitas

Lista y visitas individuales

Gestión de visitantes

La API sigue las mismas reglas de privacidad que tu panel de PULT:

  • Cada clave de API y conexión solo puede ver los datos de su propia organización.

  • Las claves y conexiones leen con los permisos de su propietario: ven lo mismo que un administrador en los informes del panel.

  • Los invitados no están incluidos.

  • Las reservas y los datos de presencia solo incluyen a personas con un puesto activo.

  • Las reservas y los datos de presencia anteriores de usuarios archivados siguen disponibles; aparecen en la lista de usuarios con el estado archivado.

  • Si tu organización oculta los datos de presencia sensibles, se omiten las horas de la primera y última detección.

  • Los datos de presencia siguen el periodo de conservación de tu organización.


1. Conectar una herramienta de IA con tu cuenta de PULT (OAuth)

Esta es la forma más sencilla: no necesitas una clave de API; inicia sesión con tu cuenta de PULT y aprueba la conexión.

  1. En tu herramienta de IA, añade PULT como conector personalizado. En Claude, por ejemplo, ve a Configuración → Conectores y añade un conector personalizado.

  2. Nombre: PULT, URL del servidor: https://api.pult.com/v1beta/mcp

  3. Si tu herramienta pregunta cómo autenticarte, elige OAuth. Si ofrece enviar el parámetro de recurso, déjalo activado.

  4. Haz clic en Conectar. PULT se abre en tu navegador; inicia sesión y aprueba la conexión.

Después de conectarse, tu herramienta de IA verá todos los datos de PULT de la tabla anterior como herramientas de solo lectura. Prueba con preguntas como:

  • «¿Qué oficinas tenemos en PULT?»

  • «¿Quién ha reservado un escritorio en nuestra oficina de Hamburgo el próximo lunes?»

  • «¿Cuántas personas estuvieron en la oficina cada día la semana pasada?»

  • «¿Quién estuvo en la oficina menos de tres días por semana este mes?»

📌 Espacios de trabajo de IA compartidos (por ejemplo, Claude Team o Enterprise, espacios de trabajo de ChatGPT): el propietario de un espacio de trabajo añade el conector de PULT una vez para todo el espacio. Después, cada persona lo conecta con su propia cuenta de PULT. Cada conexión utiliza los permisos de la persona que la realizó; nadie tiene que compartir una clave de API.

📌 ¿Qué herramientas de IA funcionan? OAuth se ha probado con Claude y ChatGPT, y también debería funcionar con Claude Code, Cursor, VS Code y Langdock. Microsoft 365 Copilot también se conecta mediante OAuth. Gemini Enterprise aún no es compatible. Las herramientas sin compatibilidad con OAuth (por ejemplo, Copilot Studio, n8n o Le Chat) se conectan con una clave de API; consulta los pasos del 2 al 4. Encontrarás la lista de cada herramienta en la documentación de MCP.


2. Abrir la página de claves de API

En el panel de PULT, ve a Configuración → Seguridad → Claves de API. Si el cuadro de Conectar está contraído, haz clic en Mostrar.

  1. Crear clave de API: Crea una clave nueva (consulta el paso 3).

  2. API REST: La URL base para tus propias integraciones: https://api.pult.com/v1beta

  3. Documento OpenAPI: La descripción técnica de todos los endpoints. Es público y no necesita clave; tus desarrolladores pueden utilizarlo para generar código de cliente.

  4. Servidor MCP: La dirección para las herramientas de IA: https://api.pult.com/v1beta/mcp

  5. Autenticación: Cómo se envía la clave: para REST y MCP, en el encabezado Authorization: Bearer <your API key>. Las claves nunca se aceptan en una URL.


3. Crear una clave de API

Haz clic en Crear clave de API.

  1. Nombre: Dale a la clave un nombre que indique dónde la usas, por ejemplo, «Claude» o «Power BI».

  2. Caduca después de: Elige 30 días, 90 días, 1 año o una fecha personalizada. Los periodos más cortos limitan los daños si se filtra una clave.

  3. Haz clic en Crear clave.

Tu nueva clave se muestra:

  1. Copiar copia solo la clave; Copiar como encabezado la copia lista para usar como Authorization: Bearer ….

  2. Haz clic en Listo.

⚠ Copia la clave inmediatamente. No podrás volver a verla. Trátala como una contraseña: cualquiera que la tenga puede leer los datos de tu organización con tus derechos de administrador, también en espacios de trabajo de IA compartidos y herramientas de flujo de trabajo.


4. Conectar una herramienta de IA con una clave de API

Utiliza esta opción si tu herramienta de IA no admite OAuth o para automatizaciones. Añade PULT como conector personalizado o servidor MCP:

  1. URL del servidor: https://api.pult.com/v1beta/mcp (HTTP transmitible)

  2. Autenticación: Envía tu clave de API en el encabezado Authorization como Bearer <your API key>. La forma más sencilla es Copiar como encabezado desde el paso 3. Algunas herramientas añaden Bearer por sí mismas; en ese caso, pega solo la clave.

⚠ Crea una clave independiente para cada herramienta, de modo que puedas revocar una sin afectar a las demás. En un espacio de trabajo de IA compartido, todos utilizan la misma clave con tus permisos de administrador; utiliza OAuth en su lugar (paso 1).


5. Utilizar la API REST

Para tus propias integraciones, envía solicitudes a la URL base con tu clave en el encabezado Authorization ; por ejemplo:

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.pult.com/v1beta/offices
  • Documentación: Todos los endpoints y parámetros se describen en docs.pult.dev/api y en el documento OpenAPI (número 3 del paso 2).

  • Paginación: Las listas se devuelven página por página mediante un cursor, con entre 1 y 500 entradas por página (100 de forma predeterminada).

  • Límite de velocidad: Durante la beta, hasta 600 solicitudes por minuto por clave o conexión y 1.200 por organización (REST y MCP en conjunto). Si lo superas, recibirás el estado 429 y un encabezado Retry-After .

  • Errores: Cada respuesta incluye un Request-Id. Inclúyelo cuando contactes con el servicio de asistencia por un error.


6. Gestionar claves y conexiones

Todas las claves de tu organización aparecen debajo del cuadro de Conectar .

  1. Estado: Muestra si la clave está activa o revocada.

  2. Último uso: Muestra cuándo se utilizó la clave por última vez; esto te ayuda a encontrar claves que ya nadie necesita.

  3. Revocar: Desactiva la clave.

  1. Confirma con Revocar clave. Todas las herramientas que utilicen esta clave perderán el acceso inmediatamente. Esta acción no se puede deshacer.

Una clave también deja de funcionar automáticamente cuando caduca, cuando la API se desactiva para su organización o cuando su propietario se archiva o deja de ser administrador.

Conexiones OAuth: Puedes ver y revocar tus propias conexiones en la aplicación web de PULT, en Configuración → Conexiones. Los administradores pueden ver todas las conexiones de la organización en el panel, en Configuración → Seguridad → Conexiones. Una conexión finaliza automáticamente después de 90 días sin uso o cuando su propietario se archiva, y se pausa mientras su propietario no sea administrador.


Preguntas frecuentes

¿Puedo crear o modificar reservas mediante la API?

Todavía no. La beta es de solo lectura: no puedes crear ni modificar reservas, usuarios ni otros datos. Acciones como reservar o liberar un escritorio están previstas para una versión posterior.

¿Quién puede conectarse y qué datos puede ver?

Solo los administradores pueden crear claves de API y conectar herramientas de IA. Las claves y las conexiones leen con los permisos de su propietario, sujetos a la configuración de privacidad de su organización. Con OAuth, cada administrador utiliza su propia conexión, por lo que no es necesario compartir una clave. Aún no es posible limitar el acceso a determinados datos.

He perdido mi clave de API. ¿Puedo volver a verla?

No, una clave solo se muestra una vez. Cree una nueva clave y revoque la anterior.

Nuestra integración ha dejado de funcionar. ¿Qué ha ocurrido?

Comprueba el estado y la fecha de caducidad de la clave en la página de claves de API. Las claves también dejan de funcionar cuando el propietario se archiva o deja de ser administrador; en ese caso, otro administrador crea una nueva clave. Para las conexiones OAuth, vuelve a conectarte en tu herramienta de IA.

¿Puedo conectar ChatGPT?

Sí. ChatGPT se conecta mediante OAuth: añade PULT como conector personalizado con la URL del servidor e inicia sesión con tu cuenta de PULT (paso 1). La posibilidad de añadir conectores personalizados depende de tu plan de ChatGPT.

¿Cambiará la API?

Es posible. La versión beta v1beta puede cambiar antes de que se publique la versión estable. Añadimos nuevos datos y funciones periódicamente; dinos lo que echas en falta en support@pult.com .


Artículos relacionados


Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de soporte en support@pult.com.