Visão geral
O @tunnelhub/mcp conecta clientes compatíveis com Model Context Protocol ao TunnelHub para investigação operacional e leitura de recursos da plataforma.
Casos de uso
Use o MCP para:
consultar a sessão atual e o ambiente ativo;
listar pacotes, sistemas, automações e Data Stores;
localizar execuções por período;
abrir logs, traces e resumos de execução;
consultar APIs, planos de uso, chaves de API, clientes e servidores de recursos;
investigar consumo e estatísticas do tenant.
O uso mais valioso hoje costuma estar em investigação de execuções e análise de logs operacionais.
Perfil da ferramenta
O MCP atual é principalmente orientado à leitura e ao suporte operacional. Ele não substitui o portal para modelagem completa de recursos.
Em outras palavras, ele é ideal para:
investigar incidentes;
responder perguntas operacionais rapidamente;
resumir execuções e falhas;
consultar dados de ambiente sem navegar manualmente por múltiplas telas.
Instalação local
O uso principal é via npx:
Pacote no npm: https://www.npmjs.com/package/@tunnelhub/mcp
Modos de execução
O projeto possui dois modos:
local/stdIO para clientes MCP no desktop;
HTTP remoto para execução hospedada.
Para a maioria dos times, o modo local continua sendo a referência principal.
Exemplos de perguntas úteis
Alguns exemplos de uso em linguagem natural:
"Liste as automações ativas do ambiente atual."
"Encontre execuções com erro da automação X nas últimas 24 horas."
"Resuma a execução Y e destaque os principais erros."
"Mostre os systems do ambiente atual relacionados ao pacote Z."
"Quais APIs tiveram chamadas com status 500 hoje?"
Limites práticos
O MCP foi desenhado para operação e investigação, então vale considerar alguns limites:
muitas consultas dependem de intervalo de tempo explícito;
detalhes de execução exigem identificadores específicos;
parte das respostas reflete o backend atual, incluindo nomes técnicos do produto;
o runtime remoto ainda exige mais cuidado operacional do que o runtime local.
Além disso, algumas respostas podem incluir dados sensíveis, como payloads decodificados de logs de API ou detalhes operacionais de produção. Trate essas saídas com cuidado.
Autenticação
No servidor atual, a autenticação efetiva é gerenciada pelo cliente MCP via OAuth. Depois disso, o MCP resolve usuário, tenant e ambiente padrão.
O conjunto público atualmente documentado deve refletir apenas as ferramentas efetivamente registradas pelo servidor, e não qualquer helper interno existente no código.
Consulte Runtime e autenticação, Catálogo de ferramentas e Investigando execuções para detalhes.
Last updated