> For the complete documentation index, see [llms.txt](https://developers.estoca.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.estoca.com.br/mcp-estoca/authentication.md).

# Conexão e autenticação

O MCP Estoca usa **login individual**, com a mesma identidade usada no `id.estoca.com.br`. Ele não utiliza a chave de API fixa das integrações REST.

## Conectar no Claude

1. Encontre o conector **Estoca MCP** no Claude. Se estiver configurando um conector personalizado, use `https://mcp.estoca.com.br/mcp` como endereço do servidor.
2. Escolha **Conectar**. O Claude abrirá o fluxo de autorização da Estoca.
3. Entre pela página do `id.estoca.com.br` com sua própria conta. Pode ser necessário informar a senha novamente mesmo que você já esteja conectado à Plataforma.
4. Conclua a autorização e volte ao Claude. As ferramentas permitidas para sua conta ficarão disponíveis na conversa.

Não cole senha, token ou chave de API em uma conversa. O login ocorre na página da Estoca, fora do chat. O fluxo usa OAuth com código de autorização e PKCE; o conector recebe um token próprio do MCP, não sua senha.

## Como o acesso é decidido

O usuário precisa estar ativo e vinculado ao WMS. O conector identifica essa conta e o WMS determina quais ferramentas, lojas e armazéns ela pode consultar. A autorização é conferida novamente a cada chamada, inclusive quando a ferramenta já aparece na lista do assistente. Administradores têm acesso mais amplo, mas lojas de teste e churn não são incluídas no MCP.

Se você perder acesso a uma loja, armazém ou ferramenta, uma listagem antiga no Claude não autoriza novas consultas. Mudanças de associação podem levar algum tempo para aparecer devido ao cache de localidades do WMS; se precisar de revogação urgente, solicite também o bloqueio da conta no WMS.

## Para administradores de TI

Em organizações Claude Team ou Enterprise, o administrador pode precisar aprovar ou habilitar o conector antes de os membros o adicionarem. Essa aprovação permite o uso do conector na organização Claude, mas **não** concede permissões no WMS: cada pessoa ainda faz seu próprio login e usa apenas os acessos da própria conta Estoca.

O campo opcional **“Documentação de autenticação gerenciada pela empresa”** do diretório do Claude refere-se a um recurso diferente: autorização centralizada do conector pelo provedor de identidade da organização, sem login individual de cada membro. **O MCP Estoca não oferece esse modo nesta versão.** Deixe esse campo vazio; esta página descreve o login OAuth individual.

## Problemas de conexão ou mudança de acesso

* Se o login falhar, confirme que está usando a conta correta do `id.estoca.com.br` e que ela está ativa e vinculada ao WMS.
* Se as ferramentas não refletirem uma mudança recente de permissão, desconecte e conecte novamente o conector no Claude. Associações de loja e armazém também podem aguardar a atualização do cache do WMS.
* Para interromper o uso do conector, desconecte-o no Claude. Para revogar o acesso operacional da conta, peça ao administrador da Estoca para alterar ou desativar seu acesso no WMS.

Se o problema persistir, entre em contato com o [suporte da Estoca](/others/contact-us.md) informando o horário aproximado e a mensagem de erro, sem enviar senhas ou tokens.