🔌MCP - Voraussetzungen & Authentifizierung

📋 Inhaltsverzeichnis

1. Übersicht
2. Voraussetzungen
3. Authentifizierung
4. Einrichtung nach Client
5. Token erneuern

⚙️ Übersicht

Der Casebase MCP Server ermöglicht es jedem MCP-kompatiblen KI-Client, direkt mit deinem Use-Case-Portfolio zu interagieren. Statt die Casebase-Oberfläche zu nutzen, kannst du Use Cases über KI-Assistenten wie Claude, Cursor oder eigene Agenten abfragen, erstellen und aktualisieren.

Der MCP Server ist ein schlanker Adapter-Layer: Er leitet Anfragen des KI-Clients direkt an die Casebase REST API weiter. Die gesamte Verarbeitungslogik liegt beim KI-Client oder im Casebase-Backend — nicht im MCP Server selbst.

Server URL:

https://mcp.casebase.ai/mcp/{tenant}/{workspaceId}

✅ Voraussetzungen

• Ein Casebase-Konto mit Workspace-Zugriff
• Ein MCP-kompatibler Client (z. B. Claude Desktop, Cursor, VS Code, Claude Code CLI)
• Authentifizierung via OAuth (SSO oder E-Mail/Passwort) — oder ein Bearer Token für CLI- und Entwickler-Setups

🔐 Authentifizierung

Der MCP Server unterstützt zwei Authentifizierungsmodelle. Die folgende Tabelle hilft bei der Wahl:

OAuth 2.1 (empfohlen)

OAuth ist der einfachste Weg, einen MCP-kompatiblen KI-Client mit Casebase zu verbinden. Kein manuelles Token-Management erforderlich.

So funktioniert es:

1. Kopiere deine MCP Server URL unter Workspace-Einstellungen → MCP Server
2. Füge sie in deinem KI-Client als neuen MCP Server ein (nur URL — keine Header erforderlich)
3. Ein Authentifizierungsfenster öffnet sich automatisch
4. Melde dich via SSO (sofern für deine Organisation konfiguriert) oder mit E-Mail und Passwort an
5. Fertig — dein KI-Client ist verbunden

Die Session wird automatisch verwaltet. Eine erneute Anmeldung ist nur erforderlich, wenn die Session abläuft oder du dich explizit abmeldest.

Bearer Token (für Entwickler & CLI)

Für Claude Code CLI und andere Setups, in denen OAuth nicht praktikabel ist, kann ein kurzlebiger Bearer Token aus Microsoft Entra ID genutzt werden.

Token via Azure CLI generieren:

powershell

az account get-access-token --resource {entra-resource-id} --query accessToken -o tsv

Der Token wird als Header in der Client-Konfiguration hinterlegt:

Authorization: Bearer {token} Provider: AD

⚠️ Tokens laufen nach ca. 1 Stunde ab. Siehe Token erneuern für den Erneuerungs-Workflow.

🚀 Einrichtung nach Client

Die MCP Server URL findest du unter Workspace-Einstellungen → MCP Server.

Claude Desktop (OAuth)

Füge die MCP Server URL in Claude Desktop als neuen MCP Server hinzu. Das Authentifizierungsfenster öffnet sich automatisch beim ersten Verbindungsversuch.

Claude Desktop (Bearer Token)

Öffne claude_desktop_config.json und füge folgenden Eintrag hinzu:

jsonc

{   "mcpServers": {     "casebase": {       "type": "http",       "url": "https://mcp.casebase.ai/mcp/{tenant}/{workspaceId}",       "headers": {         "Authorization": "Bearer {dein-token}",         "Provider": "AD"       }     }   } }

Cursor

Erstelle eine .cursor/mcp.json Datei im Projektverzeichnis:

jsonc

{   "mcpServers": {     "casebase": {       "url": "https://mcp.casebase.ai/mcp/{tenant}/{workspaceId}",       "headers": {         "Authorization": "Bearer {dein-token}",         "Provider": "AD"       }     }   } }

VS Code

Öffne die Command Palette (Cmd+Shift+P / Ctrl+Shift+P) und wähle MCP: Add Server → HTTP. Trage die Server URL ein und bestätige. Öffne danach die generierte mcp.json und ergänze die Header:

jsonc

{   "servers": {     "casebase": {       "type": "http",       "url": "https://mcp.casebase.ai/mcp/{tenant}/{workspaceId}",       "headers": {         "Authorization": "Bearer {dein-token}",         "Provider": "AD"       }     }   } }

Claude Code CLI

powershell

claude mcp add casebase "https://mcp.casebase.ai/mcp/{tenant}/{workspaceId}" `   --transport http `   --header "Authorization: Bearer {dein-token}" `   --header "Provider: AD"

Verbindung prüfen: claude mcp list und /mcp innerhalb einer Session.

Token aktualisieren: Da Claude Code den Token direkt in der Registrierung speichert, muss bei Ablauf zuerst claude mcp remove casebase ausgeführt werden, dann der mcp add-Befehl mit dem neuen Token wiederholt werden.

🔄 Token erneuern

Gilt nur für Bearer Token (Entra ID). Bearer Tokens laufen nach ca. 1 Stunde ab. Wenn dein Client nicht mehr antwortet oder einen Authentifizierungsfehler meldet:

1. Neuen Token generieren:

powershell

az account get-access-token --resource {entra-resource-id} --query accessToken -o tsv

2. Token in der Client-Konfiguration ersetzen:

💡 Clients lesen Konfigurationsdateien nicht automatisch neu ein — ein Neustart des Clients oder der MCP-Verbindung ist nach dem Update erforderlich.