Un agente de IA debe elegir qué archivo convertir y a qué formato convertirlo, y un motor de conversión debe realizar la conversión. Con el servidor GroupDocs.Conversion.Mcp, Claude, Cursor o GitHub Copilot llaman a ese motor localmente, en tu máquina, con una sola frase:

Convert contract.docx to PDF

La versión paso a paso con configuración y solución de problemas está en la documentación: Cómo convertir documentos con agentes de IA usando MCP. Este artículo explica por qué la división es importante y dónde debe mantenerse fuera del camino el agente.

¿Qué sale mal cuando un agente convierte un archivo por sí mismo?

Un modelo de lenguaje que “convierte” un PDF a Word no convierte nada. Lee el contenido que se le proporciona y escribe nuevo contenido en el formato de destino. Lo que el modelo no vio, no puede reproducir: la fuente exacta, la geometría de columnas, el salto de página antes de una tabla, los nombres de estilo de los que depende una plantilla de Word. Lo que regresa parece una conversión pero es una reescritura.

Ese es el modo de falla del que trata este artículo. Es silencioso: la salida se abre sin errores, por lo que nadie la verifica hasta que una tabla se haya desplazado o un encabezado haya perdido su estilo. La fidelidad del renderizado es trabajo determinista del motor, no trabajo de generación.

¿Qué debe decidir el agente y qué debe hacer el motor?

Divida el trabajo a lo largo de la línea entre el juicio y la ejecución.

Pregunta Decide el agente Hace el motor
¿Qué archivos están dentro del alcance? Lee tu prompt y la carpeta de almacenamiento Nada
¿A qué formato de destino? Mapea “hazlo editable” a DOCX, “archívalo” a PDF Nada
¿Es el archivo siquiera convertible? Llama a get_supported_formats y lee la respuesta Informa los formatos de destino válidos
¿Qué tan grande es el archivo? Llama a get_document_info y lee el recuento de páginas Lee tipo, recuento de páginas, propiedades
La conversión propiamente dicha Llama a convert Renderiza la salida con el motor GroupDocs.Conversion
¿Qué hacer ante un fallo? Reintenta, te pregunta o omite el archivo Devuelve la razón como texto

El agente nunca toca los bytes de tu documento. Pasa un nombre de archivo y un formato, y el motor devuelve un archivo.

¿Cómo conectar un agente al motor localmente?

Registra el servidor una sola vez en tu cliente. Claude Desktop usa claude_desktop_config.json, Claude Code usa claude mcp add, VS Code con GitHub Copilot usa mcp.json, y Cursor usa ~/.cursor/mcp.json. El servidor también es compatible con Visual Studio 2022, Windsurf, Cline, Codex CLI y JetBrains Rider. Una entrada de Claude Desktop se ve así:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
    }
  }
}

dnx necesita el SDK .NET 10. Si prefieres Docker, la imagen autocontenida es ghcr.io/groupdocs-conversion/conversion-net-mcp:latest, ejecútala con docker run --rm -i -v $(pwd)/documents:/data. El cliente se comunica con el servidor a través de stdio: la ruta es agente → servidor local → sistema de archivos local. Reinicia el cliente después de registrar.

¿Qué herramienta se activa con cada solicitud?

El servidor expone cuatro herramientas. Sus nombres son literales; los agentes los buscan cuando algo falla.

  • convert convierte un documento a otro formato y guarda el resultado en tu almacenamiento o carpeta de salida. Acepta file, format (por ejemplo pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) y un password opcional.
  • get_supported_formats enumera los formatos de destino a los que puede convertirse un archivo fuente dado.
  • get_document_info devuelve el tipo de archivo, el recuento de páginas y propiedades básicas sin convertir.
  • get_license_status informa si el servidor se ejecuta en modo de evaluación, con archivo de licencia o en modo medido.

Los prompts abiertos funcionan porque el agente los encadena:

¿A qué formatos puedo convertir este archivo Visio? Luego conviértelo a PDF.

Primero verifica el recuento de páginas de whitepaper.pdf, luego conviértelo a DOCX.

Los archivos existentes nunca se sobrescriben. Una segunda conversión del mismo archivo recibe un nombre distinto, como report (1).pdf.

Sesión de ejemplo

Esta es una sesión abreviada e ilustrativa construida a partir de las descripciones de herramientas en la documentación, no una captura de pantalla.

You:    Convert contract-draft.pdf to DOCX so I can edit it.
Agent:  [calls convert with file.filePath = "contract-draft.pdf", format = "docx"]
Agent:  Done. The converted file is saved as contract-draft.docx in your output folder.

Para el flujo completo, el tutorial de n8n muestra el mismo motor impulsado por un workflow en lugar de un chat, y el anuncio cubre el servidor en general.

¿Cuáles son los límites?

  • Modo de evaluación. Sin una licencia, el servidor añade una marca de agua de evaluación al output convertido y limita cada proceso del servidor a 15 documentos abiertos; reiniciar el servidor restablece el conteo. Pregunta a tu agente “¿cuál es el estado de la licencia del servidor de conversión?” primero; get_license_status responde sin procesar un documento.
  • Sin OCR. El servidor convierte documentos que tienen una capa de texto. Un escaneo guardado como PDF solo de imágenes no se convertirá en texto editable.
  • Conversión, no extracción. Este servidor transforma documentos completos. Para extracción de datos a nivel de campo, el servidor complementario GroupDocs.Parser.Mcp (disponible solo como imagen Docker) es la mejor opción, y muchas canalizaciones usan ambos.

Preguntas frecuentes

¿Puede Claude convertir un docx a pdf?
Sí, con un servidor de conversión adjunto. Claude llama a convert con format: "pdf", y el motor GroupDocs produce el archivo en tu máquina.

¿Se suben mis archivos cuando un agente los convierte?
No con este servidor. Se ejecuta localmente sobre stdio, y los documentos permanecen en tu carpeta de almacenamiento. Tu archivo de licencia también se lee desde el disco local.

¿Qué formatos puede convertir el servidor?
Más de 100 formatos de documentos, hojas de cálculo, presentaciones, imágenes, correos electrónicos, CAD y web, el mismo conjunto que la biblioteca .NET GroupDocs.Conversion. Pregunta get_supported_formats para obtener la lista exacta para un archivo dado.

Profundizar