Keycloak의 개요
Keycloak은 오픈소스 ID 및 접근 관리 서버입니다. 로그인, 싱글 사인온, 소셜 및 기업 ID 제공자, LDAP와 Active Directory 연동, 2단계 인증, 세밀한 권한 부여를 OpenID Connect, OAuth 2.0, SAML 2.0으로 처리하며, 운영자용 관리 콘솔과 사용자용 계정 콘솔을 갖췄습니다. Java로 작성되었고 라이선스는 Apache-2.0이며, Cloud Native Computing Foundation의 인큐베이션 프로젝트입니다. 26.8.2는 2026년 11월 5일에 나왔습니다.
AI와의 관련성은 최근 일이며 주로 MCP에 관한 것입니다. 2026년 1월 6일 출시된 Keycloak 26.5.0은 Keycloak을 MCP 서버의 권한 부여 서버로 쓰는 가이드를 추가하면서 VS Code, Claude Code, Claude Desktop, MCP Inspector용 클라이언트별 안내를 담았고, JWT Authorization Grant(RFC 7523)를 프리뷰로 도입했습니다. 별도의 실험적 기능인 Identity Assertion JWT Authorization Grant는 MCP 클라이언트가 사용자의 ID 어설션을 도구 서버 하나로 범위가 제한된 토큰으로 바꿀 수 있게 해, 다시 로그인하지 않아도 됩니다.
Keycloak, 쓸 만한 가치가 있습니까?
Keycloak은 MCP 권한 부여 규칙이 ID 제공자에게 기대하는 것 대부분을 라이선스 비용 없이 이미 제공합니다. MCP 가이드는 OAuth 2.1, 권한 부여 서버 메타데이터(RFC 8414), 발급자 식별(RFC 9207), 동적 클라이언트 등록(RFC 7591)을 지원한다고 표시하며, 이 조합 덕분에 Claude Code나 VS Code가 Keycloak을 찾아 스스로 등록하고 사용자에게 묶인 토큰을 받을 수 있어, 관리자가 개발자마다 클라이언트를 만들 필요가 없습니다. 많은 사내 MCP 서버가 아직 쓰는 공유 API 키보다 훨씬 앞선 방식입니다.
세부 조건이 중요합니다. 완전한 준수는 MCP 사양 2025-03-26에 대해서만 내세우며, 2025-06-18, 2025-11-25, 2026-07-28은 실험적입니다. 토큰을 MCP 서버 하나에 묶는 리소스 인디케이터(RFC 8707)와 클라이언트 ID 메타데이터 문서도 실험적이며, 둘 다 문서상 이후 버전에서 깨질 수 있다는 기능 플래그 뒤에 있습니다. 리소스 인디케이터 없이는 클라이언트 스코프로 대상(audience)을 묶습니다. ChatGPT의 클라이언트 메타데이터는 지원하지 않으며, Claude Code와 Claude Desktop은 클라이언트 정책 하나를 공유하지 않으면 서로를 거부합니다. 에이전트 위임 기능도 아직 초기 단계입니다. Identity Assertion JWT Authorization Grant는 실험적이며 문서는 프로덕션에서 쓰지 말라고 합니다.
주의할 점: 빠른 시작이 프로덕션까지 흘러가면 함정이 됩니다. bin/kc.sh start-dev는 암호화되지 않은 HTTP를 켜고, 엄격한 호스트 이름 검사를 끄고, 로컬 캐시를 쓰며, 데이터를 dev-file 데이터베이스에 저장합니다. 문서는 이 데이터베이스가 프로덕션에 맞지 않으며 반드시 교체해야 한다고 말합니다. WSL에서는 개발 모드가 0.0.0.0에 바인딩되므로 같은 네트워크의 다른 컴퓨터가 접근할 수 있습니다. 프로덕션 모드는 HTTPS와 호스트 이름 없이는 시작하지 않으며, PostgreSQL, MariaDB, MySQL, SQL Server, Oracle 같은 지원 데이터베이스가 필요합니다. 또 Keycloak은 모든 자격 증명과 서명 키를 보관하므로 업그레이드와 패치는 선택이 아니며, 그 부담을 덜어 줄 호스팅 서비스를 프로젝트는 제공하지 않습니다.
결론: 에이전트가 여러 사내 도구에 걸쳐 실제 직원을 대신해 움직여야 한다면, Keycloak은 그 위에 쌓을 무료이자 표준에 충실한 ID 계층입니다. agentgateway나 ToolHive 같은 게이트웨이를 MCP 서버 앞에 두고, 사용자가 누구인지는 Keycloak이 판단하게 하면 됩니다.
제 역할을 하는 곳
사내 MCP 서버를 운영하는 직원 300명 규모 회사의 플랫폼 팀
MCP 서버가 응답하기 전에 Claude Code 사용자가 회사 SSO로 로그인하게 하기
Keycloak을 MCP 권한 부여 서버로 등록하고, 동적 클라이언트 등록을 켠 뒤, 각 MCP 서버 URL과 일치하는 대상을 가진 클라이언트 스코프를 추가합니 다. Keycloak은 무료이며, 비용은 프로덕션 클러스터와 그 데이터베이스입니다.
사내 도구를 호출하는 AI 어시스턴트를 검토하는 보안 엔지니어
유출된 토큰 하나가 모든 도구 서버에서 통하지 않게 막기
실험적 플래그인 리소스 인디케이터나 서버별 대상 스코프로 각 토큰을 MCP 서버 하나에 묶고, 토큰 수명을 짧게 유지합니다. 실험적 플래그는 바뀔 수 있으므로 업그레이드할 때마다 다시 테스트합니다.
노트북에서 에이전트를 시제품으로 만드는 개발자
오후 한나절에 로컬에서 OAuth를 동작시키기
docker run quay.io/keycloak/keycloak start-dev로 몇 분 만에 동작하는 서버를 얻습니다. localhost에만 두고, 다른 사람이 접속하기 전에 HTTPS, 호스트 이름, PostgreSQL을 갖춘 프로덕션 모드로 다시 구성합니다.
도입 전 확인할 점
- 설정
- 테스트 서버라면 배포본을 풀고 bin/kc.sh start-dev를 실행하거나 docker run quay.io/keycloak/keycloak start-dev를 씁니다. 프로덕션은 HTTPS, 설정된 호스트 이름, 외부 데이터베이스와 함께 bin/kc.sh start를 씁니다.
- 연동
- OpenID Connect, OAuth 2.0, SAML 2.0 애플리케이션, LDAP와 Active Directory, 소셜 및 OpenID Connect나 SAML ID 제공자, VS Code, Claude Code, Claude Desktop, MCP Inspector 같은 MCP 클라이언트.
- 데이터와 개인정보
- 자체 호스팅이므로 사용자 기록, 세션, 키가 자체 데이터베이스에 남습니다. Keycloak은 자격 증명과 서명 키를 보관하는 가치 높은 표적이며, 취약점은 프로젝트의 GitHub 보안 정책에 따라 보고됩니다.
- 대규모 사용 시 비용
- Apache-2.0이라 라이선스 비용이 없습니다. 비용은 서버, 지원 데이터베이스, 그리고 클러스터링과 업그레이드, 보안 패치에 드는 인력 시간입니다.
- 제한
- 2025-03-26 이후의 MCP 사양, 리소스 인디케이터, 클라이언트 ID 메타데이터 문서, ID-JAG는 실험적이며, ChatGPT 클라이언트 메타데이터는 지원하지 않고, dev-file 데이터베이스는 프로덕션용이 아닙니다.
좋은 점
- MCP용 OAuth 2.1, RFC 8414, RFC 9207, 동적 클라이언트 등록 지원
- Claude Code, Claude Desktop, VS Code 설정이 문서화됨
- 성숙한 SSO, LDAP 및 Active Directory 연동, 2단계 로그인
- Apache-2.0이고 CNCF 프로젝트이며 유료 요금제 없음
아쉬운 점
- MCP 사양 2025-03-26만 완전 지원하며 이후 버전은 실험적
- ID-JAG를 통한 에이전트 위임은 실험적이라 프로덕션용이 아님
- 개발 모드는 암호화되지 않은 HTTP와 프로덕션용이 아닌 데이터베이스로 동작
- ChatGPT 클라이언트 메타데이터 미지원
추천 대상
ID 시스템을 자체 호스팅하면서 MCP 서버와 AI 에이전트가 각 사용자의 권한으로 동작하길 원하는 플랫폼 팀과 보안 팀.
Keycloak 대안
Keycloak: 자주 묻는 질문
- Keycloak, 쓸 만한 가치가 있습니까?
- Keycloak은 에이전트가 누구를 대신해 움직이는지에 대한 합리적인 자체 호스팅 해법입니다. 단, 최신 MCP 및 에이전트 기능은 프리뷰로 취급하고 개발 모드는 절대 배포하지 않는다는 전제입니다. 평점은 5점 만점에 4.3점입니다.
- Keycloak의 가격은 얼마입니까?
- Apache-2.0 무료 오픈소스입니다. 프로젝트에 유료 요금제는 없으며, 비용은 호스팅, 데이터베이스, 운영 인력입니다.
- Keycloak의 단점은 무엇입니까?
- MCP 사양 2025-03-26만 완전 지원하며 이후 버전은 실험적; ID-JAG를 통한 에이전트 위임은 실험적이라 프로덕션용이 아님; 개발 모드는 암호화되지 않은 HTTP와 프로덕션용이 아닌 데이터베이스로 동작; ChatGPT 클라이언트 메타데이터 미지원.
- Keycloak에 적합한 사람은 누구입니까?
- ID 시스템을 자체 호스팅하면서 MCP 서버와 AI 에이전트가 각 사용자의 권한으로 동작하길 원하는 플랫폼 팀과 보안 팀.
- 팀이나 프로덕션 환경에서 Keycloak의 비용은 얼마입니까?
- Apache-2.0이라 라이선스 비용이 없습니다. 비용은 서버, 지원 데이터베이스, 그리고 클러스터링과 업그레이드, 보안 패치에 드는 인력 시간입니다.
- Keycloak에 회사 데이터를 맡겨도 안전합니까?
- 자체 호스팅이므로 사용자 기록, 세션, 키가 자체 데이터베이스에 남습니다. Keycloak은 자격 증명과 서명 키를 보관하는 가치 높은 표적이며, 취약점은 프로젝트의 GitHub 보안 정책에 따라 보고됩니다.
- Keycloak의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 agentgateway 및 ToolHive입니다.
답변 확인일: 2026년 11월 18일.