Docs MCP-Server für Abonnenten
Der öffentliche MCP-Endpoint stellt die ProcessCube®-Dokumentation als
MCP-Server für AI-Assistenten zur Verfügung —
authentifiziert mit dem PROCESSCUBE_API_KEY aus dem ProcessCube®-Account .
Dies ist der öffentliche Endpoint für Abonnenten. Den internen Endpoint
mit zusätzlichen Tools (classify_ticket etc.) findest du unter
Docs MCP-Server (Preview).
Endpoint
https://docs.processcube.io/api/mcp-publicVerfügbare Tools
| Tool | Beschreibung |
|---|---|
search_docs | Durchsucht die gesamte ProcessCube®-Dokumentation (Volltext + Vektor-Suche) |
list_collections | Listet alle verfügbaren Dokumentations-Collections auf |
search_docs
| 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.
Authentifizierung
Der öffentliche Endpoint erfordert einen gültigen PROCESSCUBE_API_KEY als
Bearer-Token im Authorization-Header. Anders als der interne Endpoint
unterstützt er keinen ?key=-Query-Parameter (Sicherheits-Default).
Den PROCESSCUBE_API_KEY erhältst du über dein ProcessCube®-Abonnement .
Derselbe Key, den auch Cuby und der Marktplatz verwenden.
Authorization: Bearer 12345678-1234-4abc-89de-0123456789abDer Key wird gegen https://marketplace.processcube.io/public_api/check-api-key
geprüft. Antworten werden bis zu 10 Minuten gecached, um den Marketplace nicht
zu belasten.
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 \
--header "Authorization: Bearer $PROCESSCUBE_API_KEY" \
https://docs.processcube.io/api/mcp-publicVerbindung prüfen
Starte eine neue Conversation und frage Claude:
Welche ProcessCube-Dokumentations-Collections gibt es?Claude sollte das list_collections-Tool aufrufen.
Fehlerantworten
| Status | Bedeutung |
|---|---|
401 | Kein/ungültiger API-Key. Format-Check (UUID v4) oder Marketplace-Antwort 401/403 |
503 | Marketplace nicht erreichbar oder Suchindex nicht verfügbar — bitte später erneut |
Antworten folgen dem JSON-RPC-Fehlerformat:
{
"jsonrpc": "2.0",
"error": {
"code": -32001,
"message": "Unauthorized: gueltiger PROCESSCUBE_API_KEY im Authorization-Bearer-Header erforderlich."
},
"id": null
}Datenschutz
- Der Klartext-API-Key wird nie geloggt. Logs enthalten nur einen 16-Zeichen-SHA-256-Hash zur Korrelation.
- Es werden keine Suchanfragen mit dem API-Key verknüpft gespeichert.