conv2pdf

Convierte documentos de Office, imágenes y libros electrónicos a PDF, convierte PDFs a Word o imágenes, y fusiona, comprime, protege o numera los PDFs de tu computadora. Alojado en Francia.

GitHub

Documentación

conv2pdf-mcp

Servidor oficial del Model Context Protocol de la API conv2pdf. Tu asistente de IA convierte archivos de Word, Excel, PowerPoint, Pages, imágenes y libros electrónicos a PDF, convierte PDFs a Word o a imágenes, y fusiona, comprime, protege, rota o numera los PDFs que están en tu computadora. El procesamiento se ejecuta en servidores de OVHcloud en Francia: sin transferencia fuera de la UE, ningún servicio estadounidense en la cadena.

Instalación · Herramientas · Cómo se comporta · Desarrollo

Instalación

Crea una cuenta en conv2pdf.com. El plan Dev incluye 300 conversiones gratuitas, válidas por 12 meses; consulta precios para los planes de pago.
Crea una clave de API, que comienza con cpdf_live_, en la pestaña Developer de tu panel de control. conv2pdf la muestra solo una vez, al crearla.
Añade el servidor a tu cliente MCP, con la clave en la variable de entorno CONV2PDF_API_KEY. Necesita Node.js 22 o posterior.

En Claude Code:

claude mcp add --env CONV2PDF_API_KEY=cpdf_live_... --transport stdio conv2pdf -- npx -y conv2pdf-mcp

En Windows, pon cmd /c antes de npx.

En Claude Desktop, Cursor y los demás clientes configurados con un archivo JSON:

{
  "mcpServers": {
    "conv2pdf": {
      "command": "npx",
      "args": ["-y", "conv2pdf-mcp"],
      "env": { "CONV2PDF_API_KEY": "cpdf_live_..." }
    }
  }
}

O, en Claude Code, instala el plugin: el mismo servidor, con una habilidad que le indica al asistente qué herramienta llamar, en qué orden, y cuánto cuesta una llamada.

/plugin marketplace add jamalofski/conv2pdf-mcp
/plugin install conv2pdf@conv2pdf

Claude Code solicita la clave de API cuando se habilita el plugin y la guarda en el almacén de credenciales del sistema, no en un archivo de configuración. Para configurarla más tarde, ejecuta /plugin configure conv2pdf@conv2pdf, o abre /plugin, pestaña Instalado, conv2pdf, Opciones de configuración. Un servidor añadido manualmente con el comando npx -y conv2pdf-mcp tiene prioridad sobre el del plugin.

Para otro agente que cargue habilidades SKILL.md, añade el servidor como arriba y toma solo la habilidad: plugin/skills/conv2pdf/SKILL.md en este repositorio, también listada en Agensi.

Luego pide lo que necesites: "convierte report.docx a PDF", "fusiona estos tres PDFs", "comprime scan.pdf y protégelo con una contraseña".

Herramientas

Herramienta	Qué hace
`convert_to_pdf`	Archivo Word, Excel, PowerPoint, OpenDocument, Apple Pages, RTF, TXT, CSV, PNG, JPG, WebP, GIF, TIFF, HEIC o EPUB a PDF, elegido por la extensión
`convert_heic_to_jpg`	Foto iPhone HEIC o HEIF a JPG
`convert_pdf_to_word`	PDF con texto real a un documento DOCX editable
`convert_pdf_to_images`	Un PNG o JPG por página, en un archivo ZIP
`merge_pdfs`	Combina varios PDFs en uno, en el orden dado
`extract_pdf_pages`	Conserva las páginas que listes, como `1-5,7,10-12`, en un nuevo PDF
`rotate_pdf`	Gira cada página 90, 180 o 270 grados
`add_page_numbers`	Numera las páginas, como "3 / 12" o "3", abajo al centro, a la izquierda o a la derecha
`add_watermark`	Sella un texto de hasta 50 caracteres en cada página
`compress_pdf`	Reduce el tamaño, manteniendo las imágenes a 72, 150 o 300 DPI
`protect_pdf`	Establece una contraseña y, opcionalmente, prohíbe imprimir o copiar
`unlock_pdf`	Elimina una contraseña que conozcas, o las restricciones de impresión y copia
`get_quota`	Plan, uso y límites de la clave de API

Cómo se comporta

