Keycloak MCP Server

Was macht der “Keycloak” MCP Server?

Der Keycloak MCP (Model Context Protocol) Server ist ein spezialisiertes Tool, das eine KI-gestützte Administration von Keycloak-Benutzern und -Realms ermöglicht. Als Brücke zwischen KI-Assistenten und Keycloak erlaubt er es externen Clients (wie Claude Desktop und anderen MCP-kompatiblen Plattformen), Aufgaben der Benutzer- und Realm-Verwaltung zu automatisieren. Über die MCP-Schnittstelle können Entwickler Benutzer anlegen, löschen, Realms auflisten und Benutzer in Realms abrufen – und das nahtlos. Dies verbessert Entwicklungs- und DevOps-Workflows, da KI-Agenten programmatisch mit Authentifizierungs- und Benutzerverwaltungs-Infrastrukturen interagieren können. So werden Routineaufgaben effizienter und der manuelle Aufwand reduziert.

Liste der Prompts

Im Repository werden keine Prompt-Vorlagen erwähnt.

Liste der Ressourcen

Im Repository sind keine expliziten Ressourcen dokumentiert.

Liste der Tools

• create-user
  Erstellt einen neuen Benutzer in einem angegebenen Realm.
  Eingaben: realm, username, email, firstName, lastName

• delete-user
  Löscht einen Benutzer aus einem angegebenen Realm.
  Eingaben: realm, userId

• list-realms
  Listet alle verfügbaren Keycloak-Realms auf.

• list-users
  Listet alle Benutzer in einem angegebenen Realm auf.
  Eingaben: realm

Anwendungsfälle dieses MCP Servers

• Automatisierte Benutzer-Provisionierung
  Entwickler oder DevOps-Engineers können die Erstellung neuer Nutzer über verschiedene Realms hinweg automatisieren und so manuelle Eingriffe reduzieren und konsistente Onboarding-Prozesse sicherstellen.
• Massen-Benutzerverwaltung
  Benutzer in bestimmten Realms einfach auflisten oder entfernen – ideal für große Umgebungen mit vielen Konten.
• Realm-Administration
  Schneller Abruf aller verfügbaren Realms, was Multi-Tenant- oder Multi-Environment-Szenarien erleichtert, bei denen eine Verwaltung über mehrere Realms erforderlich ist.
• Integration mit KI-Agenten
  KI-Assistenten können wiederkehrende Keycloak-Administrationsaufgaben übernehmen, z. B. Testnutzer für QA anlegen oder Demo-Umgebungen nach Tests bereinigen.
• Self-Service-Portale
  Endnutzer oder Support-Teams können routinemäßige Benutzerverwaltungsaufgaben über KI-Schnittstellen erledigen, was die Reaktionszeiten verbessert und Supportaufwand verringert.

Einrichtung

Windsurf

1. Stellen Sie sicher, dass Node.js auf Ihrem System installiert ist.
2. Suchen Sie Ihre Windsurf-Konfigurationsdatei.
3. Fügen Sie den Keycloak MCP Server mit folgendem JSON-Snippet hinzu:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. Speichern Sie die Konfiguration und starten Sie Windsurf neu.
5. Überprüfen Sie die Einrichtung, indem Sie kontrollieren, ob Windsurf eine Verbindung zum Keycloak MCP Server herstellen kann.

Claude

1. Stellen Sie sicher, dass Node.js installiert ist.
2. Öffnen Sie Ihre Claude Desktop-Konfigurationsdatei.
3. Fügen Sie folgende Konfiguration unter mcpServers ein:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. Speichern Sie die Datei und starten Sie Claude Desktop neu.
5. Bestätigen Sie die Konnektivität zum Keycloak MCP Server.

Cursor

1. Vergewissern Sie sich, dass Node.js eingerichtet ist.
2. Suchen und öffnen Sie die Cursor-Konfigurationsdatei.
3. Fügen Sie die Keycloak MCP Server-Details hinzu:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. Speichern Sie die Konfiguration und starten Sie Cursor neu.
5. Prüfen Sie, ob die Verbindung erfolgreich ist.

Cline

1. Installieren Sie Node.js, falls noch nicht vorhanden.
2. Greifen Sie auf die Cline-Konfigurationsdatei zu.
3. Fügen Sie folgende MCP Server-Konfiguration hinzu:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. Speichern Sie die Änderungen und starten Sie Cline neu.
5. Überprüfen Sie, ob Cline den Keycloak MCP Server erkennt.

Absicherung von API-Schlüsseln

Es wird empfohlen, für sensible Informationen wie Admin-Zugangsdaten Umgebungsvariablen zu verwenden. Beispielkonfiguration:

{
  "mcpServers": {
    "keycloak": {
      "command": "npx",
      "args": ["-y", "keycloak-model-context-protocol"],
      "env": {
        "KEYCLOAK_URL": "http://localhost:8080",
        "KEYCLOAK_ADMIN": "${KEYCLOAK_ADMIN}",
        "KEYCLOAK_ADMIN_PASSWORD": "${KEYCLOAK_ADMIN_PASSWORD}"
      }
    }
  }
}

Setzen Sie die Umgebungsvariablen KEYCLOAK_ADMIN und KEYCLOAK_ADMIN_PASSWORD sicher in Ihrem System, bevor Sie die Anwendung starten.

Nutzung dieses MCP in Flows

Verwendung von MCP in FlowHunt

Um MCP-Server in Ihren FlowHunt-Workflow einzubinden, fügen Sie zunächst die MCP-Komponente zu Ihrem Flow hinzu und verbinden diese mit Ihrem KI-Agenten:

Klicken Sie auf die MCP-Komponente, um das Konfigurationspanel zu öffnen. Fügen Sie im Bereich System-MCP-Konfiguration Ihre MCP-Server-Details in folgendem JSON-Format ein:

{
  "keycloak": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Nach der Konfiguration kann der KI-Agent dieses MCP als Tool mit Zugriff auf alle Funktionen und Möglichkeiten nutzen. Denken Sie daran, “keycloak” durch den tatsächlichen Namen Ihres MCP-Servers zu ersetzen und die URL durch Ihre eigene MCP-Server-URL auszutauschen.

Übersicht

Basierend auf der verfügbaren Dokumentation und den Features bietet der Keycloak MCP Server solide Grundwerkzeuge für die Keycloak-Administration, es fehlen jedoch fortgeschrittene MCP-Funktionen wie Prompt-Vorlagen, explizite Ressourcen oder Sampling Support. Sein Hauptnutzen liegt in der einfachen Benutzer-/Realm-Verwaltung über KI-Schnittstellen.

MCP Score

Gesamtbewertung:
Ich würde diesem MCP Server eine 5/10 geben. Er bietet essenzielle, gut dokumentierte Tools zur Keycloak-Administration, es fehlen jedoch fortgeschrittene MCP-Funktionen und eine LICENSE-Datei, was seine Verbreitung und Erweiterbarkeit einschränkt.