ONLYOFFICE DocSpace MCP-Server

Das (MCP) ist ein standardisiertes Protokoll zur Verwaltung des Kontexts zwischen großen Sprachmodellen (LLMs) und externen Systemen. Dieses Repository stellt einen MCP-Server für bereit.

Der DocSpace MCP-Server verbindet KI-Tools direkt mit ONLYOFFICE DocSpace. Dies gibt KI-Agenten, Assistenten und Chatbots die Möglichkeit, Räume zu verwalten, an Dateien zusammenzuarbeiten, Berechtigungen zu handhaben und Dokumenten-Workflows zu automatisieren – alles durch Interaktionen in natürlicher Sprache.

Funktionen

• Tools mit granularer Steuerung - Zugriff auf Tools, die in logische Toolsets unterteilt sind, mit fein abgestimmten Aktivierungs-/Deaktivierungsfunktionen und Meta-Tools.

• Mehrere Transportprotokolle - Unterstützung für stdio, SSE und Streamable HTTP Transporte.

• Verschiedene Authentifizierungsmethoden - Unterstützt API-Schlüssel, persönliche Zugriffstoken (Personal Access Tokens), Basis-Authentifizierung und OAuth 2.0 mit dynamischer Client-Registrierung. Siehe Beispiele.

• Konfiguration auf Anfrageebene - Konfigurieren Sie Authentifizierung und Tool-Auswahl während der Sitzungsinitialisierung mithilfe von benutzerdefinierten HTTP-Headern.

• Verschiedene Distributionsformate - Verfügbar als Docker-Image, Docker MCP-Server, MCP-Bundle und Node.js-Anwendung.

Anwendungsfälle

• Raumverwaltung: Erstellen, aktualisieren und archivieren Sie Räume. Konfigurieren Sie Raumtypen, verwalten Sie Mitgliedschaften und steuern Sie Zugriffsebenen.

• Ordner- & Dateioperationen: Erstellen Sie Ordner, laden Sie Dokumente hoch, kopieren oder verschieben Sie Elemente in Stapeln, benennen Sie Inhalte um oder löschen Sie diese und überprüfen Sie Datei- oder Ordnerdetails.

• Zusammenarbeit & Berechtigungen: Laden Sie Benutzer ein oder entfernen Sie sie, passen Sie Sicherheitseinstellungen an und überprüfen Sie die aktuellen Zugriffsrechte für Räume und freigegebene Bereiche.

• Inhaltszugriff: Rufen Sie Ordner wie "Meine Dokumente" oder "Räume" ab, erhalten Sie Ordnerinhalte, laden Sie Dateien als Text herunter und überwachen Sie laufende Dateioperationen.

• Personenverzeichnis: Listen Sie alle Personen im Portal auf, um Einladungen und Zugriffsverwaltung zu optimieren.

Verbinden von Clients mit dem DocSpace MCP-Server

Sie können sich mit jedem MCP-Client mit dem DocSpace MCP-Server verbinden. Wir haben einige beliebte Clients wie Claude Desktop, Cursor, Windsurf usw. behandelt, und hier können Sie mehr darüber lesen.

Remote DocSpace MCP-Server

Der Remote DocSpace MCP-Server wird von ONLYOFFICE gehostet und bietet den schnellsten Weg, DocSpace-Tools innerhalb Ihres KI-Agenten zu nutzen. Sie können sich sofort damit verbinden, ohne etwas auf Ihrem Computer bereitstellen oder konfigurieren zu müssen.

Die öffentliche Instanz ist unter https://mcp.onlyoffice.com/mcp für Clients verfügbar, die den modernen Streamable HTTP-Transport unterstützen, und unter https://mcp.onlyoffice.com/sse für Clients, die nur den älteren SSE-Transport unterstützen. Es ist vorzuziehen, wann immer möglich den Streamable HTTP-Transport zu verwenden.

Alle Optionen zum Verbinden von Clients mit dem Remote DocSpace MCP-Server finden Sie hier.

Lokaler DocSpace MCP-Server

Wenn Ihr MCP-Host keine Remote-MCP-Server unterstützt, können Sie stattdessen die lokale Version des DocSpace MCP-Servers ausführen.

Die meisten Clients, die das MCP-Protokoll implementieren, verfügen über eine gemeinsame Konfigurationsdatei im JSON-Format, in der Sie den ONLYOFFICE DocSpace MCP Local Server hinzufügen können.

Hinweis: Das folgende allgemeine Beispiel gilt für das Docker-Image, daher muss Docker auf Ihrem System installiert sein.

Schritt 1. Suchen Sie Ihre Konfigurationsdatei

Suchen Sie Ihre .json-Konfigurationsdatei des Clients.

Schritt 2. Fügen Sie den Eintrag für den DocSpace MCP-Server hinzu

Fügen Sie den folgenden Block in den Abschnitt mcpServers Ihrer .json-Konfigurationsdatei ein:

{
	"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"
			}
		}
	}
}

Schritt 3. Umgebungswerte festlegen

• DOCSPACE_BASE_URL - die URL Ihrer DocSpace-Instanz (z. B. https://portal.onlyoffice.com).

• DOCSPACE_API_KEY - Ihr persönlicher API-Schlüssel, der in den DocSpace-Einstellungen -> Entwicklertools -> API-Schlüssel generiert wurde.

Alle verfügbaren Parameter sind hier aufgelistet.

Schritt 4. Client neu starten

Schließen Sie Ihren Client und öffnen Sie ihn erneut. In den meisten Fällen startet der DocSpace MCP-Server automatisch, und Sie können Befehle in natürlicher Sprache erteilen, wie zum Beispiel:

• Erstelle einen neuen Projektraum und lade Anna mit Bearbeiterrechten ein.

• Lade diese Datei in "Meine Dokumente" hoch.

Tools

Der DocSpace MCP-Server implementiert das Tool-Konzept, das in der beschrieben ist.

Alle Tools des DocSpace MCP-Servers sind hier beschrieben.

Dokumentation

Die Dokumentation ist im Verzeichnis verfügbar.

Beispiele

Die folgenden zeigen, wie man den ONLYOFFICE DocSpace MCP-Server verwendet.

Datenschutzrichtlinie

Die Richtlinien sind unter und verfügbar.

Lizenz

Der DocSpace MCP-Server wird unter der MIT-Lizenz vertrieben, die in der Datei zu finden ist.