Keycloak MCP Server

Cosa fa il server “Keycloak” MCP?

Il Keycloak MCP (Model Context Protocol) Server è uno strumento specializzato che abilita l’amministrazione di utenti e realm Keycloak tramite AI. Agendo da ponte tra assistenti AI e Keycloak, permette a client esterni (come Claude Desktop e altre piattaforme compatibili MCP) di automatizzare le attività di gestione utenti e realm. Tramite l’interfaccia MCP, gli sviluppatori possono effettuare operazioni di creazione, cancellazione, elenchi di realm e utenti in modo fluido. Questo migliora i processi di sviluppo e DevOps consentendo agli agenti AI di interagire in modo programmato con infrastrutture di autenticazione e gestione utenti, rendendo più efficienti le attività amministrative di routine e riducendo il lavoro manuale.

Elenco dei Prompt

Nessun template di prompt è menzionato nel repository.

Elenco delle Risorse

Nessuna risorsa esplicita è documentata nel repository.

Elenco degli Strumenti

• create-user
  Crea un nuovo utente in un realm specificato.
  Input: realm, username, email, firstName, lastName

• delete-user
  Elimina un utente da un realm specificato.
  Input: realm, userId

• list-realms
  Elenca tutti i realm Keycloak disponibili.

• list-users
  Elenca tutti gli utenti in un realm specifico.
  Input: realm

Casi d’Uso di questo MCP Server

• Provisioning Utenti Automatizzato
  Sviluppatori o ingegneri DevOps possono automatizzare la creazione di nuovi utenti su diversi realm, riducendo l’intervento manuale e garantendo processi di onboarding coerenti.
• Gestione Utenti in Massa
  È semplice elencare o rimuovere utenti in specifici realm, rendendolo adatto alla gestione di ambienti su larga scala con più account utente.
• Amministrazione Realm
  Recupera rapidamente l’elenco di tutti i realm disponibili, facilitando scenari multi-tenant o multi-ambiente dove è richiesta la gestione tra più realm.
• Integrazione con Agenti AI
  Consenti agli assistenti AI di gestire compiti amministrativi Keycloak ripetitivi, come la creazione di utenti di test per QA o la pulizia di ambienti demo dopo i test.
• Portali Self-Service
  Permetti agli utenti finali o ai team di supporto di eseguire azioni di gestione utenti di routine tramite interfacce AI, migliorando i tempi di risposta e riducendo il carico di supporto.

Come configurarlo

Windsurf

1. Verifica che Node.js sia installato sul tuo sistema.
2. Individua il file di configurazione di Windsurf.
3. Aggiungi il Keycloak MCP Server utilizzando il seguente frammento JSON:

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

4. Salva la configurazione e riavvia Windsurf.
5. Verifica la configurazione controllando che Windsurf possa collegarsi al Keycloak MCP Server.

Claude

1. Verifica che Node.js sia installato.
2. Apri il file di configurazione di Claude Desktop.
3. Inserisci la seguente configurazione sotto mcpServers:

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

4. Salva il file e riavvia Claude Desktop.
5. Conferma la connettività al Keycloak MCP Server.

Cursor

1. Assicurati che Node.js sia configurato.
2. Trova e apri il file di configurazione di Cursor.
3. Aggiungi i dettagli del Keycloak MCP Server:

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

4. Salva la configurazione e riavvia Cursor.
5. Verifica che la connessione sia avvenuta con successo.

Cline

1. Installa Node.js se non già presente.
2. Accedi al file di configurazione di Cline.
3. Aggiungi la seguente configurazione MCP Server:

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

4. Salva le modifiche e riavvia Cline.
5. Verifica che Cline riconosca il Keycloak MCP Server.

Mettere in sicurezza le API Key

Si raccomanda di utilizzare variabili di ambiente per informazioni sensibili come le credenziali admin. Esempio di configurazione:

{
  "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}"
      }
    }
  }
}

Imposta le variabili di ambiente KEYCLOAK_ADMIN e KEYCLOAK_ADMIN_PASSWORD in modo sicuro sul tuo sistema prima di avviare l’applicazione.

Come usare questo MCP nei flussi

Utilizzo di MCP in FlowHunt

Per integrare i server MCP nel tuo workflow FlowHunt, inizia aggiungendo il componente MCP al tuo flusso e collegandolo al tuo agente AI:

Clicca sul componente MCP per aprire il pannello di configurazione. Nella sezione di configurazione MCP di sistema, inserisci i dettagli del tuo server MCP usando questo formato JSON:

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

Una volta configurato, l’agente AI sarà in grado di usare questo MCP come strumento con accesso a tutte le sue funzioni e capacità. Ricorda di cambiare “keycloak” con il vero nome del tuo server MCP e sostituire la URL con quella del tuo MCP server.

Panoramica

In base alla documentazione e alle funzionalità disponibili, il Keycloak MCP Server offre solide basi per l’amministrazione Keycloak, ma manca di funzionalità MCP avanzate come template di prompt, risorse esplicite o supporto sampling. Il suo valore principale consiste nella gestione semplice di utenti/realm tramite interfacce AI.

MCP Score

Valutazione Complessiva:
Darei a questo MCP server un 5/10. Offre strumenti essenziali e ben documentati per l’amministrazione Keycloak ma manca di funzionalità MCP avanzate e non ha un file LICENSE, limitandone l’adozione e l’estendibilità.