O que é Keycloak?
O Keycloak é um servidor de gestão de identidade e acesso de código aberto. Ele cuida de login, single sign-on, provedores de identidade sociais e corporativos, federação com LDAP e Active Directory, autenticação em dois fatores e autorização detalhada sobre OpenID Connect, OAuth 2.0 e SAML 2.0, com um console de administração para operadores e um console de conta para usuários. É escrito em Java, tem licença Apache-2.0 e é um projeto em incubação da Cloud Native Computing Foundation; a 26.8.2 saiu em 5 de novembro de 2026.
A relevância dele para IA é recente e gira principalmente em torno do MCP. O Keycloak 26.5.0, lançado em 6 de janeiro de 2026, trouxe um guia para usar o Keycloak como servidor de autorização de servidores MCP, com notas de cliente para VS Code, Claude Code, Claude Desktop e MCP Inspector, e introduziu o JWT Authorization Grant (RFC 7523) como prévia. Um recurso separado e experimental, o Identity Assertion JWT Authorization Grant, permite que um cliente MCP troque a asserção de identidade de um usuário por um token limitado a um único servidor de ferramentas, sem novo login.
Keycloak vale a pena?
O Keycloak já dá a um servidor MCP quase tudo o que as regras de autorização do protocolo esperam de um provedor de identidade, sem custo de licença. O guia de MCP dele marca como suportados OAuth 2.1, metadados do servidor de autorização (RFC 8414), identificação do emissor (RFC 9207) e registro dinâmico de clientes (RFC 7591), que juntos permitem que Claude Code ou VS Code descubram o Keycloak, se registrem e obtenham um token vinculado ao usuário sem que um administrador crie um cliente por desenvolvedor. É um avanço grande em relação às chaves de API compartilhadas que muitos servidores MCP internos ainda usam.
As letras miúdas importam. A conformidade total só é declarada para a especificação MCP 2025-03-26; 2025-06-18, 2025-11-25 e 2026-07-28 são experimentais, assim como os indicadores de recurso (RFC 8707), que vinculam um token a um único servidor MCP, e os documentos de metadados de ID de cliente, ambos atrás de flags que, segundo a documentação, podem quebrar em versões futuras. Sem indicadores de recurso, você define a audiência por um client scope. Os metadados de cliente do ChatGPT não são suportados, e Claude Code e Claude Desktop se rejeitam mutuamente se não compartilharem uma política de cliente. As peças de delegação para agentes também são novas: o Identity Assertion JWT Authorization Grant é experimental e a documentação diz para não usá-lo em produção.
O porém: o início rápido vira armadilha se chegar à produção. bin/kc.sh start-dev ativa HTTP sem criptografia, desliga a verificação estrita de hostname, usa cache local e grava os dados no banco dev-file, que a documentação diz não ser adequado para produção e precisar ser substituído. No WSL, o modo de desenvolvimento escuta em 0.0.0.0, então outras máquinas da sua rede podem alcançá-lo. O modo de produção se recusa a iniciar sem HTTPS e hostname, e exige um banco suportado como PostgreSQL, MariaDB, MySQL, SQL Server ou Oracle. O Keycloak também guarda todas as credenciais e chaves de assinatura, então atualizar e aplicar patches não é opcional, e o projeto não oferece um serviço hospedado para tirar esse trabalho das suas mãos.
Nossa opinião: quando agentes precisam agir em nome de funcionários reais em várias ferramentas internas, o Keycloak é a camada de identidade gratuita e fiel aos padrões sobre a qual construir; um gateway como agentgateway ou ToolHive pode ficar na frente dos servidores MCP, enquanto o Keycloak decide quem é o usuário.
Onde ele se destaca
Uma equipe de plataforma em uma empresa de 300 pessoas que roda servidores MCP internos
Fazer os usuários do Claude Code entrarem com o SSO da empresa antes que um servidor MCP responda
Registre o Keycloak como servidor de autorização MCP, ative o registro dinâmico de clientes e adicione um client scope cuja audiência corresponda à URL de cada servidor MCP. O Keycloak é gratuito; o custo é um cluster de produção e o banco de dados dele.
Uma engenheira de segurança revisando um assistente de IA que chama ferramentas internas
Impedir que um token vazado funcione contra todos os servidores de ferramentas
Vincule cada token a um único servidor MCP com indicadores de recurso, uma flag experimental, ou com um scope de audiência por servidor, e mantenha os tokens de curta duração. Teste de novo após cada atualização, já que flags experimentais podem mudar.
Um desenvolvedor prototipando um agente no notebook
Fazer o OAuth funcionar localmente em uma tarde
docker run quay.io/keycloak/keycloak start-dev entrega um servidor funcionando em minutos. Mantenha-o em localhost e recrie em modo de produção com HTTPS, hostname e PostgreSQL antes que mais alguém se conecte.
Antes de decidir
- Configuração
- Descompacte a distribuição e rode bin/kc.sh start-dev, ou docker run quay.io/keycloak/keycloak start-dev, para um servidor de testes. A produção usa bin/kc.sh start com HTTPS, hostname configurado e um banco externo.
- Integrações
- Aplicações OpenID Connect, OAuth 2.0 e SAML 2.0; LDAP e Active Directory; provedores de identidade sociais e OpenID Connect ou SAML; clientes MCP como VS Code, Claude Code, Claude Desktop e MCP Inspector.
- Dados e privacidade
- Auto-hospedado: registros de usuários, sessões e chaves ficam no seu banco de dados. O Keycloak guarda credenciais e chaves de assinatura, então é um alvo valioso; vulnerabilidades são reportadas pela política de segurança do projeto no GitHub.
- Custo em escala
- Sem taxa de licença sob Apache-2.0. O custo são servidores, um banco suportado e o tempo da equipe para clustering, atualizações e patches de segurança.
- Limites
- Versões da especificação MCP após 2025-03-26, indicadores de recurso, documentos de metadados de ID de cliente e ID-JAG são experimentais; os metadados de cliente do ChatGPT não são suportados; o banco dev-file não é para produção.
O que é bom
- Suporta OAuth 2.1, RFC 8414, RFC 9207 e registro dinâmico de clientes para MCP
- Configuração documentada para Claude Code, Claude Desktop e VS Code
- SSO maduro, federação com LDAP e Active Directory e login em dois fatores
- Apache-2.0 e projeto da CNCF, sem plano pago
O que não é
- Só a especificação MCP 2025-03-26 é totalmente suportada; as posteriores são experimentais
- A delegação de agentes via ID-JAG é experimental, não para produção
- O modo de desenvolvimento roda HTTP sem criptografia em um banco que não é para produção
- Sem suporte aos metadados de cliente do ChatGPT
Ideal para
Equipes de plataforma e segurança que hospedam a própria identidade e querem que servidores MCP e agentes de IA ajam com as permissões de cada usuário.
Alternativas ao Keycloak
Keycloak: perguntas frequentes
- Keycloak vale a pena?
- O Keycloak é a resposta auto-hospedada sensata para saber em nome de quem um agente age, desde que você trate os recursos mais novos de MCP e de agentes como prévias e nunca coloque o modo de desenvolvimento em produção. Damos nota 4.3 de 5.
- Quanto custa Keycloak?
- Gratuito e de código aberto sob Apache-2.0. O projeto não vende plano pago; você paga hospedagem, um banco de dados e as pessoas que o operam.
- Quais são as desvantagens de Keycloak?
- Só a especificação MCP 2025-03-26 é totalmente suportada; as posteriores são experimentais; a delegação de agentes via ID-JAG é experimental, não para produção; o modo de desenvolvimento roda HTTP sem criptografia em um banco que não é para produção; sem suporte aos metadados de cliente do ChatGPT.
- Para quem Keycloak é indicado?
- Equipes de plataforma e segurança que hospedam a própria identidade e querem que servidores MCP e agentes de IA ajam com as permissões de cada usuário.
- Quanto custa Keycloak para uma equipe ou em produção?
- Sem taxa de licença sob Apache-2.0. O custo são servidores, um banco suportado e o tempo da equipe para clustering, atualizações e patches de segurança.
- Keycloak é seguro para dados da empresa?
- Auto-hospedado: registros de usuários, sessões e chaves ficam no seu banco de dados. O Keycloak guarda credenciais e chaves de assinatura, então é um alvo valioso; vulnerabilidades são reportadas pela política de segurança do projeto no GitHub.
- Quais são as melhores alternativas ao Keycloak?
- As alternativas mais próximas que analisamos são agentgateway e ToolHive.
Respostas verificadas em 18 de nov. de 2026.