https://mcp.gyramais.com.br. Você configura só o cliente (Claude.ai, Claude Desktop, Cursor, etc.) e entra com o seu próprio login da plataforma: o mesmo e-mail e senha (ou a mesma conta Google) que você usa no toolbox. Nada de credencial separada, nada de abrir chamado. E, principalmente: o agente enxerga exatamente o que você enxerga.Entre com o seu login
Não existe credencial específica de MCP. Você entra do mesmo jeito que entra no toolbox:Por que isso importa
Porque o permissionamento vem junto. O agente não é um usuário privilegiado: ele é você.Mesmo escopo, sem configuração
Auditoria com nome e sobrenome
Onboarding em segundos
Offboarding que funciona
Endpoint do servidor
Opção 1, Connector remoto no Claude.ai, Claude Desktop ou Claude Code (recomendado)
Fluxo via OAuth: você adiciona o endpoint uma única vez, clica em Autenticar e a GYRA+ abre a própria página de login. Você entra com e-mail e senha ou com Google, e o Claude volta conectado. É a opção mais segura: a sua senha é digitada na página da GYRA+ e nunca fica gravada em arquivo de configuração.
Do botão Conectar até a primeira pergunta. As telas do Claude estão simplificadas e podem mudar; a tela de login é a da GYRA+.
Abrir a tela de connectors
- Claude.ai: Settings > Connectors > Add custom connector.
- Claude Desktop: Settings > Connectors > Add custom connector.
Adicionar o endpoint da GYRA+
- Name:
GYRA+ - URL:
https://mcp.gyramais.com.br
Autenticar
Entrar com o seu login
- E-mail e senha: os mesmos do toolbox. Clique em Autorizar.
- Entrar com Google: escolha a conta Google com que você entra no toolbox.
claude.ai). Confira antes de entrar. Você é redirecionado de volta ao Claude com o connector conectado, e o agente passa a operar com as suas permissões.Testar
list_reports e traz a resposta.Claude Code, connector remoto
No terminal:/mcp, escolha gyra e Authenticate. O navegador abre a mesma página de login da GYRA+ (e-mail e senha ou Google) e volta para o Claude Code conectado.
Opção 2, Stdio local (Cursor, VS Code, SDKs)
Para clientes que rodam o MCP como processo local via stdio, use o pacote@gyramais/mcp-server (binário gyra-mcp) e passe as credenciais como variáveis de ambiente.
Variáveis de ambiente
GYRA_CLIENT_ID + GYRA_CLIENT_SECRET (recomendado, com renovação automática) ou GYRA_ACCESS_TOKEN (estático, expira em 24h).
Claude Code (CLI)
Cursor
Abrir settings
Add new MCP server
- Name:
gyra - Type:
command - Command:
npx -y @gyramais/mcp-server - Env:
GYRA_CLIENT_ID=voce@suaempresa.comGYRA_CLIENT_SECRET=sua_senha
Salvar e reiniciar o Cursor
Claude Desktop, config manual via stdio
Se preferir configurar via arquivo em vez de usar o custom connector:- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
VS Code via Continue
~/.continue/config.json:
Cliente customizado (SDK)
Python:Verificação rápida
Depois de conectar, no cliente MCP:- Pergunte: “quais tools da gyra estão disponíveis?”, deve listar
create_report,list_reports,list_policies, etc. - Pergunte: “quais políticas tenho ativas?”, deve chamar
list_policiese retornar a lista.
Sessão e renovação
Você informa as credenciais uma vez. A partir daí o MCP administra a sessão sozinho:Segurança
A sua senha vira uma sessão de 24 horas e é isso que trafega nas chamadas. Ainda assim, trate a configuração com o mesmo cuidado que você trata a senha em si. Quando o stdio for necessário:- Nunca commite a configuração em repositório. Vale para
claude_desktop_config.json,config.jsondo Continue e afins. - Referencie variáveis de ambiente do sistema (
${env:GYRA_CLIENT_SECRET}) em vez de escrever a senha no JSON, quando o cliente suportar. - Não compartilhe a configuração com colegas. Cada pessoa conecta com o próprio login: é isso que faz o permissionamento e a auditoria funcionarem.
- Trocou a senha na plataforma? Atualize a configuração do MCP. As sessões em aberto continuam válidas até expirar, e a próxima renovação falha com a senha antiga.
- Suspeita de comprometimento? Troque a senha no toolbox. Isso invalida a credencial em todos os clientes conectados, sem depender de chamado.
Perguntas frequentes
Quais clientes podem usar a Opção 1 (connector remoto com login)?
Quais clientes podem usar a Opção 1 (connector remoto com login)?
Preciso instalar algo além do cliente?
Preciso instalar algo além do cliente?
npx @gyramais/mcp-server é baixado on demand. Se o ambiente não tem npm, instale Node.js 18+.Funciona offline?
Funciona offline?
Posso conectar múltiplas organizações?
Posso conectar múltiplas organizações?
mcpServers com nomes distintos (ex: gyra-orgA, gyra-orgB), cada uma com as credenciais da conta correspondente. Para connector remoto, adicione múltiplos connectors no Claude e autentique cada um com a sua conta.Repetir o mesmo e-mail em duas entradas não conecta duas organizações: as duas apontam para a mesma.Como renovar o token manualmente?
Como renovar o token manualmente?
GYRA_ACCESS_TOKEN: chame POST /auth/authenticate com os headers gyra-client-id (seu e-mail) e gyra-client-secret (sua senha) e use o accessToken retornado, válido por 24h. Com GYRA_CLIENT_ID + GYRA_CLIENT_SECRET o MCP faz isso sozinho, inclusive se a sessão cair no meio do caminho.O agente pode fazer algo que eu não posso?
O agente pode fazer algo que eu não posso?
Preciso pedir credenciais ao suporte?
Preciso pedir credenciais ao suporte?
Uso SSO (Google ou Microsoft). Como conecto?
Uso SSO (Google ou Microsoft). Como conecto?

