Pular para o conteúdo
ReviewRamble

A newsletter semanal

IA, analisada, na sua caixa de entrada.

  • Novas análises de ferramentas, modelos, servidores MCP e repositórios, com o veredicto logo no início
  • Preços e notas reconferidos quando algo muda
  • Novos artigos de análise assim que são publicados

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail

Keycloak

Servidor de identidade da CNCF para login, SSO e OAuth que agora documenta como atuar como servidor de autorização para clientes MCP.

Análise de ReviewRamble editors · Atualizado

Ver no GitHub Código aberto

Compartilhe esta página:XLinkedInFacebookRedditWhatsAppE-mail

Nossa nota

4.3/5

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.

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.

Você faz o Keycloak? Mostre esta nota no seu siteKeycloak com nota 4.3 de 5 no ReviewRamble