Descripción general de automatización — Zapier, MCP y webhooks
Compara conectores privados de Zapier, herramientas MCP delegadas por OAuth, webhooks de proyecto firmados y orquestación de API REST, con requisitos previos de implementación y limitaciones.
Elige la superficie de automatización correcta#
PDFHQ ofrece diferentes superficies de integración en lugar de un único endpoint REST llamado Zapier o MCP. La API de tareas impulsa el procesamiento; los webhooks del proyecto entregan eventos; una aplicación CLI de Zapier Platform no publicada envuelve operaciones REST permitidas; MCP expone herramientas OAuth delegadas para agentes de IA.
API directa: tarea documentada, carga, rutas de IA y firma son accesibles con las credenciales y permisos de cuenta apropiados. Zapier: la fuente está disponible en integrations/zapier pero no hay una aplicación publicada. PCM: el servidor local existe; OAuth alojado está en fase de prueba y no es certificado público. Ganchos web: los puntos finales de origen existen pero devuelven 503 a menos que estén habilitados por un operador después de la configuración y prueba.
Ejemplo: trabajo PDF → webhook → automatización#
Primero envíe una tarea PDF propiedad del proyecto utilizando el ciclo de vida normal de la API. Suscríbase al evento completado solo después de que su implementación haya activado los webhooks del cliente, el cifrado y el trabajador de entrega. Guarde el secreto de firma devuelto una vez; verifique la carga útil sin procesar exacta y rechace la reproducción antes de activar la automatización posterior.
# Staging only: project API key stored on your server.
curl -X POST 'https://api.pdfhq.io/v1/webhooks' \
-H 'x-api-key: YOUR_PROJECT_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"target_url":"https://your-app.example/events/pdfhq","events":["pdf.job.succeeded","ai.job.succeeded"]}'
# The first response includes a one-time HMAC signing secret.
# Verify X-PDFHQ-Webhook-Timestamp and X-PDFHQ-Webhook-Signature: v1=...;
# reject old messages and deduplicate on the event ID.La carga útil del webhook contiene metadatos, no bytes PDF ni enlaces de descarga firmados. Recupera cualquier resultado permitido de forma independiente a través de APIs PDFHQ autenticadas. La entrega es al menos una vez, por lo que los consumidores deben manejar duplicados.
Eventos webhook, verificación, reintentos y reproducción →Zapier: fuente de aplicación privada#
La autenticación por clave de proyecto habilita disparadores y acciones de trabajos PDF/IA, con REST Hooks firmados para eventos de proyecto compatibles y respaldo de sondeo. Un documento autorizado ya debe estar cargado a través del flujo de carga sellada. La aplicación solo puede preparar borradores de firma de sandbox no enviados; no puede enviar invitaciones en vivo.
cd integrations/zapier
npm install
npm test
npx zapier-platform validateValida el conector con una cuenta de desarrollador de Zapier y API de staging antes de publicar nada. Este repositorio no contiene un listado público de Zapier ni un enlace de instalación con un clic.
Disparadores, acciones y limitaciones de Zapier →MCP: acceso delegado de agente de IA#
MCP utiliza HQTools OAuth Authorization Code + PKCE y scopes PDFHQ verificados por audiencia. No es una variante de clave API de Zapier y no recibe webhooks. El stdio local se puede probar con un token de corta duración obtenido por separado; alojar un servidor MCP remoto requiere configuración del operador, PKCE y aceptación del ciclo de vida.
https://mcp.pdfhq.io/mcpLas herramientas permitidas incluyen estado/envío de trabajos PDF, cotizaciones/trabajos de IA y estado de firma limitado. La redacción, eliminación, envío de firma en vivo y administración de credenciales se excluyen deliberadamente de las herramientas autónomas. La ejecución de IA continúa a través de las reglas de crédito y consentimiento de HQTools.
Alcances OAuth de MCP y configuración de staging →Otros sistemas de flujo de trabajo#
Los conectores nativos de Make y n8n no están implementados ni publicados. Sus módulos HTTP pueden llamar a operaciones REST documentadas, y los puntos finales HTTPS compatibles pueden recibir webhooks de proyecto una vez habilitados. No configures flujos de trabajo de producción hasta que la autenticación del proyecto, firmas de eventos, facturación y reintentos pasen pruebas conectadas.
Construye con el inicio rápido de tareas REST →