Automatização

O painel Automatização não diz respeito a nenhuma máquina em particular. Configura a API HTTP de automatização do Bromure Agentic Coding — uma interface de controlo na rede de loopback, que ferramentas externas, guiões e agentes de IA usam para gerir máquinas e sessões — e aplica-se a toda a aplicação. É o único painel do grupo Aplicação, e aparece apenas em Preferências… (⌘,).

Nota: este painel não é sobre as automatizações que agenda para os agentes executarem — essas vivem no quadro de Automatizações. Ver Automatizações.

As Preferências intituladas Bromure — Preferências no modelo Predefinições, a mostrar o painel Automatização: o título API de automatização e servidor MCP com a sua explicação, Ativar servidor de automatização ligado e a escutar em 127.0.0.1 porta 9223, um campo Porta com 9223 e (predefinição: 9223), um campo Endereço de bind com 127.0.0.1, e o início do trecho de configuração do cliente MCP

Ao contrário dos outros painéis, este grava à medida que o altera: não há passo de Guardar, e Cancelar não o desfaz. Atua sempre no Mac à sua frente, pelo que aparece apenas nas Preferências deste Mac: não quando o seletor Definições para: das Preferências aponta para um Mac remoto, nem quando edita uma máquina remota a partir de uma janela de espelho. Não está disponível no cliente iPhone, iPad ou Vision Pro.

API de automatização e servidor MCP

O resumo do painel: «O Bromure AC expõe uma API HTTP na interface de loopback que permite a ferramentas externas gerir espaços de trabalho e sessões. O subcomando bromure-ac mcp incluído embrulha a mesma superfície para agentes de IA (Claude Code, Claude Desktop). Estas definições aplicam-se a toda a aplicação.»

Duas entradas partilham um só conjunto de rotas:

  • O socket de controlo — sempre ligado, em ~/Library/Application Support/BromureAC/control.sock, legível apenas por você. A ferramenta de linha de comandos bromure-cli usa-o, esteja o servidor deste painel ligado ou não.
  • A API de automatização — as mesmas rotas sobre TCP, desligada por predefinição, ligada aqui. Clientes HTTP externos e o servidor bromure-ac mcp usam-na. Desligá-la não afeta a ferramenta de linha de comandos.

As rotas, a CLI e as ferramentas MCP estão documentadas em CLI, API e MCP.

Ativar servidor de automatização

Liga e desliga o recetor TCP, imediatamente. A sua legenda mostra o estado:

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

Desligado por predefinição. Enquanto estiver desligado, um cliente MCP configurado com bromure-ac mcp não tem a que se ligar e não lista ferramentas nenhumas.

Aviso: a API de automatização não tem autenticação. Na interface de loopback, qualquer processo do seu Mac pode listar máquinas e sessões e abrir ou fechar sessões; as rotas que alteram máquinas ou executam comandos exigem além disso que a aplicação tenha sido lançada com BROMURE_DEBUG_CLAUDE. Não exponha o recetor além do loopback — ver Endereço de bind.

Porta e endereço de bind

  • Porta — a porta TCP, 1–65535, «(predefinição: 9223)» — uma acima da 9222 do navegador web Bromure, para que as duas aplicações possam correr lado a lado.
  • Endereço de bind — a interface em que escutar, predefinição 127.0.0.1. Qualquer outro valor mostra um aviso laranja: «Um bind fora do loopback expõe a API à rede. O servidor MCP não tem autenticação.»

«A porta e o endereço de bind entram em vigor no próximo arranque do servidor. Desligar e voltar a ligar o interruptor aplica-os agora.»

Configuração do cliente MCP

O fundo do painel tem um trecho para colar num cliente MCP — «Acrescente isto a ~/.config/claude-code/.mcp.json (ou ao equivalente do seu cliente MCP)»:

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

Aponta diretamente para o executável da aplicação dentro do pacote. Se instalou a ferramenta de linha de comandos (Instalar ferramenta de linha de comandos… no menu da aplicação), /usr/local/bin/bromure-cli é uma ligação para o mesmo executável. Ligue primeiro o servidor de automatização: as ferramentas do servidor MCP chamam a API HTTP.

Onde vivem estas definições

As três definições são preferências da aplicação no domínio io.bromure.agentic-coding, e não fazem parte de nenhuma máquina nem modelo, pelo que também podem ser postas a partir da linha de comandos:

DefiniçãoChave de preferênciaTipoPredefinição
Ativar servidor de automatizaçãoautomation.enabledBooleanofalse
Portaautomation.portInteiro (1–65535)9223
Endereço de bindautomation.bindAddressCadeia127.0.0.1

Por exemplo, defaults write io.bromure.agentic-coding automation.enabled -bool true liga o servidor no arranque seguinte. Ver CLI, API e MCP para programar a aplicação enquanto ela corre.

Capítulos relacionados