Conectar Claude, Cursor e outros clientes ao MCP Gateway

O MCP Gateway expõe o 4Keyless como um servidor Model Context Protocol. Um cliente de IA conectado a ele descobre os acessos que o agente alcança, chama ferramentas e abre sistemas sem configurar proxy nem certificado. As liberações, a injeção de credencial e o registro de acesso são os mesmos do proxy.

Quem entra e como

A tela de autorização do 4Keyless está em inglês. Com e-mail: Work email, Send code, o código em Sign-in code e Authorize. Se o e-mail tiver acesso em mais de uma empresa, você escolhe qual autorizar. Para usar a chave de bot, clique em Use an Agent API key instead, cole em Agent API key e clique em Authorize.

A chave de bot é criada no painel, em Agentes. Veja Ligar um agente de IA.

Claude (Desktop, claude.ai e celular)

1. Nas configurações de conectores do Claude, adicione um conector personalizado com a URL https://mcp.4keyless.io/mcp.
2. Ao conectar, o Claude abre a tela de autorização do 4Keyless. Entre com e-mail e código, ou cole a chave do agente bot.

O conector personalizado é chamado pela infraestrutura da Anthropic, não pela sua máquina: por isso ele exige o endereço público, com HTTPS.

Claude Code

Com OAuth (abre o navegador na primeira vez; no Claude Code, /mcp mostra o estado e refaz o login):

claude mcp add --transport http 4keyless https://mcp.4keyless.io/mcp

Com a chave de um agente bot:

claude mcp add --transport http 4keyless https://mcp.4keyless.io/mcp \
  --header "Authorization: Bearer $FKL_AGENT_KEY"

O shell expande $FKL_AGENT_KEY nesse momento e o Claude Code guarda o valor na configuração dele. Trate esse arquivo como segredo.

Cursor e outros clientes com cabeçalho

No Cursor, em .cursor/mcp.json (do projeto) ou ~/.cursor/mcp.json:

{
  "mcpServers": {
    "4keyless": {
      "url": "https://mcp.4keyless.io/mcp",
      "headers": { "Authorization": "Bearer ${env:FKL_AGENT_KEY}" }
    }
  }
}

Outros clientes seguem a mesma ideia: URL do gateway e o cabeçalho Authorization com a chave do agente bot. O gateway também aceita a chave em Proxy-Authorization, nos formatos do proxy.

Limitar a um acesso

Sem parâmetro, o gateway junta as ferramentas de todos os acessos MCP liberados, com o nome do acesso como prefixo (por exemplo gmail__send_email). Para um acesso só, acrescente o id dele:

https://mcp.4keyless.io/mcp?system=5482827c-2dbd-45b7-90cc-865976ce236d

O id vem de GET /api/systems na Agent API ou da tela do acesso no painel. O nome exato do acesso também funciona, mas o id não muda quando alguém renomeia o acesso.

O que o agente encontra

As ferramentas de servidores MCP só aparecem com uma política MCP ativa: o gateway nega tudo o que não foi liberado.

No painel

A tela MCP Gateway fica no painel completo e aparece para todos os papéis, menos o gestor. Nela você:

• copia a URL do gateway (o quadro Conecte seu cliente MCP ao 4Keyless aparece quando já existe um acesso do tipo MCP);
• cria as políticas que dizem quais grupos de agentes chamam quais ferramentas de cada servidor MCP, na aba Políticas, com Nova política MCP;
• vê os servidores MCP cadastrados, na aba Servidores MCP;
• escreve e exporta skills, na aba Skills.

Para cadastrar um servidor MCP como acesso, crie um acesso do tipo MCP em Acessos. Para dar ao agente acesso aos sistemas web e de API, use as liberações de sempre: Liberar um acesso.

Se algo der errado

O cliente não lista nenhuma ferramenta além das 4keyless__. Falta política MCP para o grupo do agente, ou a empresa ainda não tem acesso do tipo MCP. Confira a aba Políticas.

A chamada fica parada e depois falha. A liberação está em modo de aprovação. Alguém precisa aprovar em Notificações; quem aprova pode liberar por um período, e aí as próximas chamadas daquela ferramenta passam direto.

Erro de ferramenta começando com um código, como policy_denied:. O código diz o motivo. Veja Erros e limites.