Usa FortressFlag da un agente IA

Se lavori con un agente di coding con IA, puoi dargli i tuoi flag. «Spegni new-checkout in produzione» è una frase con dietro una chiamata API esatta — e una che tocca i tuoi utenti reali, motivo per cui questa guida dedica ai limiti lo stesso tempo che dedica alla configurazione.

FortressFlag include un server MCP: un piccolo programma che gira sulla tua macchina, accanto al tuo agente, e gli mette in mano un insieme di strumenti per i flag.

Cosa può e cosa non può fare

La versione breve: il tuo agente può fare esattamente ciò che puoi fare tu, e meno.

Il server detiene un token API che agisce come te — il tuo ruolo, il tuo accesso ai progetti, la tua organizzazione. Parla con FortressFlag attraverso la stessa API pubblica che usa la dashboard, quindi ogni controllo dei permessi, ogni allowlist dei progetti e ogni voce di audit sono identici a te che premi il pulsante. Non esiste un percorso di accesso speciale per gli agenti.

Alcune cose sono deliberatamente indisponibili a un agente, punto:

• Approvare una proposta di produzione. Tutto il senso di un secondo paio di occhi è che appartengano a una persona.
• Eliminare definitivamente un flag.
• Creare chiavi SDK o token API. Un segreto monouso restituito a un agente finisce nella trascrizione di una conversazione.
• Gestire membri, fatturazione o contratti legali.

Configuralo

1. Crea un token. Nella dashboard, vai alla pagina del tuo account e trova Token API. Dagli un nome che riconoscerai, scegli un ambito e copia il token — viene mostrato una volta sola.

Scegli Sola lettura a meno che tu non voglia che l’agente faccia modifiche. Puoi sempre creare un secondo token più avanti.

2. Punta il tuo agente al server. La maggior parte dei client MCP accetta un piccolo blocco di configurazione che indica un comando e il suo ambiente:

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

Il token va in env, mai in args — gli argomenti da riga di comando sono visibili agli altri utenti su una macchina condivisa.

3. Aggiungi --allow-writes quando vuoi modifiche. Senza, il server offre solo strumenti di lettura. Con, il tuo agente può attivare, creare, rinominare, archiviare e ripristinare flag — sempre limitato da ciò che il tuo ruolo permette:

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

Tratta quell’opzione come una comodità, non come un lucchetto. Se un agente non ha motivo di cambiare flag, dagli anche un token in sola lettura — quella è la parte che FortressFlag applica davvero.

La produzione è protetta due volte

Prima decide il tuo ruolo. Se sei un Developer, non puoi scrivere direttamente in produzione — quindi nemmeno il tuo agente può. Ciò che può fare è proporre la modifica, esattamente come faresti tu: un secondo collega la applica, e nessuno può approvare la propria proposta. Vedi approvazioni di produzione.

Poi lo strumento chiede di nuovo. Prima di toccare un ambiente di produzione l’agente deve dichiarare che intende farlo, nominando l’ambiente. Quel controllo legge la classe produzione dell’ambiente, non il suo nome — quindi un ambiente che hai chiamato live è protetto esattamente come uno chiamato prod, e uno che si chiama soltanto prod senza essere di classe produzione non ti assillerà.

Questo secondo controllo esiste perché l’errore realistico non è un attaccante. È un agente a cui è stato chiesto di cambiare qualcosa in staging e che prende la chiave dell’ambiente sbagliato.

I dati dei tuoi flag finiscono nella conversazione

Vale la pena dirlo chiaramente: tutto ciò che l’agente legge diventa parte della sua conversazione con qualunque servizio di IA usi. Questo include nomi, chiavi e descrizioni dei flag scritti dal tuo team e — se gli chiedi di leggere lo storico di audit — i nomi e gli indirizzi email dei tuoi colleghi.

Ne seguono due cose.

Tratta le descrizioni dei flag come input non affidabile. Chiunque possa creare un flag può scrivere qualsiasi cosa nella sua descrizione, compreso un testo che suona come un’istruzione per l’agente. Il server dice all’agente, in anticipo e su ogni strumento, che quei valori sono dati della tua organizzazione e mai istruzioni. Aiuta; non è una garanzia, ed è un motivo per riflettere su quali flag un agente legge.

Non possiamo vedere né governare quella trascrizione. È tra te e il tuo fornitore di IA. Nulla di come FortressFlag memorizza o trasmette i tuoi dati cambia quando usi questo — gli strumenti sono solo un altro client della stessa API.

Cosa non c’è ancora

• Gira solo in locale. Il server parla con il tuo agente attraverso il suo standard input e output, sulla tua macchina. Non esiste una versione ospitata a cui puntare un agente remoto.
• Ancora nessun binario scaricabile — per ora si compila dai sorgenti.
• Le regole di targeting e i segmenti non sono modificabili da un agente. Leggere i flag, attivarli e proporre modifiche di produzione sì; l’editor delle regole è una superficie più grande che merita un proprio ciclo di progettazione.
• Elencare le proposte in sospeso richiede il permesso di approvatore. Il token di un Developer può proporre una modifica di produzione ma poi non può elencarla — è il permesso dell’API sottostante, non una stranezza degli strumenti.