# keycloak-model-context-protocol

MCP-сервер keycloak-model-context-protocol даёт ИИ доступ к администрированию пользователей, групп, ролей и realm в Keycloak. Он пригодится для запросов к Admin REST API из Claude Code.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 47 у репозитория
- Автор: ChristophEnglisch
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ChristophEnglisch/keycloak-model-context-protocol
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/keycloak-model-context-protocol

## Что делает

Сервер подключается к Keycloak через Admin REST API и позволяет управлять пользователями, группами и ролями, а также просматривать realm. Инструменты включаются наборами: по умолчанию доступны `core`, `groups` и `roles`. Есть режим только для чтения и список разрешённых realm.

Для запуска нужны Node.js 22 или новее, доступный с вашей машины сервер Keycloak и MCP-клиент. Передайте серверу URL Keycloak и данные учётной записи; для входа через `client_credentials` создайте отдельного клиента служебной учётной записи и выдайте ему нужные роли. Изменения по умолчанию сначала показываются как предварительный просмотр, а затем требуют подтверждения. Без доступа к серверу Keycloak подключение не заработает.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `KEYCLOAK_URL`, `KEYCLOAK_AUTH_REALM`, `KEYCLOAK_CLIENT_ID`, `KEYCLOAK_CLIENT_SECRET`, `KEYCLOAK_USERNAME`, `KEYCLOAK_PASSWORD`, `KEYCLOAK_GRANT_TYPE`, `KEYCLOAK_MCP_READ_ONLY`, `KEYCLOAK_MCP_REALMS`, `KEYCLOAK_MCP_ALLOW_MASTER_WRITE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- просматривать пользователей в выбранном realm
- управлять группами Keycloak
- назначать пользователям роли
- ограничивать инструменты режимом только для чтения
- проверять список доступных realm

## Примеры запросов агенту
- Покажи первые записи пользователей в realm `demo`.
- Перечисли группы в realm `demo`.
- Покажи доступные мне realm в Keycloak.

## Похожие
- [keycloak-administration](https://affpapa.org/nevibecode/skills/keycloak-administration.md) — скилл · 336 установок
- [keycloak-expert](https://affpapa.org/nevibecode/agents/keycloak-expert.md) — субагент · ★ 1029 у репозитория
- [Phase Two Keycloak](https://affpapa.org/nevibecode/mcp/phase-two-keycloak.md) — MCP-сервер · ★ 5 у репозитория
- [model-context-protocol](https://affpapa.org/nevibecode/plugins/model-context-protocol.md) — плагин · ★ 2858 у репозитория
- [model-context-protocol-mcp-expert](https://affpapa.org/nevibecode/plugins/model-context-protocol-mcp-expert.md) — плагин · ★ 1013 у репозитория

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
