AI 규칙(AI Rule)
ServBay MCP를 연동해도, AI 도구는 ServBay를 호출할 수는 있지만, 언제·어떻게 활용해야 하는지 명확히 알지 못합니다. **AI 규칙(AI Rule)**은 AI에게 주는 안내서로, 로컬 서비스·웹사이트·도메인·HTTPS·포트·데이터베이스·백업 등과 관련된 문제를 만날 때, 환경설정을 우회하는 코드 수정 대신 ServBay MCP를 우선적으로 점검 및 조작하도록 알려줍니다. 본 문서는 AI 규칙 설치 방법을 안내합니다.
AI 규칙의 효과
- AI가 MCP 우선 사용하도록 안내 — “사이트 접속 불가 / 502 / 포트 점유 / 인증서 오류” 등 로컬 환경 문제 발생 시, 무작정 코드 수정보다 ServBay MCP로 상태를 먼저 점검하도록 만듭니다.
- 보안 경계 규정 — 데이터 쓰기나 파괴적 작업 전 사용자의 별도 확인을 받아오고, 대화에서 키 등 민감 정보 요청을 금지합니다.
- 반복 설명 최소화 — 규칙은 항상 적용돼, 매 세션마다 일관된 AI 행동을 기대할 수 있습니다.
사전 조건
- ServBay가 설치 및 실행 중이어야 합니다.
- ServBay MCP 연동이 완료되어 있으면 더욱 좋습니다.
워크스페이스 규칙 vs 글로벌 규칙
AI 규칙은 두 가지 범주로 설치할 수 있습니다:
- 워크스페이스(Workspace) 규칙 — 특정 프로젝트 폴더 내에 규칙 파일을 저장, 해당 프로젝트에만 적용합니다. 프로젝트별 커스터마이즈에 적합합니다.
- 글로벌(Global) 규칙 — AI 도구의 사용자 설정에 적용, 모든 프로젝트에 영향을 미칩니다. 현재 Claude Code와 Codex에서만 글로벌 지원이 가능합니다.
AI 규칙 설치 방법
ServBay 설정 > AI 클라이언트 통합(IDE Integrations) 메뉴에서, 각 클라이언트 행의 AI 규칙 설치(Install AI Rule) 를 클릭하세요. 워크스페이스 설치 시에는 대상 프로젝트 폴더를 선택해야 합니다. ServBay는 해당 규칙 파일을 새로 생성 또는 업데이트합니다. 제거하려면 AI 규칙 제거(Remove AI Rule) 를 클릭하세요.
워크스페이스 규칙 파일 위치
| 클라이언트 | 규칙 파일 (프로젝트 루트 기준) |
|---|---|
| VS Code | .github/instructions/servbay-mcp.instructions.md |
| Cursor | .cursor/rules/servbay-mcp.mdc |
| Codex | AGENTS.md |
| Claude Code | CLAUDE.md |
글로벌 규칙 파일 위치
| 클라이언트 | 규칙 파일 |
|---|---|
| Claude Code | ~/.claude/CLAUDE.md (공식 사용자 메모리, 세션 시작 시 로드) |
| Codex | ~/.codex/AGENTS.md (공식 글로벌 메모리) |
병합 전략: 기존 내용 보존
ServBay는 마크 병합 방식으로 규칙을 작성합니다. ServBay 규칙 섹션만 특정 마크로 감싸서 해당 영역만 갱신하고, 동일 파일 내 기존 내용은 항상 보존합니다. 이미 있는 CLAUDE.md / AGENTS.md 파일에 규칙을 넣어도 기존 데이터가 삭제되지 않으니, 안심하고 사용하실 수 있습니다. 제거 시에도 위탁 영역만 제거됩니다.
자주 묻는 질문(FAQ)
- Q: AI 규칙을 설치하면 기존
CLAUDE.md/AGENTS.md내용이 덮어써지나요?- A: 아닙니다. ServBay는 마크로 감싼 규칙 영역만 관리하므로, 다른 내용은 변경되지 않습니다.
- Q: 내 클라이언트에 ‘글로벌 규칙’ 옵션이 없는 이유는?
- A: 글로벌 규칙은 현재 Claude Code와 Codex만 지원합니다. 기타 클라이언트는 워크스페이스 규칙을 이용하세요.
- Q: AI 규칙과 MCP 연동은 어떤 차이가 있나요?
- A: MCP 연동은 AI가 ServBay를 활용 가능하게 하고, AI 규칙은 언제·어떻게 활용할지 인지하게 합니다. 함께 쓰면 최상의 효과를 낼 수 있습니다.
- Q: Cursor / VS Code 프로젝트의 규칙 파일이 Git에 커밋되나요?
- A: 규칙 파일은 프로젝트 폴더에 저장됩니다. 버전관리 여부는
.gitignore설정에 따라 달라지며, 팀 내 규칙에 맞게 처리하실 수 있습니다.
- A: 규칙 파일은 프로젝트 폴더에 저장됩니다. 버전관리 여부는
요약
AI 규칙은 ServBay MCP 사용 가이드로, AI가 로컬 개발환경 문제를 처리할 때 ServBay를 우선·정확·안전하게 사용하도록 안내합니다. 워크스페이스 및 글로벌 설치를 지원하며, 마크 병합 방식으로 기존 내용을 안전하게 보호합니다. 설치 즉시, 여러분의 AI 도구가 로컬 환경 관리의 든든한 조력자가 될 수 있습니다.
