Runtime e autenticação

O MCP do TunnelHub suporta dois modos de execução.

Execução local

• transporte stdio;

• usado por ferramentas como OpenCode, Claude Desktop e Cursor;

• entrypoint local em dist/index.js.

Esse é o modo principal para uso no dia a dia.

Execução remota

• transporte HTTP streamable;

• entrypoint em dist/http.js;

• voltado a cenários hospedados.

No estado atual, a execução remota exige cuidado operacional e não deve ser documentada como substituta plena do fluxo local.

Para documentação pública, trate o modo remoto como avançado ou experimental, não como caminho padrão de onboarding.

Como a autenticação funciona hoje

No servidor atual, a sessão é resolvida a partir do contexto OAuth fornecido pelo cliente MCP. Em outras palavras:

• o cliente realiza o fluxo de autenticação;

• o MCP recebe authInfo;

• o servidor resolve o usuário atual;

• o servidor lista ambientes disponíveis;

• o ambiente produtivo ou o primeiro disponível vira o ambiente padrão.

No conjunto atual de ferramentas de sessão, a referência pública é:

• current_session_tunnelhub;

• list_environments_tunnelhub;

• switch_environment_tunnelhub.

Persistência de ambiente

O ambiente selecionado é persistido localmente por tenant para reutilização em sessões futuras.

Variáveis úteis

No modo local ou remoto, as configurações mais comuns incluem:

• OAUTH_CALLBACK_PORT

• TUNNELHUB_FRONTEND_URL

• TUNNELHUB_API_HOST

• HOST

• PORT

• PUBLIC_BASE_URL

• MCP_RUNTIME_TTL_MS

Importante sobre documentação antiga

Parte do material antigo ainda descreve login_tunnelhub e outras ferramentas de sessão que não representam exatamente o conjunto registrado pelo servidor atual. Considere esta página e o catálogo de ferramentas como a referência atual.