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

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.

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

• 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, 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).
• 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).