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.
| 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 (valores fora da faixa são aparados) | 18181 |
Tudo na página salva sozinho; não existe botão Salvar. A leitura Concedido, abaixo do endpoint, conta quantos grupos de capacidade estão abertos e quantos deles conseguem escrever em equipamento ao vivo, para que a exposição da estação seja legível de relance.
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
Hostnão é local, ou que carrega umaOriginnão local, é recusada com 403 antes mesmo de conseguir abrir uma sessão. Cada recusa é registrada sob a área Agente 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.