# Ligar o acesso

> O interruptor mestre, a porta em que o endpoint escuta, e as quatro coisas que o mantêm local.

Uma instalação nova não anuncia nada a agentes. O acesso de agente está a um interruptor de
distância, e o interruptor é a primeira das três portas que fazem as vezes de autenticação: o
interruptor mestre, os interruptores por área e o diário.

## O interruptor e a porta {#the-switch-and-the-port}

O interruptor mestre nasce **desligado**. Habilite-o na página **Agente** (abrir a página
exige a permissão de gerenciar agentes do seu papel local); o endpoint então escuta em
`http://127.0.0.1:<port>/mcp` sobre Streamable HTTP. Agentes conseguem conectar enquanto a
aplicação roda escondida na área de notificação também.

| Definição | O que faz | Valores | Padrão |
| --- | --- | --- | --- |
| Habilitar acesso de agente (MCP) | Inicia ou para o endpoint. Desligado = nenhum endpoint, nada anunciado. | ligado / desligado | desligado |
| Porta | A porta local em que o endpoint escuta. Mudá-la reinicia o acesso de agente, e todo trecho de conexão da página se atualiza para acompanhar. | 1024–65535. Uma porta para a qual o acesso de agente não pode se mudar é recusada antes de qualquer coisa ser guardada: o motivo é dito embaixo do campo, o campo volta à porta em vigor, e nada reinicia. Seis entradas são recusadas: um valor fora da faixa ("Digite um número entre 1024 e 65535."); a porta do servidor web, definida em [Acesso remoto](remote-access) ("A porta N já é a do servidor web. Escolha outra porta, ou mova o servidor web antes."); a porta do servidor OPC UA em [Configuração](connector-opcua-configuration), em execução ou parado ("A porta N já é a do servidor OPC UA. Escolha outra porta, ou mova o servidor antes."); a porta do [servidor Modbus](connector-modbus-server) na página Connector, ligado ou desligado ("A porta N já é a do servidor Modbus. Escolha outra porta, ou mova o servidor Modbus antes."); a porta do [broker MQTT](connector-mqtt-broker) na página Connector, ligado ou desligado ("A porta N já é a do broker MQTT. Escolha outra porta, ou mova o broker MQTT antes."); e uma porta que outra coisa nesta máquina já segura ("A porta N está em uso nesta máquina. Feche o que a está segurando, ou escolha outra porta."). | 18181 |

Ao lado do interruptor, uma pílula de estado mostra **Lacrado** enquanto ele está desligado e
**Aberto** enquanto está ligado, então o estado do endpoint se lê na pílula de relance.

Abaixo do endpoint, uma contagem sem título próprio resume os interruptores de
**Áreas permitidas**, mais abaixo na página. A primeira linha dela dá a cada um dos quatro
níveis o número das suas áreas que estão ligadas, atrás de um ponto aceso na cor do nível
enquanto pelo menos uma delas está ligada e cinza enquanto nenhuma está: com todas as áreas
ligadas, ela mostra 5 **Leitura**, 6 **Configuração**, 4 **Operação** e 1 **Restauração**.
A linha de baixo soma tudo, "16 de 16 grupos de capacidade abertos", e, enquanto uma área do
nível Operação ou Restauração está ligada, continua dizendo quantos dos grupos abertos
conseguem escrever em equipamento ao vivo: "5 com escrita ao vivo". Ela conta os
interruptores das áreas e nada mais, para que a exposição da estação seja legível de
relance. Enquanto o interruptor mestre está desligado, a contagem fica esmaecida junto com o
endpoint e a porta, mas continua lendo os interruptores, que guardam o que foi salvo: mostra
o que o acesso de agente abre assim que o interruptor for ligado de novo.

Enquanto o interruptor está desligado, **Copiar a URL** e **Porta** ficam cinza abaixo do endpoint, e o ponteiro parado em qualquer um dos dois diz por quê: "O acesso de agente está desabilitado. Habilite-o primeiro em Acesso." O cartão **Áreas permitidas** diz a mesma frase acima dos interruptores cinza dele.

Tudo na página salva sozinho; não existe botão Salvar.

## Como o endpoint é protegido {#how-the-endpoint-is-protected}

- **Só loopback.** O soquete se prende a `127.0.0.1`, nunca a uma interface de rede. A
  rede da planta não o alcança.
- **Requisições de navegador são recusadas.** A prisão ao endereço sozinha não impediria uma
  página web maliciosa de reapontar o domínio dela para 127.0.0.1, então o endpoint também confere os
  dois cabeçalhos que um navegador não consegue forjar: uma requisição cujo `Host` não é local, ou
  que carrega uma `Origin` não local, é recusada com 403 antes mesmo de conseguir abrir uma sessão. Cada
  recusa é registrada sob a área **Agent** em [Eventos](events), então uma estação sondada
  por uma aba de navegador deixa rastro.
- **Nenhuma autenticação no endpoint, por projeto.** As portas são o interruptor mestre, os
  interruptores por área e o diário. Se você algum dia expuser o endpoint por um túnel,
  a autenticação precisa viver no túnel (veja [ChatGPT e outros clientes roteados pela
  nuvem](agent-clients)).
- **A lista de ferramentas é igual às áreas habilitadas.** As ferramentas de uma área desabilitada não são
  anunciadas de jeito nenhum: elas estão ausentes, e não "respondendo que não". Mudar qualquer interruptor
  reinicia o endpoint, para que o que um agente vê sempre corresponda ao que você permitiu. As duas
  ferramentas de ajuda são a única exceção: elas leem a documentação da aplicação e nada da estação, então vêm
  com o endpoint não importa o que digam os interruptores ([Ajuda](agent-tools#help)).