Convierte archivos en Claude y Cursor con el MCP de GuruPDF

Tu agente de programación puede montar una app, desenredar un stack trace y discutir contigo sobre tabs frente a espacios. Pero pásale un PDF y pídele un documento de Word editable, y se queda atascado. Los archivos viven en tu disco; el modelo vive en el chat. Nada conecta a los dos.

Esa brecha es justamente la razón por la que creamos el MCP de GuruPDF — un pequeño servidor MCP que le da a Claude, Cursor y cualquier otro cliente MCP una forma de convertir archivos de verdad. Pon una ruta en tu prompt, di lo que quieres, y el archivo convertido aterriza de vuelta en tu disco un instante después. Sin pantalla de subida, sin "descárgalo y luego vuelve a subirlo a otra parte". Solo "convierte ~/contracts/lease.pdf a Word."

Qué es realmente un MCP de conversión de archivos

MCP — el Model Context Protocol — es el enchufe que permite a un agente de IA usar herramientas fuera de su propia cabeza. Un servidor expone unas cuantas acciones; el agente las invoca cuando tu prompt las necesita. Hay servidores MCP para bases de datos, navegadores, GitHub.

No había uno bueno para archivos. Así que un PDF MCP — en realidad un MCP de conversión de archivos, ya que va mucho más allá del PDF — es simplemente un servidor que toma un archivo en un formato y te devuelve otro. PDF a Word. Una carpeta de imágenes a un único PDF. Una página escaneada a texto que se puede buscar. El agente hace la petición; GuruPDF hace la conversión.

Por debajo es el mismo motor que está detrás de gurupdf.com: 126 herramientas, más de 100 formatos, ahora al alcance desde dentro de tu editor.

Configúralo en unos dos minutos

Necesitas dos cosas: Node (para npx) y una clave de API gratuita de GuruPDF. Consigue una clave en gurupdf.com/profile — las cuentas gratuitas vienen con créditos diarios, así que puedes empezar a convertir de inmediato.

El servidor se instala y se ejecuta solo a través de npx; no hay nada que clonar:

npx gurupdf-mcp

Aunque no lo ejecutarás a mano — apuntas tu cliente MCP hacia él. Para Cursor, Claude Desktop, VS Code o Windsurf, añade esto a tu configuración de MCP:

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your-token-here" }
    }
  }
}

Reinicia el cliente y tu agente gana en silencio cuatro herramientas: convertir un archivo, consultar una tarea, listar lo que se admite y revisar tu saldo de créditos. Esa es toda la configuración.

Qué puedes hacer realmente con él

Esta es la parte divertida. Una vez conectado, estos son prompts reales que simplemente funcionan:

• "Convierte ~/Downloads/invoice.pdf a Word para que pueda editar los totales." — aparece un .docx editable junto al original.
• "Convierte cada captura de pantalla de ~/shots en un único PDF." — imágenes combinadas, en orden, en un solo archivo.
• "Este escaneo es solo una imagen. Pásale OCR y dame el texto." — texto real extraído de vuelta de los píxeles.
• "Comprime report.pdf, pesa 40 MB y necesito enviarlo por correo." — un archivo más pequeño que sigue siendo legible.
• "Haz un PDF de https://example.com/pricing." — la página en vivo, renderizada a PDF.

Nunca memorizas nombres de herramientas ni formatos. Di el objetivo en lenguaje natural y el servidor elige cuál de las 126 herramientas encaja, la ejecuta y escribe el resultado en el disco. Combinar, dividir, rotar, proteger con contraseña, añadir marca de agua, Excel ↔ PDF, HEIC → JPG — todo está ahí dentro.

Te responde cuando algo va mal

La mayoría de los conversores fallan con un código críptico; este está hecho para explicarse a sí mismo a través de tu agente — porque el agente es lo que de verdad está leyendo la respuesta.

Si te quedas sin créditos en el plan gratuito, no recibirás un escueto 402. Recibes una frase que tu asistente te transmite: has alcanzado el límite gratuito (2 conversiones por minuto, 10 al día), se reinicia mañana, y aquí tienes un enlace por si prefieres no esperar. Pásale a una herramienta el formato equivocado, o un archivo demasiado grande, y te dice exactamente eso — con palabras, no con un número de error. Nunca tienes que salir de la conversación para averiguar qué pasó.

Esa idea de "explicarlo a través del agente" es también la razón por la que cuidamos tanto la redacción. Un mensaje de error que ningún humano llega a leer aún tiene que tener sentido para el modelo que lo retransmite.

Qué hay por debajo

• 126 herramientas, más de 100 formatos. PDF, Word, Excel, PowerPoint, imágenes, libros electrónicos, incluso vídeo — el mismo motor que la web.
• Un plan gratuito de verdad. Cada cuenta recibe créditos diarios. Existen planes de pago y paquetes de créditos para un uso más intensivo, y tu agente te los señala cuando realmente tiene sentido, no antes.
• Los archivos no se quedan. Todo se mueve por HTTPS y se elimina en menos de una hora. El MCP escribe el resultado en tu disco; la copia de nuestro lado desaparece poco después.
• Código abierto. El servidor tiene licencia MIT, está publicado en npm y figura en el registro oficial de MCP, así que puedes leer cada línea antes de ejecutarlo.

Consíguelo

Si te pasas el día en Claude o Cursor y no paras de salir a alguna web conversora, esto elimina el viaje de ida y vuelta.

• Instalación: npx gurupdf-mcp
• Paquete: npmjs.com/package/gurupdf-mcp
• Registro: busca "GuruPDF" en el registro oficial de MCP
• Clave de API: gurupdf.com/profile

Añádelo una vez y olvídate de que está ahí — hasta la próxima vez que habrías abierto una pestaña del navegador para convertir un archivo, y tu agente simplemente lo hace por ti.