keycloak-model-context-protocol — MCP-сервер для Claude Code
MCP-сервер keycloak-model-context-protocol даёт ИИ доступ к администрированию пользователей, групп, ролей и realm в Keycloak. Он пригодится для запросов к Admin REST API из Claude Code.
MIT ★ 47 обновлён 2026-10-26
claude mcp add --env KEYCLOAK_URL=<KEYCLOAK_URL> --env KEYCLOAK_AUTH_REALM=<KEYCLOAK_AUTH_REALM> --env KEYCLOAK_CLIENT_ID=<KEYCLOAK_CLIENT_ID> --env KEYCLOAK_CLIENT_SECRET=<KEYCLOAK_CLIENT_SECRET> --env KEYCLOAK_USERNAME=<KEYCLOAK_USERNAME> --transport stdio keycloak-model-context-protocol -- npx -y keycloak-model-context-protocolЧто делает keycloak-model-context-protocol
Сервер подключается к Keycloak через Admin REST API и позволяет управлять пользователями, группами и ролями, а также просматривать realm. Инструменты включаются наборами: по умолчанию доступны core, groups и roles. Есть режим только для чтения и список разрешённых realm.
Для запуска нужны Node.js 22 или новее, доступный с вашей машины сервер Keycloak и MCP-клиент. Передайте серверу URL Keycloak и данные учётной записи; для входа через client_credentials создайте отдельного клиента служебной учётной записи и выдайте ему нужные роли. Изменения по умолчанию сначала показываются как предварительный просмотр, а затем требуют подтверждения. Без доступа к серверу Keycloak подключение не заработает.
Какие задачи решает
- просматривать пользователей в выбранном realm
- управлять группами Keycloak
- назначать пользователям роли
- ограничивать инструменты режимом только для чтения
- проверять список доступных realm
Примеры запросов агенту
- Покажи первые записи пользователей в realm
demo. - Перечисли группы в realm
demo. - Покажи доступные мне realm в Keycloak.
Как установить keycloak-model-context-protocol
Командой платформы
claude mcp add --env KEYCLOAK_URL=<KEYCLOAK_URL> --env KEYCLOAK_AUTH_REALM=<KEYCLOAK_AUTH_REALM> --env KEYCLOAK_CLIENT_ID=<KEYCLOAK_CLIENT_ID> --env KEYCLOAK_CLIENT_SECRET=<KEYCLOAK_CLIENT_SECRET> --env KEYCLOAK_USERNAME=<KEYCLOAK_USERNAME> --transport stdio keycloak-model-context-protocol -- npx -y keycloak-model-context-protocolВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Командой платформы
codex mcp add keycloak-model-context-protocol --env KEYCLOAK_URL=<KEYCLOAK_URL> --env KEYCLOAK_AUTH_REALM=<KEYCLOAK_AUTH_REALM> --env KEYCLOAK_CLIENT_ID=<KEYCLOAK_CLIENT_ID> --env KEYCLOAK_CLIENT_SECRET=<KEYCLOAK_CLIENT_SECRET> --env KEYCLOAK_USERNAME=<KEYCLOAK_USERNAME> -- npx -y keycloak-model-context-protocolВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"keycloak-model-context-protocol": {
"command": "npx",
"args": [
"-y",
"keycloak-model-context-protocol"
],
"env": {
"KEYCLOAK_URL": "<KEYCLOAK_URL>",
"KEYCLOAK_AUTH_REALM": "<KEYCLOAK_AUTH_REALM>",
"KEYCLOAK_CLIENT_ID": "<KEYCLOAK_CLIENT_ID>",
"KEYCLOAK_CLIENT_SECRET": "<KEYCLOAK_CLIENT_SECRET>",
"KEYCLOAK_USERNAME": "<KEYCLOAK_USERNAME>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"keycloak-model-context-protocol": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"keycloak-model-context-protocol"
],
"env": {
"KEYCLOAK_URL": "<KEYCLOAK_URL>",
"KEYCLOAK_AUTH_REALM": "<KEYCLOAK_AUTH_REALM>",
"KEYCLOAK_CLIENT_ID": "<KEYCLOAK_CLIENT_ID>",
"KEYCLOAK_CLIENT_SECRET": "<KEYCLOAK_CLIENT_SECRET>",
"KEYCLOAK_USERNAME": "<KEYCLOAK_USERNAME>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e KEYCLOAK_URL=<KEYCLOAK_URL> -e KEYCLOAK_AUTH_REALM=<KEYCLOAK_AUTH_REALM> -e KEYCLOAK_CLIENT_ID=<KEYCLOAK_CLIENT_ID> -e KEYCLOAK_CLIENT_SECRET=<KEYCLOAK_CLIENT_SECRET> -e KEYCLOAK_USERNAME=<KEYCLOAK_USERNAME> keycloak-model-context-protocol npx -y keycloak-model-context-protocolВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о keycloak-model-context-protocol
Как установить keycloak-model-context-protocol в Claude Code?
Выполните `claude mcp add keycloak-model-context-protocol -e KEYCLOAK_URL=<KEYCLOAK_URL> -e KEYCLOAK_CLIENT_SECRET=<KEYCLOAK_CLIENT_SECRET> -e KEYCLOAK_PASSWORD=<KEYCLOAK_PASSWORD> -- npx -y keycloak-model-context-protocol`. Укажите адрес Keycloak и данные для выбранного способа входа.
Что делает keycloak-model-context-protocol?
Он подключает ИИ к Admin REST API Keycloak. Через MCP-сервер можно работать с пользователями, группами и ролями, а также просматривать realm.
Что нужно для запуска MCP-сервера Keycloak?
Нужны Node.js 22 или новее, доступный сервер Keycloak и MCP-клиент. Для входа через client_credentials настройте клиента служебной учётной записи и назначьте необходимые роли.