# 安装 Keycloak Admin

- 类型: MCP 工具
- 说明: Administer Keycloak via its Admin REST API: users, roles, clients, groups, IdP, events.
- 仓库: https://github.com/mrz1880/mcp-keycloak-admin

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "Keycloak Admin" MCP 服务：
执行：claude mcp add 'io-github-mrz1880-mcp-keycloak-admin' -- npx -y mcp-keycloak-admin
```

### Codex
```
请帮我安装 askskill 上的 "Keycloak Admin" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-mrz1880-mcp-keycloak-admin]
command = "npx"
args = ["-y","mcp-keycloak-admin"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "Keycloak Admin" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-mrz1880-mcp-keycloak-admin": { "command": "npx", "args": ["-y","mcp-keycloak-admin"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env KEYCLOAK_BASE_URL=YOUR_VALUE --env KEYCLOAK_REALM=YOUR_VALUE --env AUTH_MODE=YOUR_VALUE --env KC_CLIENT_ID=YOUR_VALUE --env KC_CLIENT_SECRET=YOUR_VALUE --env KC_ADMIN_USERNAME=YOUR_VALUE --env KC_ADMIN_PASSWORD=YOUR_VALUE --env KC_ADMIN_REALM=YOUR_VALUE --env READ_ONLY=YOUR_VALUE --env ALLOWED_REALMS=YOUR_VALUE --transport stdio io-github-mrz1880-mcp-keycloak-admin -- npx -y mcp-keycloak-admin
```
需要环境变量：KEYCLOAK_BASE_URL, KEYCLOAK_REALM, AUTH_MODE, KC_CLIENT_ID, KC_CLIENT_SECRET, KC_ADMIN_USERNAME, KC_ADMIN_PASSWORD, KC_ADMIN_REALM, READ_ONLY, ALLOWED_REALMS

### Codex
```bash
codex mcp add --env KEYCLOAK_BASE_URL=YOUR_VALUE --env KEYCLOAK_REALM=YOUR_VALUE --env AUTH_MODE=YOUR_VALUE --env KC_CLIENT_ID=YOUR_VALUE --env KC_CLIENT_SECRET=YOUR_VALUE --env KC_ADMIN_USERNAME=YOUR_VALUE --env KC_ADMIN_PASSWORD=YOUR_VALUE --env KC_ADMIN_REALM=YOUR_VALUE --env READ_ONLY=YOUR_VALUE --env ALLOWED_REALMS=YOUR_VALUE io-github-mrz1880-mcp-keycloak-admin -- npx -y mcp-keycloak-admin
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-mrz1880-mcp-keycloak-admin]
command = "npx"
args = ["-y","mcp-keycloak-admin"]

[mcp_servers.io-github-mrz1880-mcp-keycloak-admin.env]
KEYCLOAK_BASE_URL = "YOUR_VALUE"
KEYCLOAK_REALM = "YOUR_VALUE"
AUTH_MODE = "YOUR_VALUE"
KC_CLIENT_ID = "YOUR_VALUE"
KC_CLIENT_SECRET = "YOUR_VALUE"
KC_ADMIN_USERNAME = "YOUR_VALUE"
KC_ADMIN_PASSWORD = "YOUR_VALUE"
KC_ADMIN_REALM = "YOUR_VALUE"
READ_ONLY = "YOUR_VALUE"
ALLOWED_REALMS = "YOUR_VALUE"
```
需要环境变量：KEYCLOAK_BASE_URL, KEYCLOAK_REALM, AUTH_MODE, KC_CLIENT_ID, KC_CLIENT_SECRET, KC_ADMIN_USERNAME, KC_ADMIN_PASSWORD, KC_ADMIN_REALM, READ_ONLY, ALLOWED_REALMS

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-mrz1880-mcp-keycloak-admin": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-keycloak-admin"
      ],
      "env": {
        "KEYCLOAK_BASE_URL": "YOUR_VALUE",
        "KEYCLOAK_REALM": "YOUR_VALUE",
        "AUTH_MODE": "YOUR_VALUE",
        "KC_CLIENT_ID": "YOUR_VALUE",
        "KC_CLIENT_SECRET": "YOUR_VALUE",
        "KC_ADMIN_USERNAME": "YOUR_VALUE",
        "KC_ADMIN_PASSWORD": "YOUR_VALUE",
        "KC_ADMIN_REALM": "YOUR_VALUE",
        "READ_ONLY": "YOUR_VALUE",
        "ALLOWED_REALMS": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-mrz1880-mcp-keycloak-admin&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1rZXljbG9hay1hZG1pbiJdLCJlbnYiOnsiS0VZQ0xPQUtfQkFTRV9VUkwiOiJZT1VSX1ZBTFVFIiwiS0VZQ0xPQUtfUkVBTE0iOiJZT1VSX1ZBTFVFIiwiQVVUSF9NT0RFIjoiWU9VUl9WQUxVRSIsIktDX0NMSUVOVF9JRCI6IllPVVJfVkFMVUUiLCJLQ19DTElFTlRfU0VDUkVUIjoiWU9VUl9WQUxVRSIsIktDX0FETUlOX1VTRVJOQU1FIjoiWU9VUl9WQUxVRSIsIktDX0FETUlOX1BBU1NXT1JEIjoiWU9VUl9WQUxVRSIsIktDX0FETUlOX1JFQUxNIjoiWU9VUl9WQUxVRSIsIlJFQURfT05MWSI6IllPVVJfVkFMVUUiLCJBTExPV0VEX1JFQUxNUyI6IllPVVJfVkFMVUUifX0
需要环境变量：KEYCLOAK_BASE_URL, KEYCLOAK_REALM, AUTH_MODE, KC_CLIENT_ID, KC_CLIENT_SECRET, KC_ADMIN_USERNAME, KC_ADMIN_PASSWORD, KC_ADMIN_REALM, READ_ONLY, ALLOWED_REALMS