Zum Hauptinhalt springen

MCP

Docmost stellt einen Model Context Protocol (MCP)-Server bereit, der es AI-Assistenten und -Tools ermöglicht, mit den Inhalten Ihres Arbeitsbereichs zu interagieren. Über MCP können AI-Clients Seiten durchsuchen, lesen, erstellen und aktualisieren, Bereiche verwalten und mehr — und das alles unter Verwendung Ihres vorhandenen API-Schlüssels zur Authentifizierung.

note

MCP ist eine Enterprise-Funktion. Eine aktive Enterprise-Lizenz ist erforderlich.

MCP aktivieren (Admin)

MCP muss von einem Arbeitsbereich-Administrator aktiviert werden, bevor es verwendet werden kann.

  1. Gehen Sie zu Einstellungen > AI & MCP.
  2. Klicken Sie auf den Tab MCP.
  3. Schalten Sie den MCP-Schalter ein.
  4. Die MCP Server URL wird angezeigt. Sie hat das folgende Format: https://YOUR_DOCMOST_URL.com/mcp.

Nach der Aktivierung kann jedes Arbeitsbereich-Mitglied mit einem API-Schlüssel seine AI-Tools mit dem MCP-Server verbinden.

Authentifizierung

MCP verwendet Ihren persönlichen API-Schlüssel zur Authentifizierung. So erstellen Sie einen API-Schlüssel:

  1. Gehen Sie zu Einstellungen > API keys (unter Account).
  2. Klicken Sie auf Create API Key.
  3. Kopieren Sie den Schlüssel und bewahren Sie ihn sicher auf — er kann nicht erneut angezeigt werden.

Der API-Schlüssel wird als Bearer-Token im Authorization-Header übergeben. Ihr MCP-Client erledigt dies nach der Konfiguration automatisch.

AI-Clients verbinden

Claude Desktop

Fügen Sie Folgendes zu Ihrer Claude-Desktop-Konfigurationsdatei (claude_desktop_config.json) hinzu:

{
"mcpServers": {
"docmost": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://YOUR_DOCMOST_URL.com/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}

Ersetzen Sie https://YOUR_DOCMOST_URL.com durch die URL Ihrer Docmost-Instanz und YOUR_API_KEY durch Ihren API-Schlüssel.

Claude Code

Führen Sie einen der folgenden Befehle aus, um den Docmost-MCP-Server hinzuzufügen:

claude mcp add Docmost  --transport http https://YOUR_DOCMOST_URL.com/mcp --header "Authorization: Bearer YOUR_API_KEY" 

Oder mit mcp-remote:

claude mcp add docmost -- npx -y mcp-remote https://YOUR_DOCMOST_URL.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Fügen Sie Folgendes zu Ihrer Cursor-MCP-Konfiguration (.cursor/mcp.json) hinzu:

{
"mcpServers": {
"docmost": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://YOUR_DOCMOST_URL.com/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}

Unterstützte Tools

Der MCP-Server stellt die folgenden Tools bereit:

Seiten

ToolBeschreibung
search_pagesSeiten nach Stichwort durchsuchen
get_pageDen Inhalt einer bestimmten Seite abrufen
create_pageEine neue Seite in einem Bereich erstellen
update_pageTitel oder Inhalt einer vorhandenen Seite aktualisieren
list_pagesZuletzt verwendete Seiten in einem Bereich auflisten
list_child_pagesUntergeordnete Seiten einer bestimmten Seite auflisten
duplicate_pageEine Seite innerhalb ihres Bereichs duplizieren
copy_page_to_spaceEine Seite in einen anderen Bereich kopieren
move_pageEine Seite an eine andere Position oder zu einem anderen übergeordneten Element verschieben
move_page_to_spaceEine Seite in einen anderen Bereich verschieben

Bereiche

ToolBeschreibung
get_spaceDetails eines bestimmten Bereichs abrufen
list_spacesAlle Bereiche auflisten, auf die Sie Zugriff haben
create_spaceEinen neuen Bereich erstellen
update_spaceName oder Beschreibung eines Bereichs aktualisieren

Kommentare

ToolBeschreibung
get_commentsKommentare auf einer Seite abrufen
create_commentEinen Kommentar zu einer Seite hinzufügen
update_commentEinen vorhandenen Kommentar aktualisieren

Sonstiges

ToolBeschreibung
search_attachmentsDateianhänge im gesamten Arbeitsbereich durchsuchen
list_workspace_membersMitglieder des Arbeitsbereichs auflisten
get_current_userDetails des authentifizierten Benutzers abrufen

Berechtigungen

MCP berücksichtigt dieselben Berechtigungen wie die Docmost-Webanwendung. Der verbundene Benutzer kann nur auf Bereiche und Seiten zugreifen, die er anzeigen oder bearbeiten darf. Aktionen wie das Erstellen oder Aktualisieren von Seiten erfordern die entsprechenden Schreibberechtigungen.