Pular para o conteúdo principal
Use este guia para conectar o assistente de IA que você já usa ao servidor MCP (Model Context Protocol) da EcoTrust. Ao final, o assistente consulta os seus painéis com o seu usuário e as permissões do seu perfil.

Endereço do servidor

A EcoTrust hospeda o servidor, então não há nada para instalar do lado do servidor. O cliente se conecta por HTTP e você entra com a sua conta pelo navegador, com OAuth: nenhuma chave de API é colada no cliente.

Pré-requisitos

  • Um usuário na plataforma EcoTrust com acesso a pelo menos um painel, e a caixa de e-mail que recebe o Código de login.
  • Um cliente com suporte a MCP. Os passos abaixo cobrem Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex e Gemini CLI.
  • O Node.js, na versão de suporte longo (LTS), instalado no computador, para todos os clientes menos o Claude Code. Eles chegam ao servidor pela ponte mcp-remote, que o comando npx baixa e roda sozinho.

Passos

1

Adicionar o servidor ao seu cliente

Escolha o seu cliente e siga a aba dele. O nome ecotrust é como o servidor aparece no cliente, e você pode usar outro.
No terminal, adicione o servidor:
Para usar o servidor em todos os seus projetos, e não só no atual, acrescente --scope user ao comando. Depois, abra o Claude Code, digite /mcp, escolha ecotrust e clique em Authenticate para abrir o login.
2

Entrar com a sua conta EcoTrust

Na primeira conexão, o cliente abre o navegador na tela de login da EcoTrust. Entre com o seu e-mail e a sua senha e digite o código de 6 dígitos que chega no e-mail Código de login, como no acesso de sempre à plataforma.Quando o navegador avisar que a autorização deu certo, feche a aba e volte ao cliente. A partir daí, o cliente renova o acesso sozinho.
3

Escolher o painel

Peça ao assistente para listar os seus painéis e escolher um, por exemplo: “Liste os meus painéis e use o painel Matriz”. Para trabalhar com vários de uma vez, peça “Use os painéis Matriz e Filial”.Algumas ferramentas, como a lista de sensores e a criação de ativos, trabalham dentro de um ambiente. Peça “Liste os ambientes do painel” e depois “Use o ambiente Produção”.

Verificar o resultado

Peça ao assistente: “Verifique a conexão com a EcoTrust”. Ele responde que a conexão e a autenticação estão funcionando. Em seguida, “Liste os meus painéis” traz os mesmos painéis que você vê ao entrar na plataforma. Na lista de servidores MCP do cliente, como o /mcp do Claude Code, o servidor ecotrust aparece conectado, com as ferramentas do seu perfil. Quantas ferramentas aparecem depende do perfil: veja Ferramentas do servidor MCP.

Problemas comuns

Alguns clientes esperam poucos segundos pelo servidor. Faça o login uma vez pelo terminal, com npx -y mcp-remote https://cyber-security.app/mcp. Quando o navegador avisar que deu certo, encerre o comando com Ctrl+C e abra o cliente de novo: a ponte guarda o acesso na pasta ~/.mcp-auth e não pede o login outra vez.
O login da EcoTrust só devolve o acesso para um endereço do seu próprio computador. Um cliente que recebe o login no site dele, como os conectores personalizados do Claude e os assistentes que rodam só no navegador, não conecta direto. Use a configuração com a ponte mcp-remote da aba do seu cliente.
Instale o Node.js na versão de suporte longo (LTS) e abra o cliente de novo. No Windows, se o erro continuar, troque o comando para cmd e ponha /c e npx no começo dos argumentos: "command": "cmd" e "args": ["/c", "npx", "-y", "mcp-remote", "https://cyber-security.app/mcp"].
Procure o e-mail com o assunto Código de login no spam e na quarentena. O remetente que a TI da sua empresa deve liberar e as outras causas estão em Problemas de acesso.
As ferramentas seguem o seu perfil. Os perfis Score e Score Gestor veem só os painéis e os indicadores agregados, e só Gestor e Analista avançado fazem alterações. A tabela completa está em Ferramentas do servidor MCP. Se o seu perfil mudou, conecte o servidor de novo para o cliente buscar a lista nova.
Peça para ele listar os seus painéis e usar um deles. Uma conversa nova pode começar sem painel selecionado.
No Claude Code, digite /mcp, escolha ecotrust e limpe a autenticação. Nos clientes com a ponte mcp-remote, apague a pasta ~/.mcp-auth e conecte o servidor de novo. O cliente abre o login outra vez.

Próximos passos

Última modificação em 17 de novembro de 2026