Pular para o conteúdo

Agentes fazem só o que você permitir

  • Antes do MCP server, avaliamos cada tool call na hora, com os argumentos e atributos confiáveis das suas APIs
  • O agente nunca vê a chave do servidor
  • Toda recusa traz o motivo e a regra que barrou a chamada
  • Seu agente e seu IdP continuam como estão
IDPEMITIRCREDENCIAL0203040403020101
AUTORIZAÇÃO NO DETALHE
ACESSO ÀS TOOLS
ACESSO AO MCP SERVER
QUEM AGE E POR QUEM
TRACING
SEMCREDENCIAL,SEM ENTRADAMCP

Agentes fazem só o que você permitir

  • Antes do MCP server, avaliamos cada tool call na hora, com os argumentos e atributos confiáveis das suas APIs
  • O agente nunca vê a chave do servidor
  • Toda recusa traz o motivo e a regra que barrou a chamada
  • Seu agente e seu IdP continuam como estão

04AUTORIZAÇÃO NO DETALHE

A regra avalia a chamada no instante em que ela acontece.

  • Condições em CEL sobre a chamada
  • Atributos confiáveis das suas fontes de contexto
  • Sem resposta da fonte, a chamada é bloqueada

03ACESSO ÀS TOOLS

A permissão é dada tool a tool, nunca ao servidor inteiro.

  • Tool nova começa bloqueada
  • Recursos liberados um a um, além da tool

02ACESSO AO MCP SERVER

Cada agente enxerga só os MCP servers liberados para ele.

  • Tools revisadas antes de qualquer acesso
  • Ambientes Sandbox e Production separados

01QUEM AGE E POR QUEM

O agente prova quem é, e a pessoa autoriza o que ele faz em nome dela. Sem esse aval, nenhuma chamada passa.

  • Pessoa autenticada pelo seu IdP
  • Delegação com consentimento
  • Revogação vale na próxima chamada

04AUTORIZAÇÃO NO DETALHE

A regra avalia a chamada no instante em que ela acontece.

03ACESSO ÀS TOOLS

A permissão é dada tool a tool, nunca ao servidor inteiro.

02ACESSO AO MCP SERVER

Cada agente enxerga só os MCP servers liberados para ele.

01QUEM AGE E POR QUEM

O agente prova quem é, e a pessoa autoriza o que ele faz em nome dela. Sem esse aval, nenhuma chamada passa.

TRACING

Toda chamada, permitida ou negada, entra no trace com o motivo de cada passo. O export vai por OpenTelemetry (OTLP) ou webhook para o seu SIEM.

Hoje, o token do agente abre todas as tools do MCP server

O token não sabe qual tarefa o agente recebeu nem para quem ele trabalha. Juntamos as regras num só lugar e conferimos cada tool call antes que ela chegue ao servidor.

Regras espalhadasCada agente e cada MCP server guarda os próprios ifs de permissão, e ninguém revisa o conjunto.
REGRAS FORA DO CÓDIGO

As tools, os recursos e as condições de cada agente ficam num modelo só, fora do alcance dele. Cada publicação guarda o autor, a data e o que mudou.

Acesso amploO token libera todas as tools do MCP server e aceita qualquer argumento. Um estorno de 50 passa do mesmo jeito que um de 50 mil.
LIMITES NOS ARGUMENTOS

Cada tool é concedida por agente e por pessoa, com limites de valor ou de conta. Uma revogação vale já na chamada seguinte e, se a consulta de atributos falhar, a chamada não passa.

Difícil de explicarQuando um agente erra, nenhum registro liga a chamada à pessoa e à regra que a liberou.
O PORQUÊ DE CADA BLOQUEIO

Quem foi barrado recebe uma referência curta, por exemplo bdrr-e2kj. No Admin, ela mostra o agente, a pessoa, a tool e a regra que parou a chamada. Não gravamos argumentos, respostas nem tokens.

REPORT-ONLY

Comece só observando. Avaliamos cada chamada e anotamos o que teria sido negado, sem interromper nada. Ligue o bloqueio quando a lista mostrar apenas as chamadas que você quer parar.

Ficamos entre o agente e o MCP server

Toda tool call passa pela política antes de chegar ao servidor, seja de um agente de código, seja de um serviço headless.

INTERACTIVE AGENTS

  • Claude CodeAnthropic
  • CodexOpenAI

HEADLESS AGENTS

  • Custom agentsFastMCP
  • LangGraphLangChain
  • ADKGoogle

Só tools MCP

COM O SEU IDPOIDC

  • Keycloak
  • Okta
  • Microsoft Entra IDBeta
  • Google WorkspaceBeta

O agente nunca vê a chave

Depois da permissão, o PEP faz a chamada no lugar do agente. O token do agente para nele, o PEP injeta a credencial do servidor de destino, e cada servidor recebe só o que precisa para atender a chamada. Os segredos ficam cifrados, com chaves que nunca saem do KMS.

