A GroupDocs MCP server permite que Claude Desktop, Claude Code, Cursor, GitHub Copilot y otros clientes MCP trabajen con sus documentos localmente: el cliente inicia el servidor como un proceso hijo en su propia máquina, y los archivos se leen y escriben en las carpetas que elija. La arquitectura completa y el modelo de seguridad están documentados en la página on‑premise de cada producto, por ejemplo Running GroupDocs MCP servers on-premise: architecture and security model. Esta publicación compara las tres formas comunes de conectar un agente de IA a documentos y explica qué sale y qué no sale de la máquina.

¿Qué arquitecturas pueden conectar un agente de IA a documentos?

Hay tres. Diferencian en la pregunta que primero hace un revisor de seguridad: ¿dónde va el documento?

Carga en la nube API alojada Servidor MCP local
Cómo funciona El asistente o un complemento sube el archivo a un servicio del proveedor Su código o agente llama a una API REST del proveedor con el archivo El cliente de IA inicia un proceso de servidor en su máquina
Dónde va el documento Una nube de terceros Una nube de terceros o su propio inquilino Ningún lado: se lee y escribe en carpetas locales
Superficie de red Salida al proveedor Salida al proveedor solo stdio; ninguno con un archivo de licencia, solo informes de uso (sin contenido del documento) con licencia medida
Puertos de entrada No aplicable No aplicable Ninguno
Uso aislado No posible Generalmente no; depende de las opciones de despliegue del proveedor Posible con un archivo de licencia
Quién lo ejecuta El proveedor El proveedor Usted, como parte del cliente de IA

La tercera columna es lo que implementan los servidores GroupDocs MCP. El resto de esta publicación cubre cómo funciona y dónde están sus límites.

¿Cómo es el flujo de datos de un servidor MCP local?

El cliente de IA lanza el servidor como un proceso hijo y se comunica con él a través de la entrada y salida estándar usando JSON‑RPC. El servidor nunca escucha en un puerto de red, y con un archivo de licencia no realiza conexiones salientes tampoco.

+--------------+          +--------------------+         +------------------+
|  AI client   |  stdio   | MCP server process | reads / | local filesystem |
| (Claude,     | <------> | (GroupDocs engine) | <-----> | storage / output |
|  Cursor, ..) | JSON-RPC |   child process    |  writes |     folders      |
+--------------+          +--------------------+         +------------------+
       |
       | prompts and quoted fragments only
       v
+--------------------+
|   model provider   |  (cloud, or a local model inside your network)
+--------------------+

Un revisor de seguridad obtiene cuatro afirmaciones verificables:

  • Transporte: entrada y salida estándar a un proceso hijo. No hay nada que firewall ni nada que exponer.
  • Puertos de entrada: ninguno.
  • Telemetría: ninguna. El motor de documentos se ejecuta en proceso.
  • Uso de red: solo en el momento de la instalación, para obtener el paquete de nuget.org o la imagen de ghcr.io. En tiempo de ejecución el servidor no realiza llamadas salientes, con una excepción de licencia descrita a continuación.

Puede verificar esto en lugar de confiar en ello: ejecute una tarea y observe los sockets de escucha y las conexiones salientes.

¿Qué sale de la máquina cuando un agente procesa un documento?

Los documentos no salen de la máquina. Los prompts y fragmentos citados sí.

El modelo detrás de su cliente de IA ve la conversación. Si el modelo está alojado en la nube, su texto de instrucción llega al proveedor del modelo, y también lo hace cualquier fragmento que el agente le devuelva. Dos ejemplos:

  • Después de una comparación, un agente informa que un término de pago cambió de 30 a 45 días. Esa frase forma parte de la conversación y viaja al proveedor.
  • Después de una extracción, un agente informa el total de una factura. El archivo no se movió, pero ese valor sí.

Un hábito útil es formular los prompts de modo que la respuesta contenga menos contenido, por ejemplo preguntar qué archivos tienen un total por encima de un umbral en lugar de pedir los totales. Para corpora sensibles, combine el servidor con un modelo alojado localmente. Entonces todo el bucle (cliente, modelo, servidor, archivos) permanece dentro de su red.

¿Necesita un servidor local acceso a internet?

No para el procesamiento. Depende del modo de licencia:

  • Archivo de licencia: leído del disco local por el proceso local. Funciona completamente sin conexión y es la opción correcta para redes aisladas.
  • Medido (pago por uso): el servidor informa uso a GroupDocs, por lo que necesita salida. El informe no contiene contenido del documento, pero la conexión debe ser permitida por su firewall.

Si se configuran tanto claves medidas como un archivo de licencia, las claves medidas tienen prioridad. Mantenga las claves en variables de entorno en lugar de en la configuración comprometida. La página de licencias de cada producto describe la configuración, y la herramienta get_license_status informa el modo activo.

¿Cómo ejecutar el servidor dentro del perímetro con Docker?

La imagen Docker suele ser la opción más fácil para un equipo de plataforma: una imagen con las dependencias nativas, sin SDK en el host, y un límite restringido a las carpetas que monte. Cada producto tiene su propia imagen, nombrada ghcr.io/groupdocs-<product>/<product>-net-mcp. El comando a continuación muestra la forma para un producto; reemplace los marcadores de posición.

docker run --rm -i \
  -v /srv/documents:/data \
  -v /srv/licenses:/license:ro \
  -e GROUPDOCS_MCP_STORAGE_PATH=/data \
  -e GROUPDOCS_LICENSE_PATH=/license/GroupDocs.<Product>.lic \
  ghcr.io/groupdocs-<product>/<product>-net-mcp:<tag>
  • Fije la etiqueta. Los comandos de inicio rápido usan :latest; para producción, fije la etiqueta a la versión que probó para que una reconstrucción no pueda cambiar el comportamiento durante un flujo de trabajo en ejecución.
  • Monte deliberadamente. El contenedor ve solo las carpetas que le asigne, lo que es una frontera más estricta que un proceso que se ejecuta como su usuario.
  • Monte la licencia solo lectura.
  • Segmentos aislados: pre‑descargue la imagen, o pre‑cache el paquete NuGet, y fije la versión.

Su cliente de IA ejecuta este comando docker run como el comando del servidor en su configuración MCP, de modo que el contenedor es el proceso hijo en el diagrama anterior. La documentación describe las imágenes como multi‑arch (linux/amd64 y linux/arm64).

¿Es un servidor MCP local adecuado para industrias reguladas?

Elimina la mayor pregunta en una revisión de privacidad, que es la transferencia de documentos a un procesador externo. Los equipos en entornos legales, financieros, de salud y del sector público cuya política prohíbe subir documentos pueden usarlo como bloque de construcción para flujos de trabajo orientados a HIPAA o GDPR. Esto describe solo la idoneidad arquitectónica. Los servidores GroupDocs MCP no están certificados para ninguna regulación, y sus obligaciones siguen dependiendo del modelo con el que los combine, su modo de licencia y sus propios controles.

¿Cuáles son los límites de este modelo?

  • Un servidor sirve a un proceso cliente. Un servidor stdio es iniciado por un cliente en una máquina. No es un servicio multi‑usuario. Para un servicio compartido, coloque su propio servicio frente a la biblioteca GroupDocs en lugar de ejecutar muchos servidores MCP.
  • La licencia medida necesita salida. Los informes de uso se envían, como se describió arriba. Elija un archivo de licencia si la red debe estar cerrada.
  • Los prompts aún llegan al proveedor del modelo a menos que use un modelo alojado localmente.
  • El modo de evaluación tiene límites. Sin una licencia, los servidores se ejecutan en modo de evaluación con restricciones específicas del producto. Por ejemplo, el servidor Comparison compara solo las primeras 2 páginas y marca el resultado con una marca de agua. Llame a get_license_status primero y lea la página de licencias de su producto.
  • Parser y Search solo se distribuyen como imágenes Docker. GroupDocs.Parser.Mcp y GroupDocs.Search.Mcp no tienen paquete NuGet, por lo que la ruta Docker anterior es la única para esos productos. En un host Linux, ejecute sus contenedores con --user "$(id -u):$(id -g)" para que puedan escribir en las carpetas que monte.
  • Excepciones de plataforma. Actualmente dos operaciones específicas de PDF fallan en Linux, incluida la imagen Docker, porque el manejo de imágenes del motor PDF depende de System.Drawing.Common, que .NET solo soporta en Windows: GroupDocs.Annotation.Mcp generate_pages_preview en archivos PDF (los documentos Word se renderizan), y GroupDocs.Redaction.Mcp redact_image_area y erase_metadata en archivos PDF (redact_text en PDF, y los tres en documentos Word, funcionan). Ejecute esos en Windows con dnx; vea las publicaciones del producto.

Preguntas frecuentes

¿Es MCP seguro para documentos sensibles?
Con un servidor GroupDocs MCP los documentos se procesan en proceso en su máquina mediante stdio, sin puertos de escucha y sin telemetría. Lo que queda por evaluar es el modelo que usa su cliente de IA, porque los prompts y fragmentos citados van allí.

¿Puedo ejecutar herramientas Claude sin enviar datos a la nube?
Los documentos permanecen locales de cualquier manera. Para mantener también los prompts locales, use un cliente que admita un modelo alojado localmente, de modo que ninguna parte de la conversación salga de su red.

¿Qué datos envía un servidor MCP?
En tiempo de ejecución un servidor GroupDocs MCP no envía nada por la red cuando se usa un archivo de licencia. Con licencia medida envía informes de uso a GroupDocs, nunca contenido del documento.

Por producto: páginas on‑premise en la documentación

Cada página cubre la misma arquitectura con los comandos para ese producto. Estas son las referencias canónicas para una revisión de seguridad.

Por producto: por dónde empezar en el blog

Cada producto tiene una serie de publicaciones — cuatro para la mayoría, seis para Search. La primera explica el patrón; las demás lo aplican.