TunnelHub
TunnelHub é uma plataforma de integração, automação e gerenciamento de APIs orientada a times que precisam operar fluxos em produção, com observabilidade, segurança e separação por ambiente.
Hoje a plataforma combina quatro frentes principais:
Produto web para configurar ambientes, pacotes, Tabelas De/Para, sistemas, automações, APIs, usuários e configurações administrativas.
SDK em TypeScript para implementar automações com fluxos prontos, logging, delta, parâmetros, Tabelas De/Para e Sequências.
CLI para autenticar, listar recursos, criar pacotes, criar automações e publicar novas versões.
MCP para investigação operacional, leitura de recursos e análise de execuções diretamente de clientes compatíveis com Model Context Protocol.
O que você encontra no TunnelHub
Produto: ambientes, pacotes, Tabelas De/Para, sistemas, automações, tabelas de conversão, Sequências, monitoramento e administração.
API Management: definição de APIs, planos de uso, chaves de API, servidores de recursos, clientes e logs de execução.
Developer tooling: CLI, SDK, MCP e skill para agentes com papéis diferentes no ciclo de desenvolvimento e suporte.
Como navegar nesta documentação
Se você está começando agora, siga Criando sua primeira automação.
Se você quer entender o modelo do produto, comece por Conceitos principais.
Se você precisa modelar configuração operacional no produto, leia Tabelas De/Para e Sistemas.
Se você vai investigar execuções ou operar o ambiente via cliente MCP, consulte MCP.
Skill para agentes
Se você desenvolve automações com frequência, vale instalar o skill público tunnelhub-sdk. Ele ajuda a trabalhar com os fluxos do SDK, parâmetros, sistemas, Tabelas De/Para, Sequências, logging, interceptor HTTP e testes em plataformas de agentes compatíveis.
Instalação:
Instalação global:
Requisitos gerais
Node.js 22+ para os projetos atuais do monorepo.
Acesso a uma conta TunnelHub com pelo menos um ambiente.
Permissões adequadas para criar pacotes, automações, APIs ou usuários, dependendo do seu perfil.
Principais conceitos
Ambiente: separa configuração e execução, como DEV, QAS e PRD.
Pacote: agrupador lógico de automações, sistemas e artefatos relacionados.
Sistema: definição reutilizável de conexão com serviços externos.
Automação: execução serverless ou em container que processa integrações e gera logs operacionais.
Tabela De/Para: conjunto de dados configurável no produto, usado para mapeamentos, listas de referência e traduções de valores.
Tabela de conversão: caso comum de uma Tabela De/Para usada para de/para entre sistemas.
Sequência: gerador sequencial para identificadores controlados pela plataforma.
Use esta documentação como referência pública do estado atual da plataforma. Quando houver diferença entre exemplos antigos e o comportamento atual do produto, o produto e o código do repositório são a fonte de verdade.
Last updated