Primeros pasos con pdfmcp
Tres formas locales de usar pdfmcp: herramientas web gratuitas que se ejecutan en tu dispositivo, el servidor MCP local para agentes de IA y la API local desde tu propio código, cada una lista en aproximadamente un minuto.
Tres formas de usar pdfmcp, todas locales
pdfmcp es una caja de herramientas con tres puertas, y las tres están en tu lado. Las herramientas web de este sitio se ejecutan en tu navegador, en tu dispositivo: tu archivo nunca se sube y no necesitas registrarte en nada. El servidor MCP local expone las mismas operaciones como herramientas tipadas que agentes de IA como Claude y Cursor pueden llamar directamente, ejecutándose en tu máquina. Y la API local permite llamar a las mismas operaciones desde tu propio código, también en tu máquina.
Las tres son gratuitas para siempre. No hay plan de pago, ni marca de agua, ni reloj de prueba, ni cuenta, ni clave y ni cupo diario: tu dispositivo hace el trabajo, así que tu dispositivo es el único límite práctico.
Forma 1: Usa una herramienta web (sin registro)
Abre el índice de herramientas y elige lo que necesitas: unir, dividir, comprimir, convertir, OCR, firmar, censurar y más. Las herramientas marcadas como «En el dispositivo» procesan tu archivo por completo en esta pestaña del navegador: suelta el archivo, ajusta las opciones y descarga el resultado. Nada se nos transmite, así que no hay nada que almacenar, registrar o filtrar.
Algunas operaciones necesitan maquinaria pesada (OCR completo, conversión de Office, criptografía). Esas páginas están marcadas como «Local · MCP» y explican cómo ejecutar el trabajo localmente con el paquete, en tu máquina, con la misma privacidad.
Forma 2: Instala el paquete local
El paquete se instala una sola vez con el comando de instalación de la página MCP. Después se ejecuta por completo en tu máquina: sin cuenta que crear, sin clave que copiar y sin nada que caduque.
Los motores pesados (qpdf, datos de idioma de OCR) se descargan una sola vez, con verificación SHA-256, en el primer uso y se quedan guardados en tu máquina para los usos siguientes.
Forma 3: Conecta el servidor MCP local a tu agente de IA
El servidor MCP se ejecuta localmente (stdio) en la misma máquina que tu agente. La mayoría de los clientes aceptan esta forma de configuración, que hace que el cliente arranque el paquete por ti:
{"mcpServers": {"pdfmcp": {"command": "uvx", "args": ["--from", "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl", "pdfmcp"]}}}Reinicia tu cliente tras editar su configuración; las herramientas de pdfmcp aparecerán en su lista. Hay guías paso a paso para 13 clientes (Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Zed, Cline, Continue, JetBrains y cualquier otro cliente MCP) enlazadas desde la página MCP. ChatGPT no puede iniciar procesos locales, así que dentro de ChatGPT no hay puerta local: usa en su lugar cualquiera de los clientes locales.
Tu primera llamada local
Desde tu propio código o tu terminal, el flujo es el mismo de siempre, pero sin servidor remoto: instala el paquete, elige una operación y ejecútala sobre un archivo de tu máquina. La operación lee el archivo localmente y escribe el resultado localmente.
El catálogo de operaciones de esta web (cada operación, sus parámetros y sus esquemas) describe también el paquete local, porque es el mismo catálogo: lo que ves en las páginas de herramientas es lo que tu agente y tu código pueden llamar.
Límites y privacidad, en serio
Los únicos límites son los de tu dispositivo: memoria, velocidad y, en el navegador, archivos de hasta unos 100 MB y 500 páginas. No hay cupo que gastar ni cola que esperar.
La privacidad es arquitectónica. Todo se ejecuta localmente, así que tus archivos nunca salen de tu máquina, nunca se almacenan en ningún servidor y nunca se usan para entrenar IA. Lo único que recoge este sitio es analítica de páginas (consultas y Google Analytics agregado), que nunca toca tus documentos.
Conecta tu agente de IA — servidor MCP local gratuito
Preguntas frecuentes
¿pdfmcp es realmente gratuito?
Sí, gratis para siempre. Todas las herramientas se ejecutan localmente, sin cuenta y sin marca de agua. No hay plan de pago: una caja de donaciones opcional (actualmente desactivada) es todo el modelo de negocio.
¿Necesito una cuenta?
No. No hay cuentas en pdfmcp: ni para las herramientas web, ni para el servidor MCP local, ni para la API local.
¿Adónde van mis archivos?
A ninguna parte: el procesamiento ocurre en tu dispositivo o en tu máquina, y tus archivos nunca se suben ni se usan para entrenar IA.
¿Cómo llama mi agente al servidor MCP local?
Tu cliente arranca el paquete pdfmcp como un proceso local (stdio) con la configuración de las guías. No hay ninguna cabecera secreta que configurar, porque no hay ningún servidor remoto.
¿Hay algún límite diario?
No. Sin cupo diario, sin ritmo por hora y sin contador: tu dispositivo es el único límite práctico.
¿Puedo usar pdfmcp sin conexión?
En gran parte sí: una vez cargadas la página y sus bibliotecas, las herramientas web funcionan en tu navegador, y el paquete local funciona en tu máquina. Solo las descargas de motores en el primer uso necesitan conexión.
Publicado originalmente en https://pdfmcp.org/guides/getting-started/