> ## 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.

# Integrar a EcoTrust com as suas ferramentas

> Como os agentes dos módulos da EcoTrust se conectam ao MCP de ITSM, SIEM, EDR, diretório, firewall e outras ferramentas de segurança: o que é um MCP, como conectar e casos de uso.

A EcoTrust se integra às ferramentas que a sua equipe já usa, como ITSM e CMDB, SIEM, SOAR, EDR e XDR, diretório e identidade, firewall e automação, pelo MCP de terceiros. Os agentes de todos os módulos se conectam ao servidor MCP de cada ferramenta e trabalham na EcoTrust interagindo com ela: você conecta o servidor, um gestor aprova, e o agente passa a usar a ferramenta nas conversas e nos serviços do módulo, sem que ninguém precise desenvolver um conector.

## O que é um MCP

O Protocolo de Contexto de Modelo (MCP, do inglês *Model Context Protocol*) é o padrão aberto pelo qual agentes de IA usam outros sistemas. Uma ferramenta que oferece MCP publica um **servidor MCP**, e esse servidor lista as **ferramentas** que expõe: funções como consultar um ativo, abrir um chamado, atualizar um item do CMDB, buscar eventos ou isolar um host.

Quando você conecta um servidor MCP, o agente recebe essa lista e pode usar qualquer ferramenta dela: consultar, criar, atualizar, executar, tudo o que o servidor permitir. Por isso, o que o agente consegue fazer numa ferramenta é definido pelo servidor MCP dela, e não pela EcoTrust. O limite fica com você:

