Keycloak MCP Sunucusu

“Keycloak” MCP Sunucusu ne yapar?

Keycloak MCP (Model Context Protocol) Sunucusu, Keycloak kullanıcılarının ve alanlarının yapay zeka destekli yönetimini sağlayan özel bir araçtır. YZ asistanları ile Keycloak arasında köprü görevi görür ve harici istemcilerin (Claude Desktop ve diğer MCP uyumlu platformlar gibi) kullanıcı ve alan yönetimi görevlerini otomatikleştirmesine olanak tanır. MCP arayüzü üzerinden geliştiriciler, kullanıcı oluşturma, silme, alan listeleme ve kullanıcı listeleme işlemlerini sorunsuzca gerçekleştirebilir. Bu sayede YZ ajanlarının kimlik doğrulama ve kullanıcı yönetim altyapısı ile programlı olarak etkileşime geçmesi sağlanır, rutin idari görevler daha verimli hale gelir ve manuel iş yükü azalır.

Komut Listesi

Depoda herhangi bir komut şablonundan bahsedilmemiştir.

Kaynak Listesi

Depoda açıkça dokümante edilmiş herhangi bir kaynak bulunmamaktadır.

Araçlar Listesi

• create-user
  Belirtilen bir alanda yeni bir kullanıcı oluşturur.
  Girdiler: realm, username, email, firstName, lastName

• delete-user
  Belirtilen bir alandan kullanıcıyı siler.
  Girdiler: realm, userId

• list-realms
  Tüm mevcut Keycloak alanlarını listeler.

• list-users
  Belirtilen bir alandaki tüm kullanıcıları listeler.
  Girdiler: realm

Bu MCP Sunucusunun Kullanım Alanları

• Otomatik Kullanıcı Sağlama
  Geliştiriciler veya DevOps mühendisleri, farklı alanlarda yeni kullanıcıların oluşturulmasını otomatikleştirerek manuel müdahaleyi azaltabilir ve tutarlı işe alım süreçleri sağlayabilir.
• Toplu Kullanıcı Yönetimi
  Belirli alanlarda kullanıcıları kolayca listeleyip silebilir, çoklu kullanıcı hesabı bulunan büyük ölçekli ortamları yönetmek için uygundur.
• Alan Yönetimi
  Tüm mevcut alanların listesini hızlıca alabilir, çoklu tenant veya çoklu ortam senaryolarında alanlar arası yönetimi kolaylaştırır.
• YZ Ajanları ile Entegrasyon
  YZ asistanlarının test kullanıcılarını oluşturma veya test sonrası demo ortamlarını temizleme gibi tekrarlayan Keycloak idari görevlerini üstlenmesini sağlar.
• Self-Servis Portallar
  Son kullanıcıların veya destek ekiplerinin YZ arayüzleri üzerinden rutin kullanıcı yönetim işlemlerini yapmasına imkan tanır, yanıt sürelerini iyileştirir ve destek iş yükünü azaltır.

Nasıl Kurulur

Windsurf

1. Sisteminizde Node.js’in kurulu olduğundan emin olun.
2. Windsurf yapılandırma dosyanızı bulun.
3. Aşağıdaki JSON parçası ile Keycloak MCP Sunucusunu ekleyin:

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

4. Yapılandırmayı kaydedin ve Windsurf’u yeniden başlatın.
5. Windsurf’un Keycloak MCP Sunucusuna bağlanabildiğini kontrol ederek kurulumu doğrulayın.

Claude

1. Node.js’in kurulu olduğundan emin olun.
2. Claude Desktop yapılandırma dosyanızı açın.
3. mcpServers altına aşağıdaki yapılandırmayı ekleyin:

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

4. Dosyayı kaydedin ve Claude Desktop’u yeniden başlatın.
5. Keycloak MCP Sunucusuna bağlantıyı doğrulayın.

Cursor

1. Node.js’in kurulu olduğundan emin olun.
2. Cursor yapılandırma dosyasını bulun ve açın.
3. Keycloak MCP Sunucusu ayrıntılarını ekleyin:

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

4. Yapılandırmayı kaydedin ve Cursor’u yeniden başlatın.
5. Başarılı bağlantıyı kontrol edin.

Cline

1. Node.js yüklü değilse kurun.
2. Cline yapılandırma dosyasına erişin.
3. Aşağıdaki MCP Sunucu yapılandırmasını ekleyin:

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

4. Değişiklikleri kaydedin ve Cline’ı yeniden başlatın.
5. Cline’ın Keycloak MCP Sunucusunu tanıdığını doğrulayın.

API Anahtarlarının Güvenliği

Yönetici kimlik bilgileri gibi hassas bilgiler için ortam değişkenlerinin kullanılması önerilir. Örnek yapılandırma:

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

Uygulamayı başlatmadan önce sisteminizde KEYCLOAK_ADMIN ve KEYCLOAK_ADMIN_PASSWORD ortam değişkenlerini güvenli bir şekilde ayarlayın.

Bu MCP Nasıl Akışlarda Kullanılır

FlowHunt’ta MCP kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, akışınıza MCP bileşenini ekleyin ve AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırması bölümünde, MCP sunucu bilgilerinizi şu JSON formatıyla ekleyin:

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

Yapılandırma tamamlandığında, AI ajanı artık bu MCP’yi tüm işlevlerine erişmek için bir araç olarak kullanabilir. “keycloak” adını kendi MCP sunucunuzun adıyla, URL’yi ise kendi MCP sunucu URL’inizle değiştirmeyi unutmayın.

Genel Bakış

Mevcut dokümantasyon ve özelliklere göre, Keycloak MCP Sunucusu Keycloak yönetimi için sağlam temel araçlar sunar, ancak komut şablonları, açık kaynaklar veya örnekleme desteği gibi gelişmiş MCP özelliklerinden yoksundur. Temel değeri, YZ arayüzleri aracılığıyla doğrudan kullanıcı/alan yönetimi sunmasındadır.

MCP Puanı

Genel Değerlendirme:
Bu MCP sunucusuna 5/10 puan veriyorum. Temel, iyi dokümante edilmiş Keycloak yönetim araçları sunuyor ancak gelişmiş MCP özellikleri ve lisans dosyasının eksikliği yaygın kullanım ve genişletilebilirlik açısından bir engel oluşturuyor.