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

# Ferramentas do servidor MCP

> As ferramentas, os atalhos e o recurso que o servidor MCP da EcoTrust oferece ao seu assistente de IA, com o que cada um faz e os perfis do painel que o usam.

Esta página lista o que o servidor MCP (*Model Context Protocol*) da EcoTrust oferece ao seu assistente de IA, agrupado por área. O assistente escolhe a ferramenta sozinho a partir do seu pedido: você não precisa saber o nome de cada uma.

## Perfis e acesso

Cada ferramenta pertence a um nível de acesso. O cliente só mostra as ferramentas que o seu perfil pode usar.

| Acesso | Perfis | O que cobre |
| - | - | - |
| **Painéis e indicadores** | Todos os perfis | Escolher painéis e ambientes, nota, indicadores e contadores agregados |
| **Leitura detalhada** | Todos, menos **Score** e **Score Gestor** | Ativos, ocorrências, scans e sensores, cada um com a sua identificação |
| **Alterações** | **Gestor** e **Analista avançado** | Cadastrar e importar ativos, criar e executar scans, rodar o scan de vulnerabilidades |

O assistente sempre trabalha nos painéis que o seu usuário acessa.

## Painéis, ambientes e sessão

| Ferramenta | O que faz | Acesso |
| - | - | - |
| `health_check` | Confere a conexão e a autenticação com a plataforma | Painéis e indicadores |
| `list_panels` | Lista os painéis que você acessa | Painéis e indicadores |
| `select_panel` | Seleciona o painel da conversa pelo nome | Painéis e indicadores |
| `select_multi_panels` | Seleciona vários painéis, para as próximas consultas trazerem o resultado de cada um | Painéis e indicadores |
| `list_environments` | Lista os ambientes do painel selecionado | Painéis e indicadores |
| `select_environment` | Seleciona um ambiente pelo nome | Painéis e indicadores |
| `discover_tools` | Lista as ferramentas disponíveis para a sua sessão | Painéis e indicadores |
| `list_skills` | Lista os roteiros automatizados que o servidor publica | Painéis e indicadores |
| `download_skill` | Traz um roteiro pelo nome | Painéis e indicadores |

## Indicadores

| Ferramenta | O que faz | Acesso |
| - | - | - |
| `get_panel_grade` | Traz a nota do painel | Painéis e indicadores |
| `get_indicators` | Traz o tempo médio entre detectar e corrigir (MTTR) e o tempo médio da detecção até a primeira ação de uma pessoa (MTPR), em dias e horas | Painéis e indicadores |
| `get_findings_status` | Conta as ocorrências pendentes e corrigidas, por status e por severidade | Painéis e indicadores |
| `get_findings_priority` | Conta as ocorrências por prioridade | Painéis e indicadores |
| `get_assets_stats` | Conta os ativos por criticidade | Painéis e indicadores |

## Ativos

| Ferramenta | O que faz | Acesso |
| - | - | - |
| `list_assets` | Lista os ativos do painel, com busca por parte do nome ou do valor | Leitura detalhada |
| `get_asset` | Traz os detalhes de um ativo | Leitura detalhada |
| `get_asset_findings` | Lista as ocorrências de um ativo | Leitura detalhada |
| `list_assets_by_env` | Lista os ativos de um ambiente | Leitura detalhada |
| `list_environment_assets` | Lista os ativos de um ambiente, com filtro por tipo, como IP e domínio | Leitura detalhada |
| `get_fleet_inventory` | Traz o inventário consolidado de software, hardware e serviços, do painel ou de um ambiente | Leitura detalhada |
| `list_assets_without_owner` | Lista os ativos sem responsável, com filtro por ambiente, grupo e criticidade | Leitura detalhada |
| `add_asset` | Cadastra um ativo, IP ou domínio, num ambiente, com nome, descrição e criticidade | Alterações |
| `process_csv_chunk` | Recebe, em partes, o arquivo CSV de uma importação de ativos | Alterações |
| `update_assets` | Importa ou atualiza ativos em massa a partir do CSV recebido | Alterações |

## Ocorrências

| Ferramenta | O que faz | Acesso |
| - | - | - |
| `get_finding` | Traz os detalhes de uma ocorrência | Leitura detalhada |
| `export_finding` | Exporta uma ocorrência em JSON, CSV, HTML ou Structured Threat Information Expression (STIX) | Leitura detalhada |
| `list_vulns_by_period` | Lista as vulnerabilidades encontradas, tratadas e corrigidas num período | Leitura detalhada |
| `get_saved_finding_filters` | Lista os filtros de ocorrências salvos no painel | Leitura detalhada |

## Scans

| Ferramenta | O que faz | Acesso |
| - | - | - |
| `list_scans` | Lista os scans do painel, com filtros por título, status, sensor e datas | Leitura detalhada |
| `list_scans_by_date` | Lista os scans de um período: ano, mês, semana, dia, hora ou minuto | Leitura detalhada |
| `get_scans_stats` | Traz os totais de scans definidos, executados e periódicos, ou as execuções recentes | Leitura detalhada |
| `list_scan_findings` | Lista as ocorrências de um scan numa tabela resumida, com filtro por severidade | Leitura detalhada |
| `get_scan_findings` | Gera um link para baixar o CSV completo das ocorrências de um scan | Leitura detalhada |
| `list_scan_definitions` | Lista as definições de scan do painel | Leitura detalhada |
| `get_scan_definition` | Traz uma definição de scan | Leitura detalhada |
| `list_scan_policies` | Lista as políticas de scan que podem ser usadas ao criar um scan | Leitura detalhada |
| `create_scan` | Cria uma definição de scan, única ou periódica, e pode executá-la na hora | Alterações |
| `run_scan` | Executa uma definição de scan existente. As periódicas ficam de fora, porque rodam pelo próprio agendamento | Alterações |

## Sensores

| Ferramenta | O que faz | Acesso |
| - | - | - |
| `list_engines` | Lista os sensores online do ambiente selecionado | Leitura detalhada |
| `search_engine` | Busca sensores online pelo nome | Leitura detalhada |
| `list_engine_instances_by_type` | Lista os sensores de um tipo | Leitura detalhada |

## Scan de vulnerabilidades

O scan de vulnerabilidades roda por um [Connect](https://docs.ecotrust.io/connect/visao-geral.md) do seu ambiente e segue quatro passos: escolher o Connect, escolher os alvos, revisar e iniciar. O início só aceita o escopo que passou pela revisão, uma única vez.

| Ferramenta | O que faz | Acesso |
| - | - | - |
| `vulscan_list_connectors` | Lista cada Connect pronto para rodar o scan | Leitura detalhada |
| `vulscan_list_targets` | Lista os ativos e grupos de ativos de um ambiente que podem ser alvo | Leitura detalhada |
| `vulscan_list_credentials` | Lista as credenciais de acesso salvas no painel, só pelo nome e pelo tipo, sem o segredo | Leitura detalhada |
| `vulscan_list_collections` | Lista as coletas já concluídas que o scan pode reaproveitar, pulando a descoberta e a coleta | Leitura detalhada |
| `vulscan_preview` | Monta a revisão do scan, com os alvos, o Connect e as fases, sem iniciar nada | Alterações |
| `vulscan_start` | Inicia o scan revisado | Alterações |
| `vulscan_status` | Mostra se o scan ainda está rodando ou já terminou | Leitura detalhada |
| `vulscan_cancel` | Cancela um scan em andamento | Alterações |

O acesso aos ativos do scan é escolhido na revisão:

| Acesso aos ativos | Credencial | Quando usar |
| - | - | - |
| **AWS Systems Manager (SSM)** | Nenhuma: o Connect usa a permissão que já tem na sua conta da Amazon Web Services | Instâncias da nuvem gerenciadas pelo Systems Manager |
| **Credencial salva** | Uma credencial já guardada no painel, escolhida pelo nome | Sempre que existir uma: o segredo não passa pela conversa |
| **Windows** | Usuário e senha informados no início, com domínio e porta quando preciso | Servidores Windows sem credencial salva |
| **Secure Shell (SSH)** | Usuário e senha ou chave informados no início, com a porta quando não é a 22 | Servidores Linux sem credencial salva |

O scan leva de 10 a 45 minutos. Para ver o resultado, peça as ocorrências do scan depois que ele terminar.

## Vários painéis de uma vez

Com vários painéis selecionados, os indicadores e a maioria das listas trazem o resultado de cada painel. Trabalham num painel só as ferramentas que pedem um item específico (um ativo, uma ocorrência, um scan ou uma definição de scan), a lista de sensores do ambiente, a seleção de ambiente, a criação e a execução de scans e o scan de vulnerabilidades.

## Atalhos

O servidor também oferece atalhos, que muitos clientes mostram como comandos de barra.

| Atalho | O que faz | Acesso |
| - | - | - |
| `paineis` | Lista os painéis que você acessa | Painéis e indicadores |
| `use` | Seleciona um painel pelo nome | Painéis e indicadores |
| `ambiente` | Seleciona um ambiente pelo nome | Painéis e indicadores |
| `sensores` | Busca sensores online pelo nome | Leitura detalhada |

## Recurso

| Recurso | O que traz |
| - | - |
| `ecotrust://status` | O nome e a versão do servidor |

## Relacionados

* [Conectar o seu assistente de IA](https://docs.ecotrust.io/mcp/conectar-o-seu-assistente.md)
* [Servidor MCP da EcoTrust](https://docs.ecotrust.io/mcp/visao-geral.md)
* [O que é o Connect](https://docs.ecotrust.io/connect/visao-geral.md)


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