Quy tắc AI (AI Rule)
Sau khi tích hợp ServBay MCP, mặc dù công cụ AI có thể gọi ServBay, nhưng chưa chắc biết khi nào và cách thức sử dụng ServBay đúng đắn. Quy tắc AI (AI Rule) chính là một "hướng dẫn" dành cho AI – giúp AI hiểu rằng: Khi gặp các vấn đề về dịch vụ local, website, domain, HTTPS, cổng, cơ sở dữ liệu, backup,… thì nên ưu tiên kiểm tra và thao tác qua ServBay MCP, thay vì chỉnh mã nguồn phá vỡ môi trường. Bài viết này sẽ hướng dẫn bạn cách cài đặt AI Rule.
AI Rule giải quyết vấn đề gì?
- Giúp AI ưu tiên dùng MCP — Khi gặp các vấn đề môi trường như "không truy cập được site / 502 / trùng cổng / lỗi certificate", AI sẽ kiểm tra trạng thái với ServBay MCP trước, thay vì sửa code một cách ngẫu nhiên.
- Chuẩn hóa ranh giới an toàn — Cảnh báo trước khi ghi đè/thao tác nguy hiểm, không yêu cầu hoặc dán khóa bí mật trong hội thoại.
- Giảm phiền phức giải thích lại — AI Rule cố định, mỗi phiên AI luôn thực hiện đúng quy ước hành xử nhất quán.
Yêu cầu trước khi cài đặt
- Đã cài đặt và chạy ServBay.
- Nên hoàn tất tích hợp ServBay MCP.
Quy tắc workspace vs toàn cục
AI Rule có thể cài ở 2 cấp độ:
- Cấp workspace — File quy tắc đặt trong thư mục dự án cụ thể, chỉ áp dụng cho dự án đó. Phù hợp tùy biến riêng theo project.
- Cấp toàn cục (Global) — File quy tắc nằm trong cấu hình người dùng của công cụ AI và áp dụng toàn bộ dự án. Hiện chỉ Claude Code và Codex hỗ trợ cấp toàn cục.
Cài đặt AI Rule
Vào ServBay Settings → AI Client Integration (IDE Integrations), ở dòng công cụ tương ứng bấm Cài đặt Quy tắc AI (Install AI Rule); nếu cài cấp workspace thì chọn thư mục dự án đích. ServBay sẽ tạo mới hoặc cập nhật file quy tắc liên quan. Để gỡ hãy bấm Gỡ Quy tắc AI (Remove AI Rule).
Vị trí file quy tắc cấp workspace
| Công cụ | File quy tắc (tương đối root dự án) |
|---|---|
| VS Code | .github/instructions/servbay-mcp.instructions.md |
| Cursor | .cursor/rules/servbay-mcp.mdc |
| Codex | AGENTS.md |
| Claude Code | CLAUDE.md |
Vị trí file quy tắc cấp toàn cục
| Công cụ | File quy tắc |
|---|---|
| Claude Code | ~/.claude/CLAUDE.md (trí nhớ người dùng, nạp khi mở session) |
| Codex | ~/.codex/AGENTS.md (trí nhớ toàn cục) |
Chiến lược hợp nhất: không ghi đè nội dung của bạn
ServBay sử dụng chiến lược hợp nhất theo đánh dấu khi ghi quy tắc: nội dung quy tắc của ServBay sẽ được gói giữa các đánh dấu đặc biệt, chỉ cập nhật vùng nằm giữa các đánh dấu, giữ nguyên các phần nội dung khác bạn tự thêm trong cùng file. Do đó bạn có thể ghi quy tắc vào CLAUDE.md/AGENTS.md hiện tại một cách an toàn – nội dung của bạn không bị mất, khi gỡ cũng chỉ xóa vùng ServBay quản lý.
Câu hỏi thường gặp (FAQ)
- Hỏi: Việc cài AI Rule có làm ghi đè file
CLAUDE.md/AGENTS.mdtôi có sẵn không?- Trả lời: Không. ServBay chỉ ghi đè phần nội dung trong vùng đánh dấu được quản lý bởi nó, các nội dung khác vẫn giữ nguyên.
- Hỏi: Tại sao công cụ của tôi không có tùy chọn "quy tắc toàn cục"?
- Trả lời: Hiện chỉ Claude Code & Codex hỗ trợ quy tắc toàn cục; các công cụ khác hãy dùng cài đặt dạng workspace.
- Hỏi: AI Rule liên quan thế nào đến kết nối MCP?
- Trả lời: MCP giúp AI có thể gọi ServBay, AI Rule giúp AI biết khi nào, làm thế nào để dùng. Hai thành phần này phối hợp thì hiệu quả tối ưu.
- Hỏi: Quy tắc trong dự án Cursor/VS Code có bị đẩy lên Git không?
- Trả lời: File quy tắc nằm trong thư mục dự án, có commit vào phiên bản git không là do
.gitignorecủa bạn, hãy thiết lập theo quy định của nhóm.
- Trả lời: File quy tắc nằm trong thư mục dự án, có commit vào phiên bản git không là do
Tổng kết
Quy tắc AI chính là "hướng dẫn sử dụng" cho ServBay MCP, đảm bảo AI ưu tiên, đúng và an toàn khi xử lý các tình huống môi trường phát triển local. Hỗ trợ cài song song cả cấp workspace và toàn cục, dùng chiến lược hợp nhất đánh dấu để bảo toàn nội dung bạn đã có. Sau khi cài, công cụ AI của bạn sẽ trở thành "trợ lý" môi trường local thực thụ.
