Servidor MCP de Papely

Papely convierte un PDF que ya tienes en una plantilla reutilizable con campos editables (texto, fechas, imágenes, códigos QR y tablas) y genera documentos personalizados a partir de tus datos. El servidor MCP de Papely lleva lo mismo a los asistentes de IA compatibles con el Model Context Protocol, para que crees documentos pidiéndolo con tus palabras.

Un asistente conectado a Papely puede listar las plantillas de tu workspace y leer qué campos acepta cada una; generar un PDF suelto, o hasta 100 en un lote que se descarga como ZIP; comprobar cuándo está lista una generación y obtener un enlace de descarga temporal; registrar una imagen desde una URL pública para usarla en un campo de imagen; y enviar cada documento por email a su destinatario, y después ver si se entregó y si lo descargó.

Te conectas iniciando sesión en Papely y aprobando el asistente en una pantalla de consentimiento, y puedes revocar ese acceso cuando quieras. El asistente solo llega a las plantillas, documentos e imágenes de tu propio workspace. Cada documento generado cuenta en la cuota de generaciones de tu workspace, igual que si lo generaras desde la web de Papely.

Todos los clientes se conectan a la misma URL del servidor:

https://api.papely.app/api/integrations/mcp/v1

Claude (web y app de escritorio)

Añade la URL del servidor como conector personalizado (Settings → Connectors → Add custom connector). Claude abre el inicio de sesión de Papely; en cuanto apruebas el acceso en la pantalla de consentimiento, las herramientas están listas. Sin claves ni cabeceras.

Claude Code

claude mcp add --transport http papely https://api.papely.app/api/integrations/mcp/v1

Añade el servidor y después ejecuta /mcp dentro de Claude Code y elige papely para autorizarlo. Se abrirá el navegador con el inicio de sesión de Papely.

Con una clave de API (Cursor, CI y servidores)

Los clientes que pueden enviar cabeceras pueden usar una clave de API de Papely en lugar de OAuth, enviada como Authorization: Bearer papely_sk_.... Crea y revoca tus claves en Papely, en Integraciones → API.

Claude Code (sin navegador)

claude mcp add --transport http papely https://api.papely.app/api/integrations/mcp/v1 \
  --header "Authorization: Bearer papely_sk_..."

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "papely": {
      "url": "https://api.papely.app/api/integrations/mcp/v1",
      "headers": { "Authorization": "Bearer papely_sk_..." }
    }
  }
}

ChatGPT

Para usar Papely desde ChatGPT, añade la URL del servidor como conector personalizado siguiendo la ayuda de OpenAI sobre servidores MCP personalizados.

El servidor ofrece ocho herramientas. La columna Acceso indica si una herramienta solo lee, crea contenido en tu workspace o además puede enviar emails.

Los emails solo salen si los pides: el asistente tiene que pasar el destinatario y el texto del correo. Una generación sin ellos no envía nada.

Papely añade una plantilla de demostración, Demo - Entrada de evento, a cada cuenta la primera vez que abres tus plantillas o proyectos, o la primera vez que un asistente lista tus plantillas. Si la crea un asistente, sale siempre en inglés: «Demo - Event ticket», el mismo nombre que si usaste Papely en inglés la primera vez. Tiene dos campos: name (texto) y ticket (un código QR). Estos prompts funcionan con ella tal cual. El segundo y el tercero generan documentos y usan tu cuota; ninguno envía emails.

1. Prompt

   Lista mis plantillas de Papely y enséñame los campos de la plantilla «Demo - Entrada de evento».

   Qué pasa: El asistente llama a list_templates y get_template, y responde con tus plantillas y los campos de la demo, entre ellos name y ticket.

2. Prompt

   Genera un PDF con la plantilla «Demo - Entrada de evento» para Ada Lovelace con el código de entrada PCONF26-ADA1 y dame el enlace de descarga.

   Qué pasa: El asistente llama a generate_document, espera con get_generation_status y responde con un enlace de descarga del PDF obtenido con get_generation_document.

3. Prompt

   Crea un lote con la plantilla «Demo - Entrada de evento» para Ada Lovelace, Grace Hopper y Alan Turing, con los códigos de entrada PCONF26-001, PCONF26-002 y PCONF26-003, y dame el enlace de descarga del ZIP.

   Qué pasa: El asistente llama a generate_batch, espera a que el trabajo se complete y responde con un enlace de descarga de un ZIP con los tres PDFs.

Los límites se aplican por workspace y por minuto:

• 120 peticiones al servidor en total, sumando todas las herramientas.
• 10 llamadas a generate_document o generate_batch.
• 20 llamadas a register_image_from_url.

Al pasar un límite, el servidor responde con un error RATE_LIMITED. Espera un momento y vuelve a intentarlo.

Cada documento generado usa una generación de la cuota de tu workspace, igual que en la web: un lote de 20 documentos usa 20. Cuando se agota la cuota, la generación falla con GENERATION_QUOTA_EXCEEDED. Las imágenes registradas con register_image_from_url cuentan en tu almacenamiento.

Claude, Claude Code y los demás clientes OAuth solo obtienen acceso después de que inicies sesión en Papely y los apruebes en la pantalla de consentimiento. Actúan sobre el workspace del que eres propietario.

Para revocar un cliente OAuth, abre Integraciones → MCP en Papely y pulsa Revocar junto a él, en Clientes autorizados. Pierde el acceso al momento.

Las claves de API se revocan en Integraciones → API.

¿Dudas o problemas? Escríbenos a [email protected]. Cómo trata Papely tus datos se explica en la política de privacidad.