MCP
El panel MCP configura los servidores del Model Context Protocol disponibles para los agentes de este espacio de trabajo. Los servidores MCP dan a un agente acceso a herramientas y contexto externos: un índice de documentación, un rastreador de incidencias, una herramienta de diseño, un explorador de bases de datos. Defines cada servidor una sola vez aquí, y Bromure Agentic Coding lo traduce al formato de configuración correcto para cada agente habilitado y lo inyecta en la VM en el arranque.
El pie del panel resume el flujo: Los servidores MCP dan a tu agente acceso a herramientas y contexto externos. Las configuraciones se traducen al formato correcto para el agente activo (Claude Code o Codex) y se inyectan en la VM en el arranque. Sin ninguno configurado, muestra No hay servidores MCP configurados.
Cómo se entregan los servidores a los agentes
Describes cada servidor una sola vez en una forma neutral. En el arranque de la sesión, bromure lo escribe en el formato nativo de cada agente habilitado:
- Claude Code — combinado en
~/.claude.json. - Codex — escrito como un bloque TOML en
~/.codex/config.toml. - Grok Build — combinado en el archivo de configuración de usuario de Grok.
Como esto ocurre en el arranque, añadir, editar o eliminar un servidor surte efecto la próxima vez que se inicie la sesión del espacio de trabajo, no en directo en una sesión en ejecución. El interruptor de habilitación por servidor te permite conservar una definición en el archivo mientras la desactivas para una ejecución.
Añadir un servidor
Haz clic en Añadir servidor para agregar una fila. Los servidores nuevos usan por defecto el transporte HTTP y están habilitados. Cada fila tiene los siguientes controles en su encabezado:
- Nombre — el identificador del servidor (marcador de posición
my-server). - Transporte — un control segmentado, HTTP o STDIO. Se oculta mientras la fila está en modo JSON (ver más abajo).
- Interruptor de habilitación — activa o desactiva este servidor de forma independiente.
- Editar como JSON — un botón de llaves que sustituye el formulario por un editor de JSON en bruto. El JSON que introduces se pasa directamente a la configuración del agente y se valida en línea; el botón entonces muestra Cambiar a formulario para volver.
- Eliminar — el botón de menos borra la fila.
Los campos debajo del encabezado dependen del transporte.
Servidores STDIO
Un servidor STDIO es un comando lanzado dentro de la VM que habla MCP a través de la entrada y salida estándar. Dos campos:
- Comando — el ejecutable (marcador de posición
npx). - Argumentos — argumentos separados por espacios (marcador de posición
-y @upstash/context7-mcp).
Servidores HTTP
Un servidor HTTP es un punto de conexión MCP remoto. Su campo URL toma la dirección del servidor (marcador de posición https://mcp.example.com/mcp), y una sección desplegable de Autenticación contiene la credencial. Hay dos formas de autenticarse, y ambas mantienen el token real en el anfitrión: la VM solo contiene un token falso, intercambiado en la red por el proxy limitado al anfitrión del servidor:
- Autorizar con OAuth… — ejecuta un intermediario OAuth del lado del anfitrión. Una vez autorizado, la fila muestra Autorizado con una caducidad ("expira …") y los botones Volver a autorizar / Revocar, y la variable de entorno del token se nombra automáticamente
MCP_OAUTH_<NAME>. - Token estático — bajo "O introduce un token estático:", establece un Nombre de variable de entorno (por ejemplo
FIGMA_OAUTH_TOKEN) y pega el Token en el campo seguro. El campo del token lleva el pie Nunca se envía a la VM — intercambiado por el proxy.
Para los servidores HTTP que llevan un token bearer, el proxy también responde a las rutas de descubrimiento OAuth del anfitrión del servidor, de modo que el agente dentro de la VM trata al servidor como preautenticado y no intenta su propio flujo OAuth (imposible en la VM). El intercambio del token bearer está documentado junto a las demás familias de credenciales en Credenciales y el límite de red.
Servidores MCP frente al propio servidor de automatización de la app
Dos cosas diferentes comparten las letras "MCP", y conviene distinguirlas:
- Este panel configura los servidores MCP que el agente dentro de la VM consume como herramientas.
- La función de Automatización de la app expone un servidor MCP que permite a un agente externo controlar la propia Bromure Agentic Coding (abrir espacios de trabajo, gestionar sesiones). Ese es el subcomando
bromure-cli mcp, configurado en el panel Automatización y documentado en Automatización y la CLI.
Referencia de ajustes
| Ajuste | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| Lista de servidores | Lista de filas de servidor | Vacía | Cada servidor tiene un nombre, transporte, interruptor de habilitación y un conmutador de editor JSON. |
| Transporte | Segmentado: HTTP / STDIO | HTTP | HTTP = URL remota; STDIO = un comando lanzado en la VM. Oculto en modo JSON. |
| Habilitado | Interruptor (por servidor) | Activado | Activa o desactiva un servidor sin eliminarlo. |
| Editar como JSON | Botón conmutador | Modo formulario | Sustituye el formulario por una configuración JSON en bruto, validada en línea y pasada directamente. |
| Comando / Argumentos | Texto (STDIO) | Vacío | El ejecutable y sus argumentos separados por espacios. |
| URL | Texto (HTTP) | Vacío | La dirección del punto de conexión MCP remoto. |
| Autenticación | Intermediario OAuth o token bearer estático (HTTP) | Ninguno | OAuth nombra automáticamente MCP_OAUTH_<NAME>; un token estático usa una variable de entorno que tú nombras. El token real permanece en el anfitrión y se intercambia en la red. |
| Añadir servidor | Botón | — | Agrega una nueva fila de servidor HTTP, habilitada. |
Capítulos relacionados
- Automatización y la CLI — el propio servidor MCP de la app (
bromure-cli mcp) para controlar Bromure Agentic Coding desde un agente externo. - Credenciales y el límite de red — cómo se mantienen los tokens bearer MCP HTTP en el anfitrión y se intercambian en la red.
- Agentes — qué agentes están habilitados y cuál es el principal; cada uno recibe la configuración MCP traducida en el arranque.
- Referencia de ajustes — todos los paneles de un vistazo.