Servidor MCP de ONLYOFFICE DocSpace

(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 .

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 stdio, SSE y transportes HTTP transmitibles.

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

• Configuración a nivel de solicitud - Configure 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 Node.js.

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

Puede conectarse al servidor MCP de DocSpace utilizando cualquier cliente MCP. Hemos cubierto algunos clientes populares, como Claude Desktop, Cursor, Windsurf, etc., y aquí puede 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 su agente de IA. Puede conectarse a él al instante sin implementar ni configurar nada en su 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.

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

Servidor MCP de DocSpace local

Si su host MCP no admite servidores MCP remotos, puede 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 puede 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 su sistema.

Paso 1. Localice su archivo de configuración

Busque su archivo de configuración .json del cliente.

Paso 2. Agregue la entrada del servidor MCP de DocSpace

Inserte el siguiente bloque en la sección mcpServers de su 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. Establezca los valores del entorno

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

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

Todos los parámetros disponibles se enumeran aquí.

Paso 4. Reinicie el cliente

Cierre y vuelva a abrir su cliente. En la mayoría de los casos, el servidor MCP de DocSpace se iniciará automáticamente y podrá 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 .

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

Documentación

La documentación está disponible en el directorio .

Ejemplos

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

Política de privacidad

Las políticas están disponibles en y .

Licencia

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