> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecotrust.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar o seu assistente de IA ao servidor MCP

> Como adicionar o servidor MCP da EcoTrust ao Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex ou Gemini CLI, entrar com a sua conta pelo navegador e escolher o painel com que o assistente trabalha.

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

```text theme={"dark"}
https://cyber-security.app/mcp
```

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.

> [tab] Claude Code
>
> No terminal, adicione o servidor:
>
> ```bash theme={"dark"}
> claude mcp add --transport http ecotrust https://cyber-security.app/mcp
> ```
>
> 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.

> [tab] Claude Desktop
>
> Em **Settings**, abra **Developer** e clique em **Edit Config**. No arquivo `claude_desktop_config.json`, acrescente o servidor:
>
> ```json theme={"dark"}
> {
>   "mcpServers": {
>     "ecotrust": {
>       "command": "npx",
>       "args": ["-y", "mcp-remote", "https://cyber-security.app/mcp"]
>     }
>   }
> }
> ```
>
> Salve o arquivo e feche e abra o Claude Desktop. Use o arquivo de configuração, e não um conector personalizado: o conector personalizado recebe o login no site do Claude, e o login da EcoTrust só volta para o seu próprio computador.

> [tab] Cursor
>
> Abra o arquivo `~/.cursor/mcp.json`, para todos os projetos, ou `.cursor/mcp.json` na pasta do projeto, e acrescente o servidor:
>
> ```json theme={"dark"}
> {
>   "mcpServers": {
>     "ecotrust": {
>       "command": "npx",
>       "args": ["-y", "mcp-remote", "https://cyber-security.app/mcp"]
>     }
>   }
> }
> ```
>
> Salve o arquivo. O servidor aparece na seção de MCP das configurações do Cursor, onde você confere se ele está ligado.

> [tab] VS Code
>
> Na pasta do projeto, crie o arquivo `.vscode/mcp.json`. Para todos os projetos, use o comando `MCP: Open User Configuration` na paleta de comandos.
>
> ```json theme={"dark"}
> {
>   "servers": {
>     "ecotrust": {
>       "type": "stdio",
>       "command": "npx",
>       "args": ["-y", "mcp-remote", "https://cyber-security.app/mcp"]
>     }
>   }
> }
> ```
>
> Clique em **Start**, que aparece acima do servidor no arquivo. As ferramentas ficam disponíveis no chat do Copilot, no modo **Agent**.

> [tab] Windsurf
>
> Abra o arquivo `~/.codeium/windsurf/mcp_config.json` e acrescente o servidor:
>
> ```json theme={"dark"}
> {
>   "mcpServers": {
>     "ecotrust": {
>       "command": "npx",
>       "args": ["-y", "mcp-remote", "https://cyber-security.app/mcp"]
>     }
>   }
> }
> ```
>
> Salve o arquivo e atualize a lista de servidores MCP no painel do Cascade.

> [tab] Codex
>
> Abra o arquivo `~/.codex/config.toml` e acrescente o servidor:
>
> ```toml theme={"dark"}
> [mcp_servers.ecotrust]
> command = "npx"
> args = ["-y", "mcp-remote", "https://cyber-security.app/mcp"]
> ```
>
> Salve o arquivo e abra uma nova sessão do Codex.

> [tab] Gemini CLI
>
> Abra o arquivo `~/.gemini/settings.json` e acrescente o servidor:
>
> ```json theme={"dark"}
> {
>   "mcpServers": {
>     "ecotrust": {
>       "command": "npx",
>       "args": ["-y", "mcp-remote", "https://cyber-security.app/mcp"]
>     }
>   }
> }
> ```
>
> Salve o arquivo e abra o Gemini CLI. O comando `/mcp` mostra o servidor e as ferramentas dele.

> [tab] Outro cliente
>
> Se o seu cliente conecta a servidores MCP remotos com OAuth e recebe o retorno do login num endereço do próprio computador (`http://localhost` ou `http://127.0.0.1`), aponte-o direto para `https://cyber-security.app/mcp`.
>
> Nos outros casos, cadastre a ponte `mcp-remote` como um servidor local, do tipo `stdio`, com este comando:
>
> ```bash theme={"dark"}
> npx -y mcp-remote https://cyber-security.app/mcp
> ```

**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](https://docs.ecotrust.io/mcp/ferramentas.md).

## Problemas comuns

> [accordion] O cliente desiste antes de eu terminar o login
>
> 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.

> [accordion] O cliente diz que não conseguiu registrar o aplicativo
>
> 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.

> [accordion] O cliente não encontra o comando npx
>
> 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"]`.

> [accordion] O código de login não chega
>
> 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](https://docs.ecotrust.io/acesso/problemas-de-acesso.md).

> [accordion] Uma ferramenta não aparece ou o assistente diz que não tem permissão
>
> 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](https://docs.ecotrust.io/mcp/ferramentas.md#perfis-e-acesso). Se o seu perfil mudou, conecte o servidor de novo para o cliente buscar a lista nova.

> [accordion] O assistente diz que nenhum painel foi selecionado
>
> Peça para ele listar os seus painéis e usar um deles. Uma conversa nova pode começar sem painel selecionado.

> [accordion] Preciso entrar com outro usuário
>
> 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

* [Ferramentas do servidor MCP](https://docs.ecotrust.io/mcp/ferramentas.md): o que o assistente consegue fazer, por perfil.
* [Servidor MCP da EcoTrust](https://docs.ecotrust.io/mcp/visao-geral.md): exemplos de pedidos e como o acesso é protegido.
* [Gerenciar os usuários](https://docs.ecotrust.io/console/gerenciar-os-usuarios.md): dar a alguém da equipe acesso a um painel e o perfil certo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.