O TOKEN PARA NO PEP

O token do agente nunca chega aos seus sistemas.at+jwt

CREDENTIAL INJECTION AT THE PEP
  1. Logo antes da chamada, confere de novo se o token vale e se a ferramenta continua aprovadaiss · exp · catalog
  2. Servidor de terceiros: usa o token OAuth ou a API key dele, cifrada com a chave do ambienteenvelope encryption · KMS
  3. Seu servidor: recebe um token feito só para ele, com a pessoa e o agente, assinado no KMSJWT · aud (RFC 8707) · sub · act
SERVIDOR MCP DE TERCEIROSSTORED CREDENTIAL

Recebe a credencial da conta que conectou o servidor e aplica as permissões dessa conta. Não vê a pessoa nem o agente: isso é verificado antes, pela política.OAuth · API key

SEU SERVIDOR MCPAUDIENCE-BOUND TOKEN

Confere se o token é legítimo e feito para ele, e pode filtrar o resultado por pessoa e agente.iss · aud · exp · JWKS

Arquitetura PEP · PIP · PDP · PAP na documentação

Quem pode chamar o quê, e com quais valores

Cada chamada, venha do Claude Code ou de um serviço headless, só segue se a tool estiver liberada para o agent, se o argumento constar nos allowed values e se as dynamic conditions aceitarem. Quando uma regra precisa de contexto dinâmico, ela pode requisitar um dado confiável externo que você mapeia.

INTERACTIVEClaude CodeHEADLESSrefund-serviceAGENTsupport-agentALLOWED VALUEorder_id = A-1042RULEamount <= refund_limitTRUSTED ATTRIBUTErefund_limit: 500TOOLrefund_orderRULEuser_group in groupsTRUSTED ATTRIBUTEgroups:['suporte-n2','suporte-n3']TOOLget_orderAPIFinance APIAPIPeople APIINTERACTIVEClaude CodeHEADLESSrefund-serviceAGENTsupport-agentALLOWED VALUEorder_id =A-1042RULEamount <=refund_limitTRUSTED ATTRIBUTErefund_limit:500TOOLrefund_orderRULEuser_group ingroupsTRUSTED ATTRIBUTEgroups:['suporte-n2','suporte-n3']TOOLget_orderFinancePeople

Um estorno acima de 500 não passa

Perguntas frequentes

01O Xokepoint substitui nosso provedor de identidade?+

Não. Mantenha seu provedor OIDC, como Microsoft Entra ID, Google Workspace, Keycloak ou Okta. A identidade informa quem está atuando; o Xokepoint avalia o que o agente pode fazer.

02É SaaS ou roda na nossa infraestrutura?+

SaaS. O Xokepoint opera o gateway e o plano de controle; seus servidores MCP, APIs e provedor de identidade continuam onde estão.

03Precisamos mudar o código do agente?+

Não. Um agente de código, como Claude Code ou Codex, conecta e faz login. Um agente headless no seu serviço passa a apontar para o endpoint MCP do Xokepoint em vez do servidor, e o código continua igual.

04O que o Xokepoint controla no MCP?+

O Xokepoint permite definir quais agentes acessam servidores MCP e executam ferramentas específicas. A autorização é avaliada por ação, não apenas na conexão ao servidor.

05O Xokepoint vê o que acontece dentro do MCP server?+

Não. O Xokepoint verifica a chamada antes de ela chegar ao servidor. Lá dentro, o servidor mantém as próprias permissões, e uma tool que chama outra API com credencial própria fica fora do nosso alcance.

06Dá para limitar o que uma ação faz, como um valor?+

Sim. Além de quem pode chamar qual ferramenta sobre qual recurso, uma condição em CEL pode checar os argumentos e atributos confiáveis das suas APIs, como um limite de reembolso ou o estado de uma conta.

07Como cortamos o acesso de um agente na hora?+

Desative o agente no Admin. Ele não recebe novo token, e a próxima chamada dele é recusada.

08Um agente consegue chamar o MCP server direto?+

Seu MCP server só aceita o token que o Xokepoint emite para ele, então uma chamada direta é recusada. Em servidores de terceiros, a credencial fica com o Xokepoint e o agente nunca a recebe; basta não entregar ao agente outra credencial do mesmo serviço.

09O que acontece se o Xokepoint ficar fora do ar?+

As chamadas protegidas param. Uma falha do nosso lado nunca libera acesso: sem verificação, a chamada não segue.

10Dá para auditar por que um agente conseguiu fazer algo?+

Sim. Cada chamada verificada registra o agente, a pessoa em nome de quem ele agiu, a revisão de permissão vigente e o motivo. As mudanças de permissão ficam num histórico imutável, com autor e nota.