Integración

Beta

Conecta Claude, Cursor y otros agentes de IA a tus PDF

En pocas palabras

Para conectar Claude, Cursor u otro agente de IA a tus PDF, usa el servidor MCP (Model Context Protocol) remoto de PDFBetter: crea una clave de agente en Ajustes → Agentes (MCP), añade https://pdfbetter.com/api/mcp/ con esa clave a tu cliente MCP y pide lo que necesites. El agente puede listar tus documentos, rellenar campos de formulario, unir, dividir, convertir, comprimir y aplicar OCR, extraer datos de facturas a JSON, ejecutar flujos de trabajo, preguntar en espacios de documentos y responder citando la página. Los resultados vuelven como documentos o revisiones nuevas con enlaces de descarga de corta duración; los originales nunca se sobrescriben.

Your MCP client

you ›

Merge the three latest invoices into one PDF and give me the link

→ list_documents

→ merge_documents

→ export_document

PDFBetter MCP server

Only the tools the key's permissions allow. Each call acts as you, within your plan.

Documents

list_documents
fill_fields
export_document

PDF tools

merge_documents
convert
ocr_document

AI & data

ask_document
extract_document
ask_workspace

Workflows & review

run_workflow
compare_documents
suggest_redactions

What comes back

A new document or revision — originals aren't overwritten
A download link that expires after a few minutes
Long jobs return a job id to poll

Illustration of one request. Tool names are the server's real ones; the prompt is an example.

Conéctalo en tres pasos

El endpoint es https://pdfbetter.com/api/mcp/ (con la barra final). Funciona con Streamable HTTP y se autentica con una cabecera Authorization: Bearer.

Crea una clave de agente
En Ajustes → Agentes (MCP), ponle el nombre del cliente que la usará y elige sus permisos. La clave empieza por pb_mcp_ y solo se muestra una vez.
Añade el servidor a tu cliente
Claude Code: claude mcp add --transport http pdfbetter https://pdfbetter.com/api/mcp/ --header "Authorization: Bearer pb_mcp_…". Cursor: añade la URL y una cabecera Authorization en mcp.json. En la página de ajustes tienes fragmentos listos para copiar para cada cliente, incluido Claude Desktop a través del puente mcp-remote.
Pide un resultado
Por ejemplo: «Une las tres últimas facturas en un PDF y pásame el enlace» o «¿Cuál es el plazo de preaviso del contrato de alquiler? Cita la página».

1
Create an agent key
pb_mcp_…
2
Add the server to your client
https://pdfbetter.com/api/mcp/
3
Ask for an outcome
“What is the notice period in the lease? Quote the page.”

Qué puede hacer el agente

Documentos: listar y buscar, leer detalles, importar un PDF desde una URL pública, obtener un enlace de subida para archivos locales, listar y rellenar campos, exportar el PDF rellenado, crear un documento desde una plantilla y leer formularios publicados y sus respuestas.

Herramientas PDF: unir, dividir, rotar y extraer páginas (cada resultado se guarda como documento nuevo), convertir PDF a Word, Excel, PowerPoint, CSV, texto o imágenes y archivos de Office a PDF, comprimir y añadir una capa de texto buscable a escaneos (OCR).

IA: resúmenes cuyos puntos clave citan la página y respuestas con citas comprobadas palabra por palabra contra la página indicada. Si el documento no contiene la respuesta, el agente lo sabe en lugar de recibir una suposición.

Extracción de datos: listar y crear esquemas, extraer un documento con la página de origen de cada valor, lanzar un lote, seguir su progreso, registrar decisiones de revisión y exportar a JSON, CSV o Excel.

Flujos y espacios: listar flujos guardados, iniciar una ejecución, consultar su estado y cancelarla, y aprobar un paso de revisión solo donde lo hayas permitido. Crear espacios de documentos, añadir documentos, preguntar con citas que indican la versión y generar un informe o un guion de diapositivas con fuentes.

