MCP
O painel MCP configura os servidores Model Context Protocol disponíveis para os agentes deste espaço de trabalho. Os servidores MCP dão a um agente acesso a ferramentas e contexto externos — um índice de documentação, um sistema de acompanhamento de problemas, uma ferramenta de design, um explorador de bases de dados. Define cada servidor uma única vez aqui, e o Bromure Agentic Coding traduz o mesmo para o formato de configuração correto para cada agente ativado e injeta-o na VM no arranque.
A legenda do painel resume o fluxo: Os servidores MCP dão ao seu agente acesso a ferramentas e contexto externos. As configurações são traduzidas para o formato correto para o agente ativo (Claude Code ou Codex) e injetadas na VM no arranque. Sem nenhum configurado, lê-se Nenhum servidor MCP configurado.
Como os servidores são entregues aos agentes
Descreve cada servidor uma vez numa forma neutra. No arranque da sessão, o bromure escreve-o no formato nativo de cada agente ativado:
- Claude Code — combinado em
~/.claude.json. - Codex — escrito como um bloco TOML em
~/.codex/config.toml. - Grok Build — combinado no ficheiro de definições do utilizador do Grok.
Como isto acontece no arranque, adicionar, editar ou remover um servidor tem efeito na próxima vez que a sessão do espaço de trabalho é iniciada, e não em tempo real numa sessão em execução. Um interruptor de ativação por servidor permite manter uma definição em ficheiro enquanto a desliga para uma execução.
Adicionar um servidor
Clique em Adicionar servidor para acrescentar uma linha. Os novos servidores usam por predefinição o transporte HTTP e estão ativados. Cada linha tem os seguintes controlos no seu cabeçalho:
- Nome — o identificador do servidor (marcador de posição
my-server). - Transporte — um controlo segmentado, HTTP ou STDIO. Fica oculto enquanto a linha estiver em modo JSON (ver abaixo).
- Interruptor de ativação — liga ou desliga este servidor de forma independente.
- Editar como JSON — um botão de chavetas que substitui o formulário por um editor JSON em bruto. O JSON que introduz é passado diretamente para a configuração do agente e validado inline; o botão passa então a ler Mudar para formulário para regressar.
- Remover — o botão de menos elimina a linha.
Os campos abaixo do cabeçalho dependem do transporte.
Servidores STDIO
Um servidor STDIO é um comando lançado dentro da VM que fala MCP através da entrada e saída padrão. Dois campos:
- Comando — o executável (marcador de posição
npx). - Argumentos — argumentos separados por espaços (marcador de posição
-y @upstash/context7-mcp).
Servidores HTTP
Um servidor HTTP é um ponto de extremidade MCP remoto. O seu campo URL recebe o endereço do servidor (marcador de posição https://mcp.example.com/mcp), e uma secção expansível Autenticação contém a credencial. Existem duas formas de autenticar, e ambas mantêm o token real no anfitrião — a VM apenas contém um falso, trocado na transmissão pelo proxy limitado ao anfitrião do servidor:
- Autorizar com OAuth… — executa um intermediário OAuth do lado do anfitrião. Depois de autorizado, a linha mostra Autorizado com uma expiração ("expira …") e botões Reautorizar / Revogar, e a variável de ambiente do token é nomeada automaticamente
MCP_OAUTH_<NAME>. - Token estático — em "Ou introduza um token estático:", defina um Nome da variável de ambiente (por exemplo
FIGMA_OAUTH_TOKEN) e cole o Token no campo seguro. O campo do token tem a legenda Nunca enviado para a VM — trocado pelo proxy.
Para servidores HTTP que transportam um token bearer, o proxy também responde aos caminhos de descoberta OAuth do anfitrião do servidor, para que o agente dentro da VM trate o servidor como pré-autenticado e não tente o seu próprio fluxo OAuth (impossível na VM). A troca do token bearer está documentada juntamente com as outras famílias de credenciais em Credenciais e a fronteira de transmissão.
Servidores MCP vs. o servidor de automatização da própria aplicação
Duas coisas diferentes partilham as letras "MCP", e vale a pena mantê-las separadas:
- Este painel configura os servidores MCP que o agente dentro da VM consome como ferramentas.
- A funcionalidade de Automatização da aplicação expõe um servidor MCP que permite a um agente externo controlar o próprio Bromure Agentic Coding (abrir espaços de trabalho, gerir sessões). É o subcomando
bromure-cli mcp, configurado no painel Automatização e documentado em Automatização e a CLI.
Referência de definições
| Definição | Tipo | Predefinição | Descrição |
|---|---|---|---|
| Lista de servidores | Lista de linhas de servidor | Vazia | Cada servidor tem um nome, transporte, interruptor de ativação e um botão de alternância do editor JSON. |
| Transporte | Segmentado: HTTP / STDIO | HTTP | HTTP = URL remoto; STDIO = um comando lançado na VM. Oculto em modo JSON. |
| Ativado | Interruptor (por servidor) | Ligado | Liga ou desliga um servidor sem o eliminar. |
| Editar como JSON | Botão de alternância | Modo de formulário | Substitui o formulário por uma configuração JSON em bruto, validada inline e passada diretamente. |
| Comando / Argumentos | Texto (STDIO) | Vazio | O executável e os seus argumentos separados por espaços. |
| URL | Texto (HTTP) | Vazio | O endereço do ponto de extremidade MCP remoto. |
| Autenticação | Intermediário OAuth ou token bearer estático (HTTP) | Nenhuma | O OAuth nomeia automaticamente MCP_OAUTH_<NAME>; um token estático usa uma variável de ambiente que você nomeia. O token real permanece no anfitrião e é trocado na transmissão. |
| Adicionar servidor | Botão | — | Acrescenta uma nova linha de servidor HTTP, ativada. |
Capítulos relacionados
- Automatização e a CLI — o servidor MCP da própria aplicação (
bromure-cli mcp) para controlar o Bromure Agentic Coding a partir de um agente externo. - Credenciais e a fronteira de transmissão — como os tokens bearer de MCP por HTTP são mantidos no anfitrião e trocados na transmissão.
- Agentes — quais os agentes ativados e qual é o principal; cada um recebe a configuração MCP traduzida no arranque.
- Referência de definições — todos os painéis num relance.