Servidor MCP: usa Documentize dentro de Claude, Cursor y VS Code
Abrir la aplicación: Conecta el servidor MCP → (products.documentize.ai)
En resumen
El servidor MCP de Documentize permite que un asistente de IA llame a las mismas operaciones de documentos que las aplicaciones web. Tú dices «comprime esto y hazme un resumen»; el asistente llama a las herramientas, espera a las tareas y te entrega los enlaces de descarga. Página: products.documentize.ai/pdf-mcp.
Punto de conexión e identidad
- Punto de conexión HTTP en streaming (Streamable HTTP):
https://api.documentize.app/mcp. El servidor mantiene estado: devuelve una cabeceraMcp-Session-Idtrasinitialize; los clientes MCP se encargan de esto por ti. - El acceso anónimo funciona sin configuración, con una cuota diaria minúscula (documentada como 2 operaciones en el repositorio; comprueba el valor actual).
- Los usuarios registrados tienen una cuota mayor (5 al día en las cuentas gratuitas, según la documentación; compruébalo), los suscriptores la cuota de pago, igual que en el sitio web.
- Para que te reconozcan, crea una clave de larga duración en la página de MCP (empieza por
dmk_, se muestra una sola vez y se guarda únicamente como hash). Envíala comoAuthorization: Bearer dmk_.... - Los clientes que implementan la autorización MCP pueden usar OAuth en lugar de una clave.
Una operación es una llamada de procesamiento, sea cual sea el número de archivos. La consulta de estado y las herramientas de cuenta son gratuitas.
Configuración del cliente
Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"documentize": {
"type": "http",
"url": "https://api.documentize.app/mcp",
"headers": { "Authorization": "Bearer dmk_your_key_here" }
}
}
}
VS Code (GitHub Copilot, modo Agent), .vscode/mcp.json:
{
"servers": {
"documentize": {
"type": "http",
"url": "https://api.documentize.app/mcp",
"headers": { "Authorization": "Bearer dmk_your_key_here" }
}
}
}
Reinicia el cliente; las herramientas aparecen en su lista de herramientas. Quita el bloque headers para conectarte de forma anónima. Cursor y otros clientes usan sus propios ajustes de MCP con la misma URL y la misma cabecera (consulta la página de MCP).
Las herramientas
Nombres tal como los registra el servidor (tools.json):
- Convertir y organizar: ConvertDocument, MergeDocuments, SplitDocument, CompressDocument, RotateDocument, ResizeDocument, RemovePages
- Seguridad: LockDocument, UnlockDocument, SignDocument, VerifySignature
- Extraer y buscar: ExtractText, ExtractImages, ExtractMetadata, ExtractFormData, ParseDocument, SearchInDocument
- OCR y acabado: MakeSearchable, RunOcr, FlattenDocument, AddTable, AddToc, AddIllustrations
- IA: GenerateTableOfContents, GenerateAbstract, GenerateChecklist, AnalyzeResume, ChatWithDocument, GenerateSvg
- Lotes: ProcessBatch, WaitForTasks, ListBatchOperations
- Cuenta: GetAccountStatus, GetSignInInstructions, SignOut
- Flujo: GetTaskStatus, GetNextAppSuggestions
Cada herramienta de procesamiento devuelve de inmediato un id de tarea; el resultado llega después, mediante GetTaskStatus (una tarea) o WaitForTasks (varias).
Una conversación de ejemplo
Tú: Aquí tienes tres escaneos (URL). Hazme con ellos un único PDF con búsqueda, quita la primera página y redúcelo.
Asistente: llama a MergeDocuments con las tres URL y luego a GetTaskStatus hasta que termina. Unidos. Llama a MakeSearchable con la URL del resultado. Llama a RemovePages (página 1) y después a CompressDocument. Aquí tienes el enlace de descarga final. Se han ahorrado unos N MB (el asistente indica la cifra real).
El patrón: el enlace de descarga de cada paso pasa a ser la entrada del siguiente. A partir de 20 archivos, el asistente debería usar ProcessBatch (una operación aplicada a hasta 200 archivos por llamada, en paralelo en el servidor) seguida de WaitForTasks, que devuelve todos los enlaces en una sola llamada. La espera tiene un límite de unos minutos; vuelve a llamarla con los ids que sigan pendientes.
Cuando algo se rechaza
Los rechazos están escritos para un modelo: un código de error estable y un siguiente paso. quota_exceeded significa que se agotó la cuota de hoy; credential_rejected significa que la clave está revocada o mal escrita (sustitúyela, no reintentes); auth_required significa que se ha gastado la cuota anónima. Pide al asistente que ejecute GetAccountStatus para ver el nivel y las operaciones restantes.
Precauciones
- Los archivos viajan a la nube; usa el autoalojamiento para material confidencial.
- El cliente descubre los parámetros exactos de las herramientas a partir del servidor; no los adivines, pídele al asistente que los enumere (ListBatchOperations para las de lotes).