Regole AI (AI Rule)

Dopo aver integrato ServBay MCP, gli strumenti di intelligenza artificiale possono “tecnicamente” interagire con ServBay, ma non sempre "sanno" quando e come farlo. Le Regole AI (AI Rule) sono una sorta di manuale operativo per l’AI: spiegano che per questioni legate a servizi locali, siti web, domini, HTTPS, porte, database o backup, l’AI deve innanzitutto utilizzare ServBay MCP per verifiche e operazioni, invece di modificare il codice applicativo per aggirare i problemi ambientali. In questo articolo scoprirai come installare le Regole AI.

Quali problemi risolvono le Regole AI

• Fanno usare MCP come prima scelta all’AI — In caso di problemi ambientali locali tipo “il sito non si apre / 502 / porta occupata / errore certificato”, l’AI controllerà lo stato tramite ServBay MCP, invece di modificare il codice senza criterio.
• Definiscono confini di sicurezza — Prima di scrivere o compiere azioni distruttive, l’AI fornirà spiegazioni e chiedera conferma, evitando di richiedere o incollare chiavi sensibili durante una conversazione.
• Riduci spiegazioni ripetute — Le regole rimangono attive così che ogni sessione dell’AI rispetti le stesse convenzioni operative.

Prerequisiti

• ServBay deve essere già installato ed eseguito.
• Si consiglia di aver completato l’integrazione con ServBay MCP.

Livello workspace vs Livello globale

Le Regole AI possono essere installate a due livelli:

• Livello Workspace — Il file di regole viene salvato in una specifica cartella di progetto, influenzando solo quel progetto. Ideale per regole personalizzate per ogni progetto.
• Livello Globale — Le regole vengono scritte nella configurazione utente degli strumenti AI, valide per tutti i progetti. Attualmente solo Claude Code e Codex supportano il livello globale.

Come installare le Regole AI

Accedi a ServBay Impostazioni → Integrazioni AI (IDE Integrations) e clicca su Installa AI Rule accanto al client di tuo interesse. Per l’installazione a livello workspace, scegli prima la directory del progetto. ServBay creerà o aggiornerà automaticamente il file delle regole corrispondente. Per rimuoverle, clicca su Rimuovi AI Rule.

Posizione dei file regole a livello workspace

Client	File regole (relativo alla root del progetto)
VS Code	.github/instructions/servbay-mcp.instructions.md
Cursor	.cursor/rules/servbay-mcp.mdc
Codex	AGENTS.md
Claude Code	CLAUDE.md

Posizione dei file regole a livello globale

Client	File regole
Claude Code	~/.claude/CLAUDE.md (memoria utente ufficiale, caricata all’avvio di ogni sessione)
Codex	~/.codex/AGENTS.md (memoria globale ufficiale)

Strategia di fusione: il tuo contenuto non sarà sovrascritto

ServBay utilizza una strategia di fusione tramite tag per scrivere le regole: il contenuto controllato da ServBay viene delimitato con appositi marcatori. Viene aggiornato solo lo spazio tra questi tag, mantenendo intatto qualsiasi altro contenuto tu abbia già aggiunto nello stesso file. Puoi quindi inserire le regole in un CLAUDE.md o AGENTS.md esistente senza rischiare di perdere materiale: la rimozione eliminerà solamente l’area gestita da ServBay.

Domande frequenti (FAQ)

• D: Installare le Regole AI sovrascriverà il mio CLAUDE.md o AGENTS.md esistenti?
  • R: No, ServBay aggiorna solo la zona delimitata dai suoi tag. Il resto del tuo contenuto rimarrà invariato.
• D: Perché nel mio client non vedo l’opzione “regole globali”?
  • R: In questo momento, solo Claude Code e Codex supportano le regole a livello globale; negli altri client usa le regole di workspace.
• D: Che relazione c’è tra Regole AI e integrazione MCP?
  • R: L’integrazione MCP permette all’AI di poter chiamare ServBay; le Regole AI le permettono di sapere quando e come farlo. La combinazione delle due funzionalità garantisce i migliori risultati.
• D: I file delle regole nei progetti Cursor/VS Code verranno aggiunti a Git?
  • R: Le regole sono file presenti nella cartella del progetto. Se vengono inclusi nel versionamento dipende dal tuo .gitignore e può essere gestito secondo le convenzioni del tuo team.

Sintesi

Le Regole AI rappresentano il “manuale d’uso” di ServBay MCP, assicurando che l’AI utilizzi ServBay come primo strumento – in modo corretto e sicuro – quando si trova a gestire problemi degli ambienti di sviluppo locali. Sono supportate installazioni sia a livello di workspace che globale, e la strategia di fusione protegge i tuoi contenuti già presenti. Una volta installate, il tuo strumento AI sarà veramente un affidabile assistente per la gestione dell’ambiente locale.