Aturan AI (AI Rule)

Setelah Anda mengintegrasikan ServBay MCP, alat AI memang bisa memanggil ServBay, tetapi belum tentu tahu kapan dan bagaimana harus memanggilnya. AI Rule adalah semacam petunjuk khusus untuk AI—menjelaskan kepada AI: jika ada masalah terkait layanan lokal, situs, domain, HTTPS, port, database, atau backup, AI harus memprioritaskan pemeriksaan dan tindakan melalui ServBay MCP, bukan langsung mengubah kode aplikasi hanya demi mengakali masalah lingkungan. Dokumen ini membahas cara memasang AI Rule.

Masalah yang Diselesaikan oleh AI Rule

• Mengarahkan AI untuk Memprioritaskan MCP — Ketika mengalami masalah lingkungan lokal seperti “situs tidak dapat diakses / 502 / port sudah digunakan / error sertifikat”, AI disarankan untuk mengecek status lewat ServBay MCP terlebih dahulu, bukan mengubah kode secara sembarangan.
• Membatasi dan Mengamankan Aksi AI — Untuk operasi tulis atau destruktif, AI harus menginformasikan dan mengonfirmasi terlebih dahulu, serta tidak meminta atau menempelkan informasi sensitif seperti kunci API dalam percakapan.
• Mengurangi Klarifikasi Berulang — Aturan bersifat permanen sehingga AI dapat memberikan perilaku yang konsisten dalam setiap sesi.

Prasyarat

• ServBay telah diinstal dan dijalankan.
• Sangat disarankan telah menyelesaikan Integrasi ServBay MCP.

Tingkat Workspace vs Tingkat Global

AI Rule dapat dipasang di dua tingkat, yaitu:

• Tingkat Workspace — File aturan ditempatkan di direktori proyek tertentu dan hanya berlaku untuk proyek tersebut. Cocok jika Anda ingin aturan khusus setiap proyek.
• Tingkat Global — Aturan disimpan pada konfigurasi pengguna alat AI dan berlaku untuk semua proyek. Saat ini, hanya Claude Code dan Codex yang mendukung tingkat global.

Cara Menginstal AI Rule

Masuk ke ServBay Settings → AI Client Integrations dan pada baris alat AI yang diinginkan, klik Install AI Rule. Untuk instalasi tingkat workspace, pilih direktori proyek tujuan terlebih dahulu. ServBay akan membuat atau memperbarui file aturan tersebut. Untuk mencabutnya, klik Remove AI Rule.

Lokasi File Aturan Tingkat Workspace

Klien	Lokasi File Aturan (relatif terhadap root proyek)
VS Code	.github/instructions/servbay-mcp.instructions.md
Cursor	.cursor/rules/servbay-mcp.mdc
Codex	AGENTS.md
Claude Code	CLAUDE.md

Lokasi File Aturan Tingkat Global

Klien	Lokasi File Aturan
Claude Code	~/.claude/CLAUDE.md (memori resmi pengguna, diload saat sesi dimulai)
Codex	~/.codex/AGENTS.md (memori global resmi)

Strategi Penggabungan: Tidak Menimpa Isi Anda

ServBay menggunakan strategi merge dengan tanda untuk menulis aturan: bagian aturan yang dikelola oleh ServBay dibungkus dengan komentar bertanda khusus, dan hanya area di antara tanda tersebut yang diperbarui—bagian lain dalam file tetap aman. Menulis aturan pada CLAUDE.md / AGENTS.md Anda yang ada itu aman: isi Anda tidak hilang, dan bila dihapus hanya bagian terkelola yang dicabut.

Pertanyaan Umum (FAQ)

• T: Apakah menginstal AI Rule akan menimpa CLAUDE.md / AGENTS.md yang sudah saya punya?
  • J: Tidak. ServBay hanya memperbarui area yang dibungkus tanda sehingga isi lain milik Anda tetap utuh.
• T: Mengapa klien saya tidak menemukan opsi “aturan global”?
  • J: Saat ini opsi global hanya didukung Claude Code dan Codex. Untuk klien lain, silakan gunakan instalasi tingkat workspace.
• T: Apa hubungan antara AI Rule dan integrasi MCP?
  • J: Integrasi MCP membuat AI bisa memanggil ServBay, sementara AI Rule membuat AI tahu kapan dan bagaimana memakainya. Keduanya bersama-sama memberikan hasil terbaik.
• T: Apakah file aturan di proyek Cursor / VS Code akan terikut commit ke Git?
  • J: File aturan berada di folder proyek, dan apakah akan masuk versi kontrol tergantung pengaturan .gitignore Anda—silakan sesuaikan dengan aturan tim.

Kesimpulan

AI Rule bertindak sebagai “buku panduan” ServBay MCP agar AI senantiasa memprioritaskan penggunaan ServBay saat menangani permasalahan lingkungan pengembangan lokal, dengan cara yang benar dan aman. Mendukung pemasangan di tingkat workspace maupun global, dan strategi penggabungan tanda memastikan data Anda tetap terlindungi. Setelah pemasangan, alat AI Anda akan menjadi asisten lokal yang andal.