Los archivos permanecen en tu computadora, excepto durante la conversión. Una herramienta toma la ruta de un archivo, envía el archivo a conv2pdf y escribe el resultado en tu disco. conv2pdf verifica el contenido del archivo, no solo su nombre.
Nada se sobrescribe. El resultado va junto al archivo de entrada: report.docx da report.pdf, y una herramienta de PDF añade un sufijo, como report-compressed.pdf. Cuando ese nombre ya está ocupado, el servidor escribe report (2).pdf. El asistente puede elegir el lugar con output_path; si ya hay un archivo allí, la herramienta se niega antes de convertir nada.
Eliminado del servidor. Una vez que el resultado está en tu disco, el servidor elimina el trabajo de conv2pdf. Si eso falla, conv2pdf elimina los archivos después de una hora.
Cuota. Cada conversión cuenta como una en la cuota de tu plan, incluida una que conv2pdf rechace después de leer el archivo, como un PDF ilegible o escaneado, o uno con demasiadas páginas. Un archivo rechazado al llegar (tipo incorrecto, demasiado grande, contraseña faltante), una configuración rechazada (un rango de páginas que no existe, una contraseña demasiado corta) y un fallo del lado de conv2pdf no cuentan, y get_quota es gratuito. Los archivos pueden pesar hasta 10 MB en el plan Dev y 200 MB en los planes de pago.
Límite de velocidad. La API acepta 20 conversiones por minuto por clave de API. Cuando pide reducir la velocidad, o cuando su cola está llena, el servidor espera el retraso que la API indica y lo intenta de nuevo, como máximo dos veces y solo para retrasos de 30 segundos o menos; de lo contrario, el asistente recibe el retraso a esperar.
PDFs protegidos. Las herramientas que leen un PDF, excepto merge_pdfs, abren uno que solicita contraseña cuando el asistente la pasa como password. El resultado no tiene contraseña. Para una fusión, desbloquea primero los PDFs protegidos.
Pages y Numbers. Un documento de Pages conserva su extensión .pages: solo el nombre lo distingue de una hoja de cálculo de Numbers, que conv2pdf no convierte, al igual que las presentaciones de Keynote.
Errores. Un rechazo vuelve al asistente como una frase sobre la que puede actuar: la contraseña incorrecta, el rango de páginas que no existe, el límite del plan, la clave a configurar. Una llamada cancelada detiene la transferencia y no deja ningún archivo.
Sin clave. El servidor se inicia y lista sus herramientas; una llamada explica cómo configurar CONV2PDF_API_KEY.

Cada solicitud lleva User-Agent: conv2pdf-mcp/<version>. Menciónalo cuando contactes con soporte: distingue tus llamadas en los registros de la API.

Desarrollo

El servidor no tiene dependencias: Node.js ejecuta las fuentes tal como están. Se comunica con su cliente a través de stdio y sirve ambas eras del protocolo desde el mismo proceso: la revisión 2026-07-28, donde cada solicitud lleva su versión de protocolo, y las revisiones anteriores (2025-11-25 hasta 2024-11-05), que comienzan con un apretón de manos initialize.

npm test

ejecuta las pruebas contra una API conv2pdf falsa en un puerto local: no se necesitan clave ni red.

npm run check-tools

compara las extensiones convert_to_pdf con las rutas que la API en vivo acepta (GET /v1/tools).

Plugin

plugin/ contiene el plugin de Claude Code: su manifiesto, el .mcp.json que inicia el paquete publicado con npx, y la habilidad, plugin/skills/conv2pdf/SKILL.md. .claude-plugin/marketplace.json es el catálogo que permite a Claude Code instalar el plugin desde este repositorio. Ninguno forma parte del paquete npm. npm test verifica que el plugin esté en la versión del paquete y que la habilidad nombre las herramientas que tiene el servidor.

claude plugin validate . --strict
claude --plugin-dir ./plugin

verifican los manifiestos y luego inician una sesión con el plugin cargado desde la carpeta, sin instalarlo. Un usuario recibe un cambio del plugin o de la habilidad cuando cambia la versión: se distribuye con un lanzamiento.

Publicación

Establece la versión en package.json, server.json y plugin/.claude-plugin/plugin.json, y fecha su sección en CHANGELOG.md.
Ejecuta npm test y npm run check-tools.
Haz commit y luego empuja una etiqueta con el nombre de la versión: el flujo de trabajo Publish publica el paquete en npm mediante Trusted Publishing, con una declaración de procedencia.
Publica la entrada del MCP Registry: mcp-publisher login http --domain conv2pdf.com, luego mcp-publisher publish. El nombre com.conv2pdf/conv2pdf está probado por la clave pública servida en https://conv2pdf.com/.well-known/mcp-registry-auth.
Cuando la habilidad cambie, súbela de nuevo a su listado en Agensi, como una nueva versión: un ZIP de una carpeta conv2pdf/ que contiene el SKILL.md. Nada actualiza el listado desde este repositorio.

Recursos

Soporte

Abre un issue o escribe a contact@conv2pdf.com.

Licencia

MIT, ver LICENSE.