Automatização

O painel Automatização é a única definição do editor que não é por espaço de trabalho. Configura a API de automatização HTTP do Bromure Agentic Coding — um plano de controlo em loopback que ferramentas externas, scripts e agentes de IA usam para gerir espaços de trabalho e sessões — e aplica-se a toda a aplicação. Como não pertence a nenhum espaço de trabalho específico, aparece apenas quando abre o editor como as Preferências da aplicação.

Não existe captura de ecrã para este painel neste capítulo: é acedido através de Bromure → Preferências… (⌘,), onde o editor está associado ao modelo de preferências e a categoria Automatização é adicionada ao fundo da barra lateral de categorias. Não aparece quando edita um espaço de trabalho comum.

Nota: Ao contrário de todos os painéis por espaço de trabalho, este não é transacional. Os seus controlos escrevem as preferências da aplicação no momento em que os altera — não há passo de Guardar, e o interruptor entra em vigor imediatamente.

O que é o servidor de automatização

O resumo do painel explica-o de forma clara: o Bromure Agentic Coding expõe uma API HTTP na interface de loopback que permite a ferramentas externas gerir espaços de trabalho e sessões, e o subcomando incorporado bromure-cli mcp envolve a mesma superfície para agentes de IA como o Claude Code e o Claude Desktop.

Dois caminhos de acesso partilham esta única superfície HTTP, e vale a pena mantê-los separados:

• O socket de controlo — um socket Unix sempre ativo e exclusivo do proprietário em ~/Library/Application Support/BromureAC/control.sock (modo 0600). A ferramenta de linha de comandos bromure-cli comunica com a aplicação através deste socket. É independente deste painel: a CLI funciona esteja ou não o servidor de automatização ativado, porque as permissões do ficheiro do socket são o seu controlo de acesso.
• A API de automatização — as mesmas rotas expostas através de TCP, desativadas por predefinição, ativadas aqui. É isto que os clientes HTTP externos e o servidor bromure-cli mcp usam. Desativar isto não afeta a CLI.

A lista completa de rotas, a CLI e os servidores MCP estão documentados em Automatização e a CLI.

Ativar servidor de automatização

O interruptor Ativar servidor de automatização liga e desliga o recetor TCP. A sua legenda reflete o estado atual:

• Quando ligado: A escutar em 127.0.0.1:9223. Desativar isto para o servidor imediatamente; o subcomando MCP deixará de alcançar a aplicação.
• Quando desligado: Desligado — a API HTTP e o subcomando MCP estão indisponíveis.

O servidor está desativado por predefinição. Enquanto estiver desligado, o servidor stdio bromure-cli mcp não tem nada a que se ligar, pelo que qualquer cliente MCP configurado contra ele reportará nenhuma ferramenta até que ative o servidor aqui.

Aviso: A API de automatização não tem autenticação. Na interface de loopback, a listagem de perfis e sessões e a criação/fecho de sessões estão abertas a qualquer processo local; as rotas de mutação e de introspeção (controlo de espaços de trabalho, exec, estado da aplicação, depuração) requerem adicionalmente que a aplicação tenha sido iniciada com BROMURE_DEBUG_CLAUDE. Como não há autenticação, expor o recetor para além do loopback é um risco real — consulte Endereço de vinculação abaixo.

Porta e endereço de vinculação

Dois campos ajustam onde o servidor escuta:

• Porta — a porta TCP, com um marcador de posição de (predefinição: 9223) e um intervalo válido de 1–65535. A predefinição de 9223 está deliberadamente a uma unidade da porta de automatização do navegador web Bromure (9222), para que ambas as aplicações possam ser executadas lado a lado.
• Endereço de vinculação — a interface a vincular, com predefinição 127.0.0.1. Qualquer valor diferente de loopback origina um aviso laranja: A vinculação a um endereço não-loopback expõe a API à rede. O servidor MCP não tem autenticação. Mantenha isto em 127.0.0.1 a menos que compreenda totalmente a exposição.

O painel indica o momento de aplicação: A porta e o endereço de vinculação entram em vigor da próxima vez que o servidor iniciar. Desativar e reativar o interruptor aplica-os agora. Por outras palavras, altere a porta ou o endereço e, em seguida, desligue e ligue Ativar servidor de automatização para revincular imediatamente.

Configuração do cliente MCP

O fundo do painel contém um fragmento de Configuração do cliente MCP pronto a colar para ligar o servidor bromure-cli mcp a um cliente MCP. Lê-se: adicione isto a ~/.config/claude-code/.mcp.json (ou ao equivalente do seu cliente MCP):

{
  "mcpServers": {
    "bromure-cli": {
      "command": "/Applications/Bromure Agentic Coding.app/Contents/MacOS/bromure-cli",
      "args": ["mcp"]
    }
  }
}

O command aponta diretamente para o binário da aplicação dentro do pacote. Ative primeiro o servidor de automatização, uma vez que as ferramentas de sessão e de perfil do servidor MCP chamam a API HTTP que acabou de ativar.

Onde residem as definições

Tudo neste painel é armazenado nas preferências da aplicação sob o domínio io.bromure.agentic-coding, e não em qualquer profile.json. As mesmas três chaves podem ser definidas a partir da linha de comandos ou via AppleScript, o que é útil para o aprovisionamento por script:

Por exemplo, defaults write io.bromure.agentic-coding automation.enabled -bool true ativa o servidor, e o set ac app setting "automation.enabled" to value "true" do AppleScript alterna-o em tempo real. Os mecanismos de ambos, juntamente com tudo o que a API e os servidores MCP conseguem fazer, estão em Automatização e a CLI.