Docs MCP-Server (Preview)
Preview — Der Docs MCP-Server ist aktuell in der Vorschau-Phase. API und Funktionsumfang können sich noch ändern.
Die ProcessCube®-Dokumentation ist als MCP-Server verfügbar. Damit können AI-Assistenten wie Claude die gesamte Dokumentation durchsuchen und als Wissensquelle nutzen.
Was ist MCP?
Das Model Context Protocol (MCP) ist ein offener Standard von Anthropic, der AI-Assistenten den Zugriff auf externe Datenquellen und Tools ermöglicht. Der Docs MCP-Server stellt die ProcessCube®-Docs-Suche als Tool bereit — Claude kann damit eigenständig nach Informationen zu Engine, Studio, LowCode, Authority und allen weiteren Komponenten suchen.
Verfügbare Tools
| Tool | Beschreibung |
|---|---|
search_docs | Durchsucht die gesamte ProcessCube®-Dokumentation (Volltextsuche) |
list_collections | Listet alle verfügbaren Dokumentations-Collections auf |
classify_ticket | Klassifiziert ein Ticket und ordnet es der passenden Collection + Repo zu |
classify_ticket_feedback | Gibt Feedback zu einer Klassifikation (fuer Self-Improvement) |
search_docs
Durchsucht die Dokumentation mit optionalem Collection-Filter.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
query | string | Ja | Suchbegriff (deutsch oder englisch) |
collection | string | Nein | Collection-Filter (z.B. engine, studio, lowcode) |
limit | number | Nein | Max. Ergebnisse (Standard: 10, max: 50) |
list_collections
Gibt alle verfügbaren Collections mit Dokumentanzahl und Beschreibung zurück. Nützlich um vor einer Suche zu erfahren, welche Collections es gibt.
classify_ticket
Klassifiziert ein Support-Ticket und ordnet es der passenden Dokumentations-Collection, dem Sub-Thema und dem Quell-Repository zu. Nutzt Keyword-Matching, Hybrid-Suche und bei Unsicherheit einen LLM-Entscheider.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
correlationId | string | Ja | Stabiler Schluessel (z.B. “org/repo#123”) |
title | string | Ja | Ticket-Titel |
body | string | Nein | Ticket-Beschreibung |
tags | string[] | Nein | Tags/Markierungen |
repo | string | Nein | Quell-Repository |
classify_ticket_feedback
Sendet eine Korrektur zu einer vorherigen Klassifikation. Verbessert zukuenftige Klassifikationen durch Self-Improvement.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
correlationId | string | Ja | correlationId aus dem classify_ticket Aufruf |
correctCollection | string | Ja | Die korrekte Collection |
correctSubTheme | string | Nein | Korrektes Sub-Thema |
comment | string | Nein | Begruendung |
Siehe Ticket-Classifier Dokumentation fuer Details.
Authentifizierung
Der MCP-Endpoint erfordert einen API-Key. Ohne gültigen Key werden alle
Anfragen mit 401 Unauthorized abgelehnt.
Der API-Key wird als Query-Parameter oder Bearer-Token übergeben:
- Query-Parameter:
https://docs.processcube.io/api/mcp?key=DEIN_API_KEY - Bearer-Token:
Authorization: Bearer DEIN_API_KEY
Den API-Key erhalten Sie über Ihr ProcessCube-Abonnement.
Einrichtung
Claude Code
Claude Code
In Claude Code wird der MCP-Server über die CLI registriert.
MCP-Server registrieren
claude mcp add processcube-docs --transport http "https://docs.processcube.io/api/mcp?key=DEIN_API_KEY"Dieser Befehl registriert den Server in der lokalen Claude Code Konfiguration. Mehr zur MCP-Konfiguration in Claude Code: Using MCP Servers
Verbindung prüfen
Starte eine neue Conversation und frage Claude:
Welche ProcessCube-Dokumentations-Collections gibt es?Claude sollte das list_collections-Tool aufrufen und die verfügbaren Collections anzeigen.
Die Registrierung gilt für alle zukünftigen Conversations. Um den Server zu entfernen: claude mcp remove processcube-docs
Lokale Entwicklung
Für die lokale Entwicklung kann der MCP-Server zusammen mit dem Docs-Projekt gestartet werden:
Suchindex erstellen (einmalig)
npm run index:localErstellt einen lokalen qmd-Suchindex in /tmp/qmd/. Benötigt einen GITHUB_TOKEN in der .env-Datei für den Zugriff auf Changelogs.
Dev-Server starten
npm run dev:mcpStartet Next.js mit aktivierter Suche und MCP-Endpoint auf http://localhost:3000/api/mcp.
MCP-Verbindung testen
Mit dem MCP Inspector :
npm run mcp:inspectorDort Streamable HTTP als Transport wählen und http://localhost:3000/api/mcp als URL eingeben.
In Claude Code lokal nutzen
claude mcp add processcube-docs-local --transport http http://localhost:3000/api/mcpArchitektur
docs.processcube.io (Next.js / Nextra)
├── Docs-Webseite (für Menschen)
├── /api/search (REST-API für die Web-Suche)
└── /api/mcp (MCP-Endpoint für AI-Assistenten)
↑
│ Streamable HTTP
│
┌───┴────────────────┐
│ Claude Code │
│ Claude Desktop │
│ Claude.ai │
└────────────────────┘Der MCP-Server nutzt intern dieselbe qmd -basierte Volltextsuche (BM25-Ranking) wie die Webseite — es gibt keine separate Datenbank oder Infrastruktur.