Keycloak MCPサーバー

「Keycloak」MCPサーバーとは？

Keycloak MCP（Model Context Protocol）サーバーは、KeycloakのユーザーやレルムをAIで管理できる専用ツールです。AIアシスタントとKeycloakの橋渡し役となり、Claude DesktopなどMCP対応プラットフォームからユーザーやレルム管理作業を自動化できます。MCPインターフェースを通して、ユーザー作成・削除・レルム一覧・ユーザー一覧などの操作をシームレスに実行可能。これにより、AIエージェントが認証やユーザー管理インフラとプログラム的に連携できるため、日常的な管理作業の効率化と手動作業の削減が実現します。

プロンプト一覧

リポジトリにはプロンプトテンプレートの記載がありません。

リソース一覧

リポジトリには明示的なリソースの記載がありません。

ツール一覧

• create-user
  指定したレルムに新しいユーザーを作成します。
  入力項目: realm, username, email, firstName, lastName

• delete-user
  指定したレルムからユーザーを削除します。
  入力項目: realm, userId

• list-realms
  利用可能なKeycloakレルムをすべて一覧表示します。

• list-users
  指定したレルム内の全ユーザーを一覧表示します。
  入力項目: realm

このMCPサーバーのユースケース

• ユーザー自動プロビジョニング
  開発者やDevOpsエンジニアが複数レルムにまたがるユーザー作成を自動化し、手作業を減らして一貫性のあるオンボーディングを実現できます。
• 大量ユーザー管理
  特定レルムのユーザー一覧取得や一括削除など、大規模なユーザーアカウント管理に最適です。
• レルム管理
  すべての利用可能なレルム一覧を即座に取得し、マルチテナントや複数環境管理にも対応できます。
• AIエージェントとの統合
  テストユーザーの作成やデモ環境のクリーンアップなど、繰り返し発生するKeycloak管理作業をAIアシスタントに任せられます。
• セルフサービスポータル
  現場ユーザーやサポートチームがAIインターフェース経由で日常的なユーザー管理を行い、対応速度向上やサポート負荷低減につなげます。

セットアップ方法

Windsurf

1. Node.jsがインストールされていることを確認します。
2. Windsurfの設定ファイルを探します。
3. 次のJSONスニペットを追加してKeycloak MCPサーバーを設定します:

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

4. 設定を保存し、Windsurfを再起動します。
5. WindsurfからKeycloak MCPサーバーに接続できるか確認してください。

Claude

1. Node.jsがインストールされていることを確認します。
2. Claude Desktopの設定ファイルを開きます。
3. 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. ファイルを保存し、Claude Desktopを再起動します。
5. Keycloak MCPサーバーへの接続を確認してください。

Cursor

1. Node.jsがセットアップされていることを確認します。
2. Cursorの設定ファイルを開きます。
3. Keycloak MCPサーバーの設定を追加します:

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

4. 設定を保存し、Cursorを再起動します。
5. 正常に接続できるか確認してください。

Cline

1. Node.jsが未インストールの場合はインストールします。
2. Clineの設定ファイルにアクセスします。
3. 次のMCPサーバー設定を追加します:

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

4. 設定を保存し、Clineを再起動します。
5. ClineがKeycloak MCPサーバーを認識できるか確認します。

APIキーなど機密情報の保護

管理者認証情報などの機密情報は環境変数を使って管理することを推奨します。例:

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

アプリケーション起動前に、KEYCLOAK_ADMIN および KEYCLOAK_ADMIN_PASSWORD という環境変数を安全にシステムにセットしてください。

FlowHuntフローでMCPを活用する方法

FlowHuntでMCPサーバーをワークフローに組み込むには、まずフローにMCPコンポーネントを追加し、AIエージェントと接続します:

MCPコンポーネントをクリックして設定パネルを開きます。システムMCP設定セクションで、以下のJSON形式でMCPサーバー情報を入力します:

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

設定後、AIエージェントはこのMCPをツールとして利用できるようになり、すべての機能にアクセス可能となります。“keycloak” の部分は実際のMCPサーバー名に、URLはご自身のサーバーURLに変更してください。

概要

公開されているドキュメントと機能から、Keycloak MCPサーバーはKeycloak管理の基礎的なツールを提供していますが、プロンプトテンプレートや明示的なリソース、サンプリングサポートなど高度なMCP機能はありません。主な価値は、AIインターフェース経由でシンプルなユーザー・レルム管理ができる点です。

MCPスコア

総合評価:
このMCPサーバーの評価は 5/10 です。Keycloak管理の基本的なツールは十分に備えていますが、先進的なMCP機能やライセンスファイルがなく、普及や拡張性には制限があります。