MCP-Server

Docsbook liefert einen Model Context Protocol (MCP) Server. Verbinden Sie Claude Code oder einen beliebigen MCP-kompatiblen Client und verwalten Sie jeden Aspekt Ihrer Dokumente, ohne den Editor zu verlassen.

Was MCP ist#

Das Model Context Protocol ist ein offener Standard zum Bereitstellen von Werkzeugen, Ressourcen und Eingabeaufforderungen für KI-Agenten über eine typisierte RPC-Schnittstelle. Der Docsbook MCP-Server stellt 61 Werkzeuge zur Verfügung, die die gesamte Produktoberfläche abdecken.

Endpunkt#

https://docsbook.io/api/mcp/server

Die Authentifizierung erfolgt über OAuth 2.0 Autorisierungscode mit PKCE. Bearer-Token werden an den Client zurückgegeben und transparent aktualisiert.

Installieren Sie in Ihrem KI-Client#

Der Docsbook MCP-Server ist ein Remote-HTTP-Server mit OAuth – jeder moderne MCP-Client kann sich über denselben Endpunkt damit verbinden.

Claude Code#

claude mcp add --transport http docsbook https://docsbook.io/api/mcp/server

Der erste Aufruf öffnet einen Browser-Tab für OAuth. Nach der Zustimmung werden die Tools in Claude Code verfügbar.

Cursor#

Cursor hat keinen mcp add Befehl, aber es akzeptiert einen Ein-Klick-Installationslink:

cursor://anysphere.cursor-deeplink/mcp/install?name=docsbook&config=eyJ1cmwiOiJodHRwczovL2RvY3Nib29rLmlvL2FwaS9tY3Avc2VydmVyIiwidHlwZSI6Imh0dHAifQ==

Oder füge den Server zu ~/.cursor/mcp.json hinzu (oder verwende Einstellungen → MCP & Integrationen → Neuer MCP-Server):

{
  "mcpServers": {
    "docsbook": {
      "url": "https://docsbook.io/api/mcp/server"
    }
  }
}

Cursor neu laden — OAuth öffnet sich beim ersten Gebrauch im Browser.

Codex CLI#

codex mcp add docsbook --url https://docsbook.io/api/mcp/server

Oder bearbeite die Konfiguration direkt — Codex speichert MCP-Server in ~/.codex/config.toml:

[mcp_servers.docsbook]
url = "https://docsbook.io/api/mcp/server"

Windsurfen#

Bearbeiten Sie ~/.codeium/windsurf/mcp_config.json und aktualisieren Sie das Cascade-Panel:

{
  "mcpServers": {
    "docsbook": {
      "serverUrl": "https://docsbook.io/api/mcp/server"
    }
  }
}

Cline#

Öffnen Sie Cline → MCP-Server → MCP-Server konfigurieren und fügen Sie ein:

{
  "mcpServers": {
    "docsbook": {
      "url": "https://docsbook.io/api/mcp/server",
      "transportType": "http"
    }
  }
}

Gemini CLI#

gemini mcp add --transport http docsbook https://docsbook.io/api/mcp/server

Der Standardbereich ist das aktuelle Projekt — füge --scope user hinzu, um es global zu installieren. Oder füge es manuell zu ~/.gemini/settings.json hinzu (beachte, dass der Schlüssel httpUrl; url dort bedeutet SSE):

{
  "mcpServers": {
    "docsbook": {
      "httpUrl": "https://docsbook.io/api/mcp/server"
    }
  }
}

GitHub Copilot (VS Code)#

code --add-mcp '{"name":"docsbook","type":"http","url":"https://docsbook.io/api/mcp/server"}'

Oder erstellen Sie .vscode/mcp.json in Ihrem Arbeitsbereich und aktivieren Sie dann den Server über den Copilot Chat MCP Picker (beachten Sie, dass der Schlüssel servers ist, nicht mcpServers):

{
  "servers": {
    "docsbook": {
      "type": "http",
      "url": "https://docsbook.io/api/mcp/server"
    }
  }
}

ChatGPT#

ChatGPT unterstützt remote MCP über Connectoren (Pro / Business / Enterprise-Pläne).

1. Öffnen Sie ChatGPT → Einstellungen → Connectoren → Erweitert → Entwicklermodus.
2. Klicken Sie auf Erstellen und fügen Sie die URL ein: https://docsbook.io/api/mcp/server.
3. Autorisieren Sie im Browser, wenn Sie dazu aufgefordert werden.

Werkzeugkategorien#

Suche und Bearbeitung von Dokumentationsinhalten#

Es gibt zwei Möglichkeiten, mit Ihren Dokumentinhalten von einem Agenten aus zu arbeiten:

• Gehostet, über MCP-Token — search_docs (Kostenloser Plan und höher, schreibgeschützt, funktioniert mit jedem verbundenen Token unabhängig von seinem Umfang), get_doc_outline (Kostenlos+, schreibgeschützt; listet den Titel, die Anzahl der Überschriften und die Größe jeder Markdown-Seite auf, bevor gesucht oder geschrieben wird), und write_docs (Kostenlos+, erfordert ein Token, das mit Schreib-Lese Umfang autorisiert ist; überträgt eine oder mehrere Dateien als einen einzigen atomaren Git-Commit). Diese laufen direkt gegen das von Docsbook gehostete Repository, kein lokales Checkout erforderlich.
• Local, über markdown-lsp — für einen Agenten, der direkt an Ihren ausgecheckten Dateien arbeitet, markdown-lsp bietet reichhaltigere LSP-Stil doc_* Werkzeuge (Gliederung, unscharfe Überschriften, Volltext, Linkreferenzen, Links auflösen), indem npx markdown-lsp <subcommand> ./docs auf dem Computer des Agenten ausgeführt wird. Siehe Quelle der Wahrheit für die Liste der Werkzeuge und die Begründung.

Verwenden Sie search_docs/write_docs, wenn der Agent nur eine MCP-Verbindung hat (kein lokales Checkout); verwenden Sie markdown-lsp, wenn der Agent das Repository bereits auf der Festplatte hat und eine tiefere Graphnavigation wünscht.

Plan-Gating#

Jedes Tool erklärt einen Mindestplan. Der Server gibt einen strukturierten Fehler zurück, wenn ein Tool unter dem erforderlichen Niveau aufgerufen wird.

Verwandt#

• Chat Hooks — Konfigurieren Sie Pre/Post-LLM-Hooks über MCP.
• Docs Skills — Entdecken Sie SKILL.md-Dateien über find_skill.
• Webhooks — Registrieren Sie Ereignis-Handler von MCP.