* **Um gestor aprova a conexão** e escolhe em quais módulos ela vale.
* **O gestor autoriza ou bloqueia cada ferramenta** do servidor. Um servidor pode ter centenas de funções, e só as autorizadas ficam disponíveis ao agente.
* **Cada usuário entra com a própria conta** na ferramenta, então o agente nunca faz mais do que essa conta pode fazer.
* **Toda ação que muda algo** na outra ferramenta passa pela [aprovação humana](https://docs.ecotrust.io/ecotrust-os/governanca-e-aprovacao-humana.md) antes de acontecer.

## Como conectar

**1. Pedir no chat do agente**

No **Agent Work** de qualquer módulo, envie `/mcp` com a URL do servidor MCP da ferramenta, como `/mcp https://servidor.exemplo.com/mcp`.

**2. Autenticar**

O agente confere como o servidor faz a autenticação. Se ele usa OAuth, você entra pelo provedor da ferramenta e confirma em **Já autorizei**. Nos outros casos, você informa a **Chave de API** (**Bearer Token** ou **Cabeçalho personalizado**) ou escolhe **Sem autenticação**.

**3. Conferir as ferramentas**

O agente responde com a conexão estabelecida e a lista das ferramentas que o servidor oferece, e abre a solicitação para os gestores do painel.

**4. Aprovar, se você é gestor**

Na aba **Config** do módulo, em **MCP**, o gestor aprova a conexão, define o escopo (este módulo, módulos selecionados ou todos) e autoriza ou bloqueia cada ferramenta. Uma URL da lista de **MCPs pré-aprovados** já nasce aprovada.

O passo a passo completo está em [Conectar um MCP](https://docs.ecotrust.io/ecotrust-os/conectar-um-mcp.md).

## Casos de uso

Em todos os casos, é o agente do módulo, dentro da EcoTrust, que se conecta ao servidor MCP da outra ferramenta. Os dados é que andam nos dois sentidos: o agente leva o que a EcoTrust sabe para a ferramenta e traz o que a ferramenta sabe para a análise na EcoTrust.

| Os dados vão | Caso de uso | Como o agente faz |
| - | - | - |
| Da EcoTrust para a ferramenta | **Alimentar o CMDB do ITSM** | Lê o inventário da EcoTrust, com os ativos, o ambiente e o software de cada um, e cria ou atualiza os itens de configuração do CMDB |
| Da EcoTrust para a ferramenta | **Abrir chamados de correção** | Abre no ITSM um chamado para cada vulnerabilidade priorizada, com o ativo, a correção e o prazo, e acompanha o chamado até a verificação |
| Da EcoTrust para a ferramenta | **Bloquear o que está exposto** | Propõe ao firewall uma regra emergencial para um serviço exposto e explorado, que só entra com a sua aprovação |
| Da ferramenta para a EcoTrust | **Contextualizar um alerta do SIEM** | Lê o evento do SIEM, consulta na EcoTrust as vulnerabilidades e ameaças do ativo envolvido e devolve o contexto ao analista ou ao próprio caso |
| Da ferramenta para a EcoTrust | **Confirmar uma exposição no EDR** | Para um ativo com uma vulnerabilidade explorada, consulta no EDR se houve detecção e propõe o isolamento do host, com a sua aprovação |
| Da ferramenta para a EcoTrust | **Achar o dono de um ativo ou de uma conta** | Consulta o diretório para saber quem responde por um ativo ou por uma credencial vazada e propõe a troca de senha ou o bloqueio da conta |

Os casos de uso dependem das ferramentas que o servidor MCP de cada ferramenta oferece e das que o gestor autorizou.

### Um fluxo de exemplo

1. O analista pede no **Agent Work**: "Investigue os alertas de movimentação lateral do host FIN-SRV-012 nas últimas 24 horas".
2. O agente consulta o SIEM e o EDR pelos servidores MCP conectados, correlaciona autenticações, processos e conexões e cruza com as vulnerabilidades do host na EcoTrust.
3. O agente apresenta a linha do tempo e as evidências e recomenda isolar o host e bloquear a conta usada. Esse plano de contenção pede a aprovação do analista.
4. O analista revisa, ajusta um passo e clica em **Aprovar**. O agente executa a contenção pelo EDR e pelo diretório, narrando cada ação, e abre o chamado do incidente no ITSM.

A leitura e a análise acontecem sem intervenção; a ação sobre o ambiente só acontece depois da aprovação.

## Ferramentas com servidor MCP

Muitas ferramentas comuns em operações de segurança já têm servidor MCP, publicado pelo fabricante ou mantido pela comunidade. Alguns exemplos, conferidos em novembro de 2026:

| Tipo | Exemplos de ferramentas |
| - | - |
| ITSM e CMDB | ServiceNow, Jira Service Management, GLPI |
| Identidade e diretório | Microsoft Entra ID, Okta, Active Directory |
| SIEM e SOAR | Microsoft Sentinel, Splunk, Google Security Operations, Elastic Security, Wazuh |
| EDR e XDR | CrowdStrike Falcon, SentinelOne, Palo Alto Networks Cortex |
| Firewall | Fortinet FortiGate |

As ferramentas que cada servidor lista, o que ele permite e se ele está em versão final ou de testes são do fabricante ou de quem mantém o projeto: confira a documentação dele antes de conectar. Um servidor da comunidade não é suportado pelo fabricante da ferramenta: avalie o código e as permissões que ele pede antes de conectá-lo a uma ferramenta de produção.

## Ferramentas dentro da sua rede

O agente acessa o servidor MCP pela URL, de fora da sua rede. Para uma ferramenta que só existe dentro dela, a sua equipe publica o servidor MCP num endereço HTTPS que a plataforma alcance, com a autenticação do servidor e o acesso liberado só para a plataforma.

## Quando a ferramenta não tem MCP

* **Coletar dentro da sua rede:** o [Connect](https://docs.ecotrust.io/connect/visao-geral.md) roda no seu ambiente e coleta dos ativos pelos protocolos do próprio sistema.
* **Trocar dados com EDR e XDR:** a plataforma tem uma API aberta e documentada. Veja os caminhos em [Integrações](https://docs.ecotrust.io/ecotrust-os/integracoes.md).
* **Um serviço que ainda não existe:** peça ao time EcoTrust em [Solicitar um serviço](https://docs.ecotrust.io/ecotrust-os/solicitar-um-servico.md).

## Onde entra no ciclo CTEM

As integrações levam o Gerenciamento Contínuo de Exposição a Ameaças (CTEM) até as ferramentas que a sua equipe já usa. No **Escopo** e na **Descoberta**, o inventário da EcoTrust e o CMDB se mantêm em sincronia. Na **Priorização**, o agente cruza o que encontrou com o SIEM, o EDR e o diretório. Na **Mobilização**, ele abre o chamado no ITSM e acompanha a correção até a **Validação**.

## Para colocar em prática

* [Conectar um MCP](https://docs.ecotrust.io/ecotrust-os/conectar-um-mcp.md)
* [Governança e aprovação humana](https://docs.ecotrust.io/ecotrust-os/governanca-e-aprovacao-humana.md)
* [Integrações](https://docs.ecotrust.io/ecotrust-os/integracoes.md)


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