# Runtime e autenticação

O MCP do TunnelHub é publicado hoje para uso via `stdio`.

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

## Como a autenticação funciona hoje

No fluxo principal atual, a sessão é criada e gerenciada pelas ferramentas de sessão do próprio MCP.

Fluxo típico:

1. o cliente chama `login_tunnelhub`;
2. o MCP abre o navegador local;
3. você faz login no TunnelHub;
4. a sessão fica salva localmente;
5. as próximas ferramentas passam a usar a sessão ativa.

Se este for o primeiro login, informe `accountName`. Quando o nome da empresa não for suficiente, repita com `tenantId`.

## Ferramentas de sessão

O conjunto atual de ferramentas de sessão inclui:

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

## Ambiente ativo

Depois do login, o MCP usa a sessão ativa e permite listar ambientes disponíveis e trocar o ambiente corrente com `switch_environment_tunnelhub`.

## Persistência local

As sessões ficam salvas localmente para reutilização até que você faça logout da sessão atual ou remova uma sessão específica com `logout_tunnelhub`.

## Variáveis úteis

No modo atual, as configurações mais comuns incluem:

* `OAUTH_CALLBACK_PORT`
* `TUNNELHUB_FRONTEND_URL`
* `FRONTEND_URL`
* `TUNNELHUB_API_HOST`
* `API_HOST`

## Observação prática

Para uso público atual, concentre a configuração no modo `stdio` e nas ferramentas de sessão acima.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tunnelhub.io/mcp/runtime-and-auth.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.