Revisión: comparar dos versiones y obtener la lista de cambios explicada, pedir sugerencias de censura (aplicarla sigue en manos de una persona en la app) y leer la actividad de enlaces compartidos y los envíos de formularios.

Ajustes, Agentes (MCP): la dirección del servidor con un botón para copiarla, pestañas de configuración para Claude Code, Claude Desktop, Cursor y otros clientes, y un formulario para nombrar una clave de agente y elegir sus permisos — La dirección del servidor, lista para copiar
Configuración para copiar y pegar en cada cliente
Cada clave tiene solo los permisos que marques
Settings → Agents (MCP), where keys and client snippets live. Sample content; names are fictional.

Permisos y seguridad

Cada clave tiene los permisos que eliges al crearla: leer documentos, crear y rellenar documentos, leer formularios y respuestas, leer plantillas, usar herramientas PDF, usar IA, leer o ejecutar extracciones, leer o ejecutar flujos, leer o gestionar espacios y leer analíticas de enlaces. El agente solo ve y llama a las herramientas que permite su clave; cualquier otra llamada se rechaza.

Las claves actúan en tu nombre, sobre tus documentos y los compartidos con tu equipo. Si revocas una clave en Ajustes, el cliente pierde el acceso al instante. Solo guardamos un hash de cada clave.

Los cambios conservan el historial: rellenar campos y el OCR guardan una revisión nueva, y las herramientas de páginas crean documentos nuevos. Rellenar campos y el OCR sobre un documento existente también quedan en su registro de auditoría.

El endpoint rechaza peticiones hechas desde páginas web: las claves van en un cliente MCP o en un servidor, nunca en un navegador.

Precio

El acceso de agentes está incluido en todos los planes con cuenta, también en Free. Cada llamada a una herramienta cuenta como una llamada de agente; las fallidas no cuentan.

Llamadas de agente al mes: 200 en Free, 5000 en Pro y ilimitadas (uso razonable) en Business.

El trabajo que desencadena una llamada consume las mismas cuotas que en la app: documentos exportados, conversiones en servidor (incluida la compresión), páginas de OCR y créditos de IA. Una clave de API de Business (pb_live_) también funciona en este endpoint.

Client configuration

Connect your MCP client

Endpoint https://pdfbetter.com/api/mcp/. Replace pb_mcp_YOUR_KEY with the agent key you create in Settings; the settings page fills it in for you.

Claude CodeClaude DesktopCursorOther clients

Claude CodeRun in your terminal

claude mcp add --transport http pdfbetter https://pdfbetter.com/api/mcp/ --header "Authorization: Bearer pb_mcp_YOUR_KEY"

Add --scope user to use it in every project.

Claude Desktopclaude_desktop_config.json (Settings → Developer → Edit config), then restart Claude

{
  "mcpServers": {
    "pdfbetter": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pdfbetter.com/api/mcp/",
        "--header",
        "Authorization:${PDFBETTER_AUTH}"
      ],
      "env": {
        "PDFBETTER_AUTH": "Bearer pb_mcp_YOUR_KEY"
      }
    }
  }
}

Claude Desktop's custom connectors sign in with OAuth, which PDFBetter doesn't offer yet; this uses the open-source mcp-remote bridge (needs Node.js) to send your key.

Cursor~/.cursor/mcp.json (or .cursor/mcp.json in a project)

{
  "mcpServers": {
    "pdfbetter": {
      "url": "https://pdfbetter.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer pb_mcp_YOUR_KEY"
      }
    }
  }
}

Other clientsAny MCP client that supports Streamable HTTP with custom headers

URL:        https://pdfbetter.com/api/mcp/
Transport:  Streamable HTTP (POST, stateless, JSON responses)
Header:     Authorization: Bearer pb_mcp_YOUR_KEY

Keep the trailing slash in the URL. Keys are secrets: use them from agents and servers, never in a web page.

Planes

Qué incluye cada plan

Límites de cada plan para Servidor MCP de PDFBetter
	Gratis	Pro	Business
Conectar agentes de IA (MCP)	Incluido	Incluido	Incluido
Llamadas de agentes (MCP) al mes	200	5000	ilimitado
Descargas de documentos editados al mes	3	ilimitado	ilimitado
Conversiones de Office y avanzadas al mes	10	500	2000
Páginas de OCR al mes	20	1000	5000
Créditos de IA al mes	20	500	2000

Cada acción de IA cuesta un número fijo de créditos; la lista completa está en la página de precios. Comparar todos los planes

Lo que no hace

Un servidor MCP no es un programador de tareas ni un agente autónomo: no se ejecuta nada si tu cliente no llama a una herramienta. Para repetir pasos sobre documentos nuevos, usa flujos de trabajo.
Los agentes solo actúan dentro de los permisos de la clave y los límites de tu plan. No pueden enviar solicitudes de firma, gestionar webhooks, eliminar documentos ni cambiar ajustes de la cuenta.
Las tareas largas (conversiones, compresión, OCR) devuelven un id de trabajo que el agente consulta; la llamada no espera a que el archivo esté listo.
El acceso es con clave en una cabecera. Aún no hay inicio de sesión OAuth, así que los clientes que solo admiten conectores OAuth necesitan un puente como mcp-remote.
Los enlaces de descarga caducan en pocos minutos; el agente pide uno nuevo cuando lo necesita.
Las respuestas de IA leen la capa de texto. Las páginas escaneadas necesitan OCR antes, y las que superan el límite de páginas de IA de tu plan no se leen (la respuesta indica cuáles).

Servidor MCP de PDFBetter: preguntas frecuentes

¿Qué clientes MCP funcionan con PDFBetter?

Cualquiera que admita servidores remotos por Streamable HTTP con una cabecera Authorization propia, como Claude Code y Cursor. Claude Desktop funciona con el puente de código abierto mcp-remote hasta que PDFBetter ofrezca inicio de sesión OAuth.

¿El agente modifica mis archivos originales?

No. Unir, dividir, rotar y extraer páginas crean documentos nuevos. Rellenar campos y el OCR guardan una revisión nueva del mismo documento, y las anteriores siguen en su historial de versiones.

¿Cómo se cuentan las llamadas de agente?

Cada llamada correcta cuenta una vez contra tu cuota mensual; las que fallan (por ejemplo, por falta de permiso o un rango de páginas no válido) no cuentan. Exportaciones, conversiones, páginas de OCR y créditos de IA se cuentan aparte, igual que en la app.

¿Puedo limitar lo que hace un agente?

Sí. Elige los permisos al crear la clave, por ejemplo solo lectura de documentos. Las herramientas fuera de esos permisos quedan ocultas para el agente y se rechazan si las llama. Usa una clave por cliente para poder revocarlas por separado.

¿Puede un agente trabajar con un archivo de mi equipo?

Sí. El agente pide un enlace de subida, sube el archivo y crea un documento a partir de él. También puede importar archivos públicos por URL; las direcciones de redes privadas y las redirecciones se rechazan.

¿Tengo que instalar algo?

No hay ningún servidor que instalar. Claude Code y Cursor se conectan a la URL directamente con tu clave en una cabecera. Claude Desktop necesita Node.js para el puente mcp-remote, que el fragmento de la página de ajustes ejecuta con npx.

¿Puede un agente extraer datos de facturas o ejecutar mis flujos?

Sí, si su clave tiene los permisos de extracción o de flujos. Puede extraer campos a JSON con la página de origen, lanzar lotes y exportaciones e iniciar ejecuciones. Los pasos de revisión siguen esperando a una persona salvo que permitas la aprobación por agente en ese paso.

¿Son fiables las respuestas de la IA?

Salen del propio texto del documento y citan páginas. Cada cita se comprueba contra el texto de la página indicada y se descarta si no está; una respuesta sin cita verificable se da como no encontrada. Comprueba las respuestas importantes en las páginas citadas.