Servidor MCP de ONLYOFFICE DocSpace

Model Context Protocol (MCP) es un protocolo estandarizado para gestionar el contexto entre modelos de lenguaje grandes (LLMs) y sistemas externos. Este repositorio proporciona un servidor MCP para ONLYOFFICE DocSpace.

El servidor MCP de DocSpace conecta herramientas de IA directamente a ONLYOFFICE DocSpace. Esto brinda a los agentes de IA, asistentes y chatbots la capacidad de gestionar salas, colaborar en archivos, manejar permisos y automatizar flujos de trabajo documentales, todo a través de interacciones en lenguaje natural.

Características

• Herramientas con control granular - Acceso a herramientas organizadas en conjuntos lógicos con capacidades de habilitación/deshabilitación detalladas y metaherramientas.

• Múltiples protocolos de transporte - Soporte para transportes stdio, SSE y HTTP transmitible (Streamable HTTP).

• Diferentes métodos de autenticación - Admite claves de API, tokens de acceso personal, autenticación básica y OAuth 2.0 con registro dinámico de clientes. Consulta los ejemplos.

• Configuración a nivel de solicitud - Configura la autenticación y la selección de herramientas durante la inicialización de la sesión utilizando encabezados HTTP personalizados.

• Varios formatos de distribución - Disponible como imagen de Docker, servidor MCP de Docker, paquete MCP y aplicación de Node.js.

Related MCP server: LibreOffice MCP Tools

Casos de uso

• Gestión de salas: Crear, actualizar y archivar salas. Configurar tipos de sala, gestionar miembros y controlar niveles de acceso.

• Operaciones con carpetas y archivos: Crear carpetas, subir documentos, copiar o mover elementos por lotes, renombrar o eliminar contenido y verificar detalles de archivos o carpetas.

• Colaboración y permisos: Invitar o eliminar usuarios, ajustar configuraciones de seguridad y revisar los derechos de acceso actuales para salas y espacios compartidos.

• Acceso al contenido: Recuperar carpetas de "Mis documentos" o "Salas", obtener el contenido de carpetas, descargar archivos como texto y monitorear operaciones de archivos en curso.

• Directorio de personas: Listar a todas las personas en el portal para agilizar las invitaciones y la gestión de acceso.

Conexión de clientes al servidor MCP de DocSpace

Puedes conectarte al servidor MCP de DocSpace utilizando cualquier cliente MCP. Hemos cubierto algunos clientes populares, como Claude Desktop, Cursor, Windsurf, etc., y aquí puedes leer sobre ello.

Servidor MCP de DocSpace remoto

El servidor MCP de DocSpace remoto está alojado por ONLYOFFICE y proporciona la forma más rápida de comenzar a usar las herramientas de DocSpace dentro de tu agente de IA. Puedes conectarte a él al instante sin implementar ni configurar nada en tu máquina.

La instancia pública está disponible en https://mcp.onlyoffice.com/mcp para clientes que admiten el transporte HTTP transmitible moderno y en https://mcp.onlyoffice.com/sse para clientes que solo admiten el transporte SSE heredado. Es preferible utilizar el transporte HTTP transmitible siempre que sea posible.

Consulta todas las opciones para conectar clientes al servidor MCP de DocSpace remoto aquí.

Servidor MCP de DocSpace local

Si tu host MCP no admite servidores MCP remotos, puedes ejecutar la versión local del servidor MCP de DocSpace en su lugar.

La mayoría de los clientes que implementan el protocolo MCP tienen un archivo de configuración común en formato JSON, dentro del cual puedes agregar el servidor local MCP de ONLYOFFICE DocSpace.

Nota: El ejemplo común a continuación es aplicable para la imagen de Docker, por lo que Docker debe estar instalado en tu sistema.

Paso 1. Localiza tu archivo de configuración

Busca tu archivo de configuración .json del cliente.

Paso 2. Agrega la entrada del servidor MCP de DocSpace

Inserta el siguiente bloque en la sección mcpServers de tu archivo de configuración .json:

{
	"mcpServers": {
		"onlyoffice-docspace": {
			"command": "docker",
			"args": [
				"run",
				"--interactive",
				"--rm",
				"--env",
				"DOCSPACE_BASE_URL",
				"--env",
				"DOCSPACE_API_KEY",
				"onlyoffice/docspace-mcp"
			],
			"env": {
				"DOCSPACE_BASE_URL": "https://your-instance.onlyoffice.com",
				"DOCSPACE_API_KEY": "your-api-key"
			}
		}
	}
}

Paso 3. Establece los valores de entorno

• DOCSPACE_BASE_URL - la URL de tu instancia de DocSpace (p. ej., https://portal.onlyoffice.com).

• DOCSPACE_API_KEY - tu clave de API personal generada en la configuración de DocSpace -> Herramientas de desarrollador -> Claves de API.

Todos los parámetros disponibles se enumeran aquí.

Paso 4. Reinicia el cliente

Cierra y vuelve a abrir tu cliente. En la mayoría de los casos, el servidor MCP de DocSpace se iniciará automáticamente y podrás emitir comandos en lenguaje natural como:

• Crea una nueva sala de proyecto e invita a Anna con derechos de editor.

• Sube este archivo a "Mis documentos".

Herramientas

El servidor MCP de DocSpace implementa el concepto de Herramientas descrito en la especificación MCP.

Todas las herramientas del servidor MCP de DocSpace se describen aquí.

Documentación

La documentación está disponible en el directorio docs.

Ejemplos

Los siguientes ejemplos muestran cómo utilizar el servidor MCP de ONLYOFFICE DocSpace.

Política de privacidad

Las políticas están disponibles en Términos legales y Política de privacidad.

Licencia

El servidor MCP de DocSpace se distribuye bajo la licencia MIT que se encuentra en el archivo LICENSE.