Conecta tu agente mediante MCP

Conecta PDFCraft a un agente de IA compatible con servidores MCP remotos. Tu agente podrá convertir PDF a Markdown o EPUB, traducir PDF y libros EPUB, consultar tu saldo, estimar costes y obtener los resultados.

Configura la conexión

1. Crea tu propia API Key en OOMOL Console.
2. Añade un servidor MCP remoto en los ajustes de tu agente. Introduce https://api.pdfcraft.ai/v1/mcp como URL y selecciona Streamable HTTP como transporte.
3. Añade la cabecera Authorization: Bearer YOUR_API_KEY y sustituye YOUR_API_KEY por tu clave.

Este JSON muestra los datos de conexión. Los nombres de los campos varían según el cliente; introduce estos valores en sus ajustes de URL y cabeceras HTTP:

{  "url": "https://api.pdfcraft.ai/v1/mcp",  "headers": {    "Authorization": "Bearer YOUR_API_KEY"  }}

Guarda la clave en los ajustes protegidos del cliente. No la pegues en conversaciones ni la incluyas en enlaces a archivos. Las conversiones consumen créditos de PDFCraft; puedes recargar aquí.

Comprueba la compatibilidad

El servicio utiliza Streamable HTTP con la versión 2026-07-28 del protocolo MCP. El cliente debe admitir esta versión y permitir cabeceras de autenticación Bearer personalizadas. No se admiten los flujos antiguos de inicialización y sesión de 2025.

No hay inicio de sesión interactivo mediante OAuth. Los clientes que exigen OAuth y no permiten enviar una API Key como Bearer no pueden conectarse directamente.

Prueba tu primera conversión

Una vez conectado, el agente puede descubrir las herramientas y leer sus instrucciones. Pídele que llame primero a get_capabilities para conocer los formatos, idiomas y pasos disponibles. Por ejemplo:

Convierte este PDF a EPUB. Antes de empezar, consulta mi saldo y estima el coste.

El agente debe poder leer y subir el contenido del archivo; una ruta local por sí sola no permite al servidor remoto acceder a él. Después podrá crear una tarea, subir el archivo, iniciar el proceso, consultar el progreso y obtener un enlace de descarga. Guarda el UUID de la tarea para retomarla más adelante.

Por defecto, se descarga el archivo completo. Si un importe pendiente bloquea la descarga, recarga el saldo y solicita un nuevo enlace para la misma tarea. Solo se entrega un archivo incompleto si se solicita expresamente y hay una versión disponible.

Para integrar el servicio directamente en tu aplicación, consulta la referencia de la API REST.