# Catálogo de ferramentas

O servidor MCP atual registra grupos de ferramentas para navegação de sessão, recursos da plataforma e monitoramento.

## Sessão e ambiente

* `login_tunnelhub`
* `current_session_tunnelhub`
* `list_sessions_tunnelhub`
* `list_environments_tunnelhub`
* `switch_environment_tunnelhub`
* `logout_tunnelhub`

Essas são as referências públicas para autenticação, navegação de sessão e troca de ambiente no servidor atual.

Observações práticas:

* `login_tunnelhub` aceita `accountName` ou `tenantId`;
* no primeiro login, informe `accountName` quando possível;
* `list_sessions_tunnelhub` lista as sessões salvas, mas não troca a sessão ativa;
* `logout_tunnelhub` pode remover a sessão atual ou uma sessão específica.

## Tenants

* `list_tenants_tunnelhub`
* `get_tenant_tunnelhub`

## Pacotes, systems e Tabelas De/Para

As ferramentas atuais cobrem:

* listagem e detalhe de pacotes;
* listagem e detalhe de systems;
* listagem de Tabelas De/Para e de seus itens.

## Automações e monitoramento

As ferramentas atuais cobrem:

* listagem e detalhe de automações;
* histórico de deploys;
* action logs;
* execução manual;
* busca de execuções por período;
* resumo, logs e traces de uma execução.

Fluxo recomendado para troubleshooting:

1. localizar a execução com `find_execution_tunnelhub`;
2. abrir o resumo com `summarize_execution_tunnelhub`;
3. seguir para `get_execution_traces_tunnelhub` ou `get_execution_logs_tunnelhub`.

## API Gateway

O grupo de APIs cobre:

* listagem e detalhe de APIs;
* planos de uso;
* chaves de API;
* clientes de autenticação;
* servidores de recursos;
* logs de APIs por recurso ou por janela de tempo;
* detalhe de log com payloads decodificados quando possível.

## Estatísticas

O MCP também expõe consultas de estatísticas gerais do tenant, incluindo consumo de execuções.

## Observações operacionais

* consultas de monitoramento dependem de janela de tempo explícita;
* detalhes de execução exigem `automationId`, `executionId` e `executionPeriod`;
* `executionPeriod` deve estar no formato `YYYY-MM`;
* respostas de chaves de API podem incluir dados sensíveis dependendo do backend, então trate essa informação com cuidado;
* logs detalhados de API podem expor payloads de request e response, então higienize qualquer reutilização externa.