Reglas de AI (AI Rule)
Después de integrar ServBay MCP, aunque las herramientas de AI ya pueden llamar a ServBay, no necesariamente "saben" cuándo ni cómo usarlo correctamente. Las reglas de AI (AI Rule) son una guía escrita para la inteligencia artificial: explican que, ante problemas relacionados con servicios locales, sitios web, dominios, HTTPS, puertos, bases de datos o backups, el AI debe usar ServBay MCP para verificar y operar con prioridad, en lugar de modificar el código de la aplicación y saltarse el entorno. En este documento aprenderás cómo instalar las reglas de AI.
¿Qué problemas resuelven las reglas de AI?
- Prioriza el uso de MCP por el AI — Cuando surgen problemas locales como "el sitio no carga / 502 / puerto en uso / error de certificado", primero se debe comprobar el estado con ServBay MCP, en vez de cambiar el código sin dirección.
- Define límites de seguridad — Antes de escribir o realizar acciones destructivas, el AI debe avisar y pedir confirmación; nunca solicitará ni pegará llaves ni información sensible en una conversación.
- Reduce explicaciones repetitivas — Las reglas están siempre presentes y garantizan comportamientos consistentes en cada sesión del AI.
Requisitos previos
- ServBay ya instalado y en funcionamiento.
- Se recomienda haber realizado la integración de ServBay MCP.
Workspace vs Global
Las reglas de AI pueden instalarse en dos niveles:
- Nivel Workspace — El archivo de reglas se guarda en el directorio de un proyecto específico, por lo que solo afecta a ese proyecto. Ideal para personalización por proyecto.
- Nivel Global — El archivo de reglas se añade a la configuración de usuario de la herramienta de AI y afecta a todos los proyectos. Por ahora, solo Claude Code y Codex soportan el nivel global.
Instalación de reglas de AI
Ve a Configuración de ServBay (Settings) → Integraciones de AI (IDE Integrations) y haz clic en Instalar reglas de AI (Install AI Rule) en la fila correspondiente al cliente de AI. Para instalar a nivel workspace, primero selecciona la carpeta de tu proyecto objetivo. ServBay creará o actualizará el archivo de reglas correspondiente. Para desinstalar, haz clic en Eliminar reglas de AI (Remove AI Rule).
Ubicación de archivos de reglas a nivel de workspace
| Cliente | Archivo de reglas (relativo a la raíz del proyecto) |
|---|---|
| VS Code | .github/instructions/servbay-mcp.instructions.md |
| Cursor | .cursor/rules/servbay-mcp.mdc |
| Codex | AGENTS.md |
| Claude Code | CLAUDE.md |
Ubicación de archivos de reglas a nivel global
| Cliente | Archivo de reglas |
|---|---|
| Claude Code | ~/.claude/CLAUDE.md (memoria oficial de usuario, cargada al iniciar sesión) |
| Codex | ~/.codex/AGENTS.md (memoria global oficial) |
Estrategia de fusión: tus contenidos están a salvo
ServBay utiliza una estrategia de fusión con marcas al escribir reglas: el contenido gestionado por ServBay se delimita con marcas específicas, y sólo se actualiza la zona entre estas marcas, conservando cualquier otro contenido que tengas en el mismo archivo. Por lo tanto, puedes escribir reglas en tus archivos existentes CLAUDE.md / AGENTS.md con plena seguridad: tu información no se perderá y, al eliminar las reglas, sólo se quita la parte gestionada.
Preguntas frecuentes (FAQ)
- P: ¿Instalar reglas de AI sobrescribirá mi archivo
CLAUDE.md/AGENTS.mdexistente?- R: No. ServBay solo actualiza la sección delimitada por sus propias marcas; tu contenido fuera de esas áreas permanece intacto.
- P: ¿Por qué en mi cliente no aparece la opción de “reglas globales”?
- R: Actualmente, solo Claude Code y Codex soportan reglas globales. Los demás clientes deben usar la instalación en workspace.
- P: ¿Cuál es la relación entre las reglas de AI y la integración de MCP?
- R: La integración de MCP permite que la AI pueda interactuar con ServBay; las reglas de AI le indican cuándo y cómo hacerlo. Funcionan mejor en conjunto.
- P: ¿Las reglas de los proyectos en Cursor / VS Code se agregan a Git?
- R: Las reglas se crean como archivos en la carpeta del proyecto; si se incluyen en el control de versiones depende de tu
.gitignorey de la política del equipo.
- R: Las reglas se crean como archivos en la carpeta del proyecto; si se incluyen en el control de versiones depende de tu
Resumen
Las reglas de AI son el “manual de usuario” de ServBay MCP para tu inteligencia artificial, guiando el uso correcto, seguro y prioritario de ServBay cuando se trate de entornos locales de desarrollo. Puedes instalarlas tanto a nivel workspace como global, respaldadas por una estrategia de fusión con marcas que protege tu contenido. Una vez instaladas, tu herramienta de AI será un auténtico asistente para gestionar tu entorno local.
