Usa FortressFlag desde un agente de IA

Si trabajas con un agente de programación con IA, puedes darle tus flags. «Desactiva new-checkout en producción» es una frase con una llamada exacta a la API detrás — y una que toca a tus usuarios reales, y por eso esta guía dedica tanto tiempo a los límites como a la configuración.

FortressFlag incluye un servidor MCP: un pequeño programa que se ejecuta en tu propia máquina, junto a tu agente, y le entrega un conjunto de herramientas de flags.

Qué puede y qué no puede hacer

La versión corta: tu agente puede hacer exactamente lo que puedes hacer tú, y menos.

El servidor guarda un token de API que actúa como tú — tu rol, tu acceso a proyectos, tu organización. Habla con FortressFlag a través de la misma API pública que usa el panel, así que cada comprobación de permisos, lista de permitidos de proyectos y registro de auditoría es idéntico a que tú pulses el botón. No existe una vía de acceso especial para agentes.

Algunas cosas están deliberadamente fuera del alcance de un agente:

• Aprobar una propuesta de producción. La gracia de un segundo par de ojos es que pertenezcan a una persona.
• Eliminar un flag de forma permanente.
• Crear claves SDK o tokens de API. Un secreto de un solo uso devuelto a un agente acaba en la transcripción de una conversación.
• Gestionar miembros, facturación o acuerdos legales.

Configúralo

1. Crea un token. En el panel, ve a la página de tu cuenta y busca Tokens de API. Dale un nombre que reconozcas, elige un alcance y copia el token — se muestra una vez.

Elige Solo lectura salvo que quieras que el agente haga cambios. Siempre puedes crear un segundo token más adelante.

2. Apunta tu agente al servidor. La mayoría de los clientes MCP aceptan un pequeño bloque de configuración que nombra un comando y su entorno:

{
  "mcpServers": {
    "fortressflag": {
      "command": "ffmcp",
      "env": {
        "FORTRESSFLAG_TOKEN": "ffm_your_token_here",
        "FORTRESSFLAG_API_URL": "https://your-fortressflag-api"
      }
    }
  }
}

El token va en env, nunca en args — los argumentos de la línea de comandos son visibles para otros usuarios en una máquina compartida.

3. Añade --allow-writes cuando quieras cambios. Sin él, el servidor ofrece solo herramientas de lectura. Con él, tu agente puede activar, crear, renombrar, archivar y restaurar flags — siempre limitado por lo que permite tu rol:

"args": ["--allow-writes"]

Trata esa opción como una comodidad, no como un candado. Si un agente no tiene por qué cambiar flags, dale además un token de solo lectura — esa es la parte que FortressFlag aplica de verdad.

Producción está protegida dos veces

Tu rol decide primero. Si eres Developer, no puedes escribir en producción directamente — así que tu agente tampoco. Lo que puede hacer es proponer el cambio, exactamente como harías tú: un segundo compañero lo aplica, y nadie puede aprobar su propia propuesta. Mira aprobaciones en producción.

La herramienta pregunta otra vez, en segundo lugar. Antes de tocar un entorno de producción, el agente tiene que declarar que es su intención, nombrando el entorno. Esa comprobación lee la clase producción del entorno, no su nombre — así que un entorno que llamaste live está protegido exactamente igual que uno llamado prod, y uno que simplemente se llama prod pero no es de clase producción no te dará la lata.

Esta segunda comprobación existe porque el error realista no es un atacante. Es un agente al que se le pidió cambiar algo en staging y que alarga la mano hacia la clave de entorno equivocada.

Los datos de tus flags entran en la conversación

Conviene ser claros: cualquier cosa que el agente lea pasa a formar parte de su conversación con el servicio de IA que use. Eso incluye nombres, claves y descripciones de flags escritos por tu equipo y — si le pides que lea el historial de auditoría — los nombres y direcciones de correo de tus compañeros.

De ahí se siguen dos cosas.

Trata las descripciones de los flags como entrada no confiable. Cualquiera que pueda crear un flag puede escribir cualquier cosa en su descripción, incluido texto que se lea como una instrucción para el agente. El servidor le dice al agente, de entrada y en cada herramienta, que esos valores son datos de tu organización y nunca instrucciones. Eso ayuda; no es una garantía, y es una razón para pensar bien de quién son los flags que lee un agente.

No podemos ver ni gobernar esa transcripción. Es cosa entre tú y tu proveedor de IA. Nada sobre cómo FortressFlag almacena o transmite tus datos cambia cuando usas esto — las herramientas son solo otro cliente de la misma API.

Lo que todavía no está

• Solo se ejecuta en local. El servidor habla con tu agente a través de su entrada y salida estándar, en tu máquina. No hay una versión alojada a la que apuntar un agente remoto.
• Todavía no hay binarios descargables — por ahora se compila desde el código fuente.
• Las reglas de targeting y los segmentos no son editables por un agente. Leer flags, activarlos o desactivarlos y proponer cambios en producción sí lo son; el editor de reglas es una superficie mayor que merece su propia ronda de diseño.
• Listar propuestas pendientes requiere permiso de aprobador. El token de un Developer puede proponer un cambio en producción pero no puede después listarlo — es el permiso de la API subyacente, no una peculiaridad de las herramientas.