PDFGate

Servidor MCP de PDFGate

Servidor del Protocolo de Contexto de Modelo (MCP) para la API de PDFGate. Permite a los asistentes de IA generar PDFs, gestionar documentos y manejar firmas electrónicas.

Instalación

Añade lo siguiente a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "pdfgate": {
      "command": "npx",
      "args": ["-y", "@pdfgate/mcp-server"],
      "env": {
        "PDFGATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Servidor alojado (remoto)

Si prefieres no ejecutar nada localmente, también alojamos el servidor MCP, para que puedas conectarte directamente a él — sin npx, sin proceso local. Apunta cualquier cliente que soporte servidores MCP remotos (HTTP Streamable) a:

https://mcp.pdfgate.com/server

Puedes autenticarte de dos maneras.

Opción 1 — OAuth

Para clientes que soporten servidores MCP remotos con OAuth (como Claude y ChatGPT), añade el servidor solo con su URL e inicia sesión a través de tu navegador. No hay clave que copiar o almacenar: el cliente se registra, te envía al panel de PDFGate para aprobar el acceso y recibe automáticamente un token con alcance limitado.

{
  "mcpServers": {
    "pdfgate": {
      "type": "http",
      "url": "https://mcp.pdfgate.com/server"
    }
  }
}

Muchos clientes te permiten añadirlo desde su interfaz en lugar de un archivo de configuración — por ejemplo, en Claude: Configuración → Conectores → Añadir conector personalizado, y luego introduce la URL anterior. Las sesiones OAuth se ejecutan contra tu cuenta de producción; para el sandbox, usa un X-API-KEY con una clave test_.

Opción 2 — Clave de API

Pasa tu clave en el encabezado X-API-KEY:

{
  "mcpServers": {
    "pdfgate": {
      "type": "http",
      "url": "https://mcp.pdfgate.com/server",
      "headers": {
        "X-API-KEY": "your_api_key_here"
      }
    }
  }
}

Las claves live_ usan producción y las claves test_ usan el sandbox — el entorno se selecciona automáticamente según la clave.

El servidor alojado proporciona el conjunto completo de herramientas de PDFGate (generación de PDFs, procesamiento, campos de formulario, firmas electrónicas y webhooks). Los nombres exactos de los campos de configuración del cliente (por ejemplo, type / transport, headers) pueden variar según el cliente MCP.

Cómo obtener una clave de API

Regístrate en pdfgate.com para obtener tu clave de API.

• Las claves que comienzan con live_ se conectan al entorno de producción
• Las claves que comienzan con test_ se conectan al entorno sandbox

Herramientas

Operaciones con PDF

Herramienta	Descripción
generate_pdf	Genera un PDF a partir de una URL o HTML sin procesar
upload_file	Sube un archivo PDF local o desde una URL
get_document	Recupera metadatos del documento y una URL de descarga actualizada
download_file	Descarga los bytes PDF sin procesar de un documento almacenado
delete_document	Elimina un documento
flatten_pdf	Convierte un PDF interactivo en un archivo estático y no editable
extract_form_data	Extrae los valores de los campos de formulario de un PDF rellenable
add_form_fields	Añade campos de formulario interactivos a un PDF (etiquetas de marcador de posición o posiciones explícitas)
compress_pdf	Comprime un PDF para reducir el tamaño del archivo
protect_pdf	Cifra un PDF con contraseña y restricciones de permisos
watermark_pdf	Aplica una marca de agua de texto o imagen a un PDF

Firmas electrónicas

Herramienta	Descripción
create_envelope	Crea un sobre de firma a partir de uno o más documentos
send_envelope	Envía un sobre creado a los destinatarios
get_envelope	Obtiene el estado actual de un sobre
void_envelope	Anula un sobre para que ya no pueda firmarse
delete_envelope	Elimina un sobre y sus documentos firmados
create_embed_link	Crea un enlace de firma de corta duración para un destinatario integrado

Destinatarios

Herramienta	Descripción
create_recipient	Almacena un destinatario para reutilizarlo en varios sobres
list_recipients	Lista los destinatarios almacenados por correo electrónico
get_recipient	Recupera un destinatario almacenado por ID
update_recipient	Actualiza el nombre o los metadatos de un destinatario almacenado

Gestión de webhooks

Herramienta	Descripción
create_webhook	Suscríbete a eventos de PDFGate
get_webhook	Recupera una suscripción de webhook por ID
delete_webhook	Elimina una suscripción de webhook

Disparadores de webhook

El servidor escucha eventos entrantes de PDFGate en el puerto 3599 por defecto. Para recibir eventos:

1. Expón el puerto 3599 a internet (por ejemplo, mediante ngrok)
2. Usa la herramienta create_webhook para registrar tu URL pública

Eventos admitidos:

Evento	Descripción
envelope.sent	Se han enviado correos de solicitud de firma a los destinatarios
envelope.completed	Todos los documentos del sobre han sido firmados
envelope.expired	El sobre expiró antes de que se firmaran todos los documentos
envelope.document.completed	Un solo documento dentro del sobre ha sido firmado por completo
envelope.recipient.signed	Un destinatario ha firmado un documento en el sobre
envelope.voided	El sobre fue anulado por el remitente
envelope.deleted	El sobre fue eliminado

Los eventos recibidos están disponibles a través del recurso MCP pdfgate://events y se envían al cliente en tiempo real.

Variables de entorno

Variable	Requerida	Predeterminada	Descripción
PDFGATE_API_KEY	Sí	—	Tu clave de API de PDFGate
PDFGATE_WEBHOOK_PORT	No	3599	Puerto para el listener de webhooks

---