PDFCheck MCP
Ver metadatos de PDF, detecta contenido generado por IA, revisa el historial de ediciones y verifica la autenticidad.
Documentación
Servidor PDFCheck MCP
Inspecciona los metadatos de PDF y accede a tu historial de análisis desde un asistente que admita el servidor HTTP remoto o el puente MCP local.
Configuración rápida
✓ Token aplicado: todas las configuraciones a continuación están actualizadas. Pega tu token y todos los ejemplos de configuración se completarán automáticamente.
No se necesita cuenta para 10 análisis de metadatos por día por IP. Conéctate usando la URL remota o el script local. Mantén los resultados anónimos en tu cliente; no se pueden recuperar más tarde.
¿Qué es el Protocolo de Contexto de Modelo?
El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los asistentes de IA conectarse a herramientas externas y fuentes de datos. Piénsalo como un enchufe universal que permite a tu asistente de IA hablar con servicios como PDFCheck, directamente desde tu ventana de chat.
Lenguaje natural
Pídele a tu asistente que inspeccione un PDF. Los clientes remotos necesitan herramientas de lectura de archivos y codificación en base64; el puente local lee el archivo desde su ruta.
Seguro
Guarda tu token en la configuración del cliente o en variables de entorno; se envía a PDFCheck para autenticación. Las cargas originales del verificador se eliminan después del procesamiento; los metadatos de resultados siguen nuestra Política de Privacidad.
Elige tu transporte
Usa un cliente que admita MCP HTTP remoto con encabezados bearer, o un cliente que pueda ejecutar el puente stdio local. Este setup no admite conexiones exclusivas OAuth.
Cómo funciona: El servidor HTTP remoto recibe contenidos de PDF codificados en base64 desde tu cliente. El puente local opcional lee un PDF desde tu máquina y lo sube a la API REST. Ambos devuelven el análisis de metadatos como JSON dentro de content[0].text.
Requisitos previos
1
Crear una cuenta gratuita de PDFCheck Opcional
Una cuenta es opcional para 10 análisis de metadatos por día por IP. Una cuenta gratuita con token de API tiene 100 verificaciones por día y acceso a sus análisis guardados.
2
Generar un token de API Opcional
Para límites más altos, ve a la configuración de tu cuenta y crea un token de API. Pégalo en la Configuración rápida anterior y todas las configuraciones se completarán automáticamente.
3
Solo puente local: instalar Node.js
El script local opcional necesita Node.js 18 o posterior. Las conexiones HTTP remotas no requieren Node.js ni un script descargado.
Herramientas MCP disponibles
Estas herramientas MCP cubren el análisis de metadatos y el historial de cuenta. La compresión, validación estructural, firma y otras herramientas del navegador no están expuestas por estos métodos.
analyze_pdf
POST
Inspecciona metadatos, fechas, campos de software y número de páginas. La herramienta remota toma file_base64 y filename; el puente local toma filePath. Los metadatos no prueban autenticidad ni autoría de IA.
get_analysis
GET
Usa el data.id devuelto como token para recuperar el análisis de tu cuenta o un resultado público. El servidor remoto permite recuperar resultados públicos de forma anónima; el puente local requiere un token. Los nuevos análisis anónimos son privados y no se pueden recuperar más tarde.
list_analyses
GET
Requiere un token de API. El servidor remoto devuelve hasta 50 análisis recientes de la cuenta; el puente local devuelve la primera página REST. Las entradas incluyen nombres de archivo, fechas e IDs de análisis.
check_usage
GET
Comprueba el límite diario restante de metadatos. HTTP remoto admite uso anónimo; los detalles de cuenta y el puente local requieren un token de API.
Guía de configuración
Elige HTTP remoto para un cliente compatible, o el script local para una conexión stdio. HTTP remoto no requiere descargas. Consulta la documentación de tu cliente antes de usar un ejemplo de configuración.
No hay archivos que descargar ni instalar
Solo añade la URL a la configuración de tu herramienta de IA. El servidor MCP se ejecuta en nuestra infraestructura: sin Node.js, sin npm install, sin scripts locales.
C
Claude Desktop
Abre Configuración → Desarrollador → Editar configuración y añade lo siguiente a tu claude_desktop_config.json:
GitHub Copilot
VS Code
Añade una configuración de servidor MCP a la configuración de VS Code. Crea o edita .vscode/mcp.json en tu proyecto, o añádela a tu configuración global:
También puedes configurarlo en tu settings.json global de VS Code bajo "mcp.servers". GitHub Copilot detectará las herramientas MCP automáticamente en modo agente.
⌘
Cursor
Ve a Configuración de Cursor → MCP y añade un nuevo servidor MCP global, o crea .cursor/mcp.json en tu proyecto:
W
Windsurf
Abre Configuración de Windsurf → MCP y añade un nuevo servidor, o edita tu mcp_config.json:
Introduce la ruta completa donde guardaste el script. Los fragmentos de configuración a continuación se actualizarán automáticamente.
C
Claude Desktop
Abre Configuración → Desarrollador → Editar configuración y añade lo siguiente a tu claude_desktop_config.json:
Actualiza la ruta anterior para que coincida con dónde guardaste pdfcheck-mcp-server.mjs en tu máquina. La configuración se actualizará automáticamente. Reemplaza your-api-token-here con tu token de API real (obtén uno desde la página de Tokens de API).
GitHub Copilot
VS Code
Añade una configuración de servidor MCP a la configuración de VS Code. Crea o edita .vscode/mcp.json en tu proyecto, o añádela a tu configuración global:
También puedes configurarlo en tu settings.json global de VS Code bajo "mcp.servers". GitHub Copilot detectará las herramientas MCP automáticamente en modo agente.
⌘
Cursor
Ve a Configuración de Cursor → MCP y añade un nuevo servidor MCP global, o crea .cursor/mcp.json en tu proyecto:
W
Windsurf
Abre Configuración de Windsurf → MCP y añade un nuevo servidor, o edita tu mcp_config.json:
Script del servidor MCP
Guarda el siguiente archivo como pdfcheck-mcp-server.mjs en cualquier lugar de tu máquina. Este script ligero conecta tu herramienta de IA con la API de PDFCheck.
Configuración única: Antes de usar el script, instala la dependencia del SDK de MCP: npm install @modelcontextprotocol/sdk
Consejo: El script no tiene archivos de configuración ni paso de compilación. Guárdalo, instala el SDK y apunta tu cliente MCP a él. ¡Eso es todo!
Ejemplos de uso
Después de conectarte, usa estos prompts con un cliente que pueda leer los archivos solicitados. analyze_pdf remoto necesita file_base64 y filename; una ruta local por sí sola no es suficiente. El puente local acepta filePath.
Ejemplo 1 Analizar un PDF
"Analiza el archivo /Users/me/Documents/contract.pdf y dime cuándo se creó y qué software se usó."
Ejemplo 2 Inspeccionar indicadores de software
"Inspecciona los campos de creador y productor en /Users/me/Downloads/report.pdf. Explica los indicadores de software sin tratarlos como prueba de autoría de IA."
Ejemplo 3 Análisis por lotes
"Analiza los PDF que seleccione de mi carpeta de Descargas uno a la vez. Compara sus fechas de creación y modificación reportadas, y explica los metadatos faltantes o inconsistentes."
Ejemplo 4 Comprobar cuota
"¿Cuántas verificaciones de PDF me quedan hoy en PDFCheck?"
Preguntas frecuentes
¿Necesito un token de API?
El acceso anónimo permite 10 análisis de metadatos por día por IP. Una cuenta gratuita con token de API tiene 100 verificaciones por día. Usa el token al analizar si quieres recuperar el resultado a través de tu cuenta más tarde.
¿El servidor MCP es gratuito?
El análisis de metadatos está disponible gratis: 10 verificaciones por día por IP de forma anónima, o 100 verificaciones por día con un token de cuenta gratuita. Las cuentas de pago usan sus asignaciones del plan.
¿Se almacenan mis archivos PDF en sus servidores?
La API no conserva la carga original del verificador después de la solicitud. Los metadatos extraídos y los registros de resultados se conservan según el estado de tu cuenta y nuestra Política de Privacidad.
¿El servidor MCP envía mis archivos a un tercero?
El PDF se envía a PDFCheck a través de HTTPS. Tu cliente MCP o proveedor de IA también puede manejar el archivo o los argumentos de la herramienta, según su diseño. Revisa su política de datos y la Política de Privacidad de PDFCheck antes de enviar documentos sensibles.
¿Qué pasa si mi herramienta de IA no aparece aquí?
Comprueba si tu cliente admite MCP HTTP remoto con encabezados bearer o puede ejecutar un servidor stdio local usando command y args. Los formatos de configuración varían. Este setup no admite conexiones remotas exclusivas OAuth.
¿Cuál es el tamaño máximo de archivo PDF?
Gratis: hasta 50 MB por PDF. Pro y AI: hasta 100 MB por PDF.
¿Puedo usar esto con mi propia instancia autohospedada de PDFCheck?
Sí. Cambia la constante API_BASE en el script del servidor para apuntar a la URL de tu propia instancia.
¿Listo para conectar tus herramientas de IA?
Crea una cuenta gratuita, obtén tu token de API y comienza a analizar PDFs desde tu asistente de IA favorito en minutos.