Regras de AI (AI Rule)
Após integrar o ServBay MCP, as ferramentas de IA passam a conseguir utilizar o ServBay, mas não necessariamente “sabem” quando ou como utilizá-lo corretamente. As Regras de AI (AI Rule) funcionam como um manual para a IA — orientam a IA sobre a melhor forma de agir quando questões de serviços locais, sites, domínios, HTTPS, portas, bancos de dados ou backups estiverem envolvidos, indicando que, nesse contexto, deve-se priorizar o uso do ServBay MCP para checagem e operações antes de modificar o código da aplicação para contornar problemas de ambiente. Veja neste artigo como instalar as regras de AI.
Problemas resolvidos pelas Regras de AI
- Fazer a IA priorizar o MCP — Ao enfrentar problemas de ambiente local como “site fora do ar / 502 / porta ocupada / erro de certificado”, a IA verificará o status pelo ServBay MCP antes de sugerir mudanças no código.
- Normatizar limites de segurança — Antes de executar operações destrutivas ou de escrita, a IA irá explicar e pedir confirmação. Chaves e informações sensíveis não serão pedidas ou coladas durante conversas.
- Reduzir explicações repetidas — As regras ficam sempre ativas, fazendo com que a IA respeite os mesmos combinados em toda sessão.
Pré-requisitos
- ServBay já instalado e em execução.
- Recomenda-se ter realizado a integração do ServBay MCP.
Nível de Workspace vs Nível Global
As regras de IA podem ser instaladas em dois níveis:
- Workspace (Projeto) — O arquivo de regra é salvo dentro do diretório de um projeto específico, valendo só para ele. Ideal para customizar regras por projeto.
- Global — A regra é escrita para a configuração do usuário da ferramenta de IA, valendo para todos os projetos. Atualmente, apenas Claude Code e Codex suportam o nível global.
Como instalar as Regras de AI
Acesse Configurações do ServBay (Settings) → Integrações de Cliente de IA (IDE Integrations) e, na linha do cliente desejado, clique em Instalar Regra de AI (Install AI Rule). Para instalação de workspace, selecione antes a pasta do projeto. O ServBay irá criar ou atualizar o arquivo de regras correspondente. Para remover, use o botão Remover Regra de AI (Remove AI Rule).
Localização do arquivo de regra em workspace
| Cliente | Arquivo de Regra (relativo ao raiz do projeto) |
|---|---|
| VS Code | .github/instructions/servbay-mcp.instructions.md |
| Cursor | .cursor/rules/servbay-mcp.mdc |
| Codex | AGENTS.md |
| Claude Code | CLAUDE.md |
Localização do arquivo de regra global
| Cliente | Arquivo de Regra |
|---|---|
| Claude Code | ~/.claude/CLAUDE.md (memória oficial do usuário, carregada ao iniciar uma sessão) |
| Codex | ~/.codex/AGENTS.md (memória global oficial) |
Estratégia de Mesclagem: Não sobrescreva seus conteúdos
O ServBay utiliza uma estratégia de mesclagem por marcação ao gravar regras: o conteúdo gerenciado pelo ServBay é delimitado por comentários especiais, e só a área entre essas marcações é atualizada — qualquer outro conteúdo que você já tenha nesse arquivo será preservado. Assim, é seguro adicionar regras nos seus arquivos existentes CLAUDE.md / AGENTS.md, pois seus dados anteriores não serão perdidos nem removidos ao retirar a regra, apenas o trecho gerenciado pelo ServBay será afetado.
FAQ (Perguntas Frequentes)
- P: Instalar as regras de AI sobrescreve meu
CLAUDE.md/AGENTS.md?- R: Não. O ServBay só atualiza a parte gerida, demarcada pelas marcações; seus outros conteúdos permanecem intactos.
- P: Por que não aparece a opção de “regra global” no meu cliente?
- R: Apenas Claude Code e Codex têm suporte ao nível global no momento; demais clientes devem usar a instalação por workspace.
- P: Qual a relação entre regras de AI e a integração com MCP?
- R: A integração MCP faz a IA ser capaz de usar o ServBay; a regra de IA faz a IA saber quando e como usar. Juntos, garantem o melhor resultado.
- P: Os arquivos de regras do projeto Cursor / VS Code vão para o Git?
- R: Como são arquivos salvos no diretório do projeto, sua inclusão no versionamento depende do seu
.gitignore— avalie e configure conforme a política do seu time.
- R: Como são arquivos salvos no diretório do projeto, sua inclusão no versionamento depende do seu
Resumo
As Regras de AI funcionam como o “manual de uso” do ServBay MCP, garantindo que a IA utilize o ServBay da forma mais adequada, segura e eficiente ao lidar com problemas de ambiente local. Permite instalação tanto por workspace quanto global e, com a estratégia de mesclagem por marcação, protege seus arquivos existentes. Após instalar, sua ferramenta de IA será uma aliada ainda mais eficaz no gerenciamento do ambiente local.
