Saltar al contenido principal
Model Context Protocol

Servidor MCP de PDFCheck

Analiza, valida y optimiza archivos PDF directamente desde tus herramientas de IA favoritas — Claude Desktop, GitHub Copilot, Cursor y más.

Configuración rápida

No se necesita cuenta — obtienes 10 análisis PDF gratuitos al día. Solo guarda el script y configura tu herramienta de IA.

¿Qué es el Model Context Protocol?

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA conectarse a herramientas externas y fuentes de datos. Piensa en ello como un enchufe universal que permite a tu asistente de IA comunicarse con servicios como PDFCheck — directamente desde tu ventana de chat.

Lenguaje natural

Solo pide a tu IA que "analice este PDF" y se encarga del resto — sin necesidad de llamadas API manuales.

Seguro

Tu token API permanece local en tu máquina. Los archivos se procesan y se descartan inmediatamente.

Funciona en todas partes

Compatible con Claude Desktop, GitHub Copilot, Cursor, Windsurf y cualquier cliente compatible con MCP.

Cómo funciona: El servidor MCP se ejecuta localmente en tu máquina como un puente ligero entre tu asistente de IA y la API de PDFCheck. Cuando pides a tu IA que analice un PDF, llama al servidor MCP local, que reenvía la solicitud de forma segura a nuestra API y devuelve los resultados.

Requisitos previos

1

Crear una cuenta gratuita en PDFCheck Opcional

Opcional — obtienes 10 análisis gratuitos al día sin cuenta. Regístrate para desbloquear 50 análisis al día.

Crear cuenta gratuita
2

Generar un token API Opcional

Para límites más altos, ve a la configuración de tu cuenta y crea un token API. Pégalo en la Configuración rápida de arriba y todas las configuraciones se actualizarán automáticamente.

Administrar tokens API
3

Instalar Node.js (v18+)

El script del servidor MCP requiere Node.js 18 o posterior. Descárgalo de nodejs.org si no lo tienes instalado.

Herramientas MCP disponibles

Una vez conectado, tu asistente de IA obtiene acceso a las siguientes herramientas PDF:

analyze_pdf

POST

Sube y analiza un archivo PDF. Devuelve metadatos, fecha de creación, autor, software utilizado, número de páginas y estado de verificación.

get_analysis

GET

Recupera un análisis PDF anterior por su token de compartición. Útil para revisitar o comparar resultados.

list_analyses

GET

Lista todos tus análisis PDF anteriores. Devuelve una lista paginada con nombres de archivo, fechas y tokens de compartición.

check_usage

GET

Consulta la información de tu cuenta y la cuota diaria de API restante. Devuelve tu nombre, correo electrónico y cuántos análisis te quedan hoy.

Guía de configuración

Elige tu método de configuración. La URL remota es la más fácil — sin archivos que descargar ni instalar.

Sin 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, luego añade lo siguiente a tu claude_desktop_config.json:

claude_desktop_config.json

GitHub Copilot

VS Code

Añade una configuración de servidor MCP a tus ajustes de VS Code. Crea o edita .vscode/mcp.json en tu proyecto, o añádelo a tus ajustes globales:

.vscode/mcp.json

También puedes configurar esto en tus ajustes globales de VS Code settings.json bajo "mcp.servers". GitHub Copilot detectará automáticamente las herramientas MCP 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:

.cursor/mcp.json
W

Windsurf

Abre Configuración de Windsurf → MCP y añade un nuevo servidor, o edita tu mcp_config.json:

~/.codeium/windsurf/mcp_config.json

Introduce la ruta completa donde guardaste el script. Los fragmentos de configuración se actualizarán automáticamente.

C

Claude Desktop

Abre Configuración → Desarrollador → Editar configuración, luego añade lo siguiente a tu claude_desktop_config.json:

claude_desktop_config.json

Actualiza la ruta de arriba para que coincida con donde guardaste pdfcheck-mcp-server.mjs en tu máquina. La configuración se actualizará automáticamente. Reemplaza your-api-token-here con tu token API real (obtén uno en la página de tokens API).

GitHub Copilot

VS Code

Añade una configuración de servidor MCP a tus ajustes de VS Code. Crea o edita .vscode/mcp.json en tu proyecto, o añádelo a tus ajustes globales:

.vscode/mcp.json

También puedes configurar esto en tus ajustes globales de VS Code settings.json bajo "mcp.servers". GitHub Copilot detectará automáticamente las herramientas MCP 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:

.cursor/mcp.json
W

Windsurf

Abre Configuración de Windsurf → MCP y añade un nuevo servidor, o edita tu mcp_config.json:

~/.codeium/windsurf/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
pdfcheck-mcp-server.mjs
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

Una vez conectado, puedes usar lenguaje natural para interactuar con PDFCheck. Aquí tienes algunas cosas que puedes pedirle a tu asistente de IA:

Ejemplo 1 Analizar un PDF

"Analiza el archivo /Users/me/Documents/contract.pdf y dime cuándo fue creado y qué software se utilizó."

Ejemplo 2 Verificar generación por IA

"Comprueba si este PDF parece haber sido generado por IA: /Users/me/Downloads/report.pdf"

Ejemplo 3 Análisis por lotes

"Analiza todos los PDFs en mi carpeta de Descargas y lista cuáles han sido modificados después de su creación."

Ejemplo 4 Verificar cuota

"¿Cuántas verificaciones de PDF me quedan hoy en PDFCheck?"

Preguntas frecuentes

¿Necesito un token API?

¡No! Puedes usar el servidor MCP sin un token API y obtener 10 análisis PDF gratuitos al día. Para 50 análisis al día, crea una cuenta gratuita y genera un token API.

¿Es gratuito el servidor MCP?

¡Sí! El servidor MCP es completamente gratuito. Sin cuenta obtienes 10 análisis gratuitos al día. Registra una cuenta gratuita para obtener 50 análisis al día.

¿Se almacenan mis archivos PDF en sus servidores?

No. Los PDFs se procesan en memoria y se descartan inmediatamente después del análisis. Solo los metadatos extraídos se almacenan en el historial de tu cuenta.

¿Envía el servidor MCP mis archivos a terceros?

El servidor MCP solo se comunica con pdf.businesspress.io. Tus archivos van directamente desde tu máquina a nuestra API por HTTPS. No se envían datos a tu proveedor de IA — solo ven los resultados en texto.

¿Qué pasa si mi herramienta de IA no aparece aquí?

Cualquier herramienta que soporte el Model Context Protocol debería funcionar. El servidor usa el transporte stdio estándar. Consulta la documentación de tu herramienta para saber cómo añadir un servidor MCP usando el formato "command" + "args".

¿Cuál es el tamaño máximo de archivo PDF?

La API acepta archivos PDF de hasta 100 MB.

¿Puedo usar esto con mi propia instancia autohospedada de PDFCheck?

Sí. Cambia la constante API_BASE en el script del servidor para que apunte a la URL de tu propia instancia.

¿Listo para conectar tus herramientas de IA?

Crea una cuenta gratuita, obtén tu token API y comienza a analizar PDFs desde tu asistente de IA favorito en minutos.