Integrasi Klien AI (IDE Integration)

ServBay memungkinkan Anda menghubungkan MCP Server bawaan dengan klien AI favorit hanya dengan satu klik. Konfigurasi MCP untuk masing-masing klien akan ditulis secara otomatis tanpa perlu mengedit file konfigurasi secara manual. Dokumen ini menjelaskan cara melakukan integrasi, klien yang didukung, serta metode integrasi untuk setiap klien.

Persyaratan

• ServBay sudah terinstal dan berjalan.
• Klien AI target sudah terinstal (ServBay akan mendeteksi berdasarkan konfigurasi apakah dapat terintegrasi).

Integrasi Satu Klik

Buka ServBay Settings → Integrasi Klien AI (IDE Integrations), temukan klien AI yang ingin diintegrasikan dari daftar, lalu klik Integrasi (Integrate). ServBay akan:

1. Menemukan file executable servbay-mcp yang sudah disertakan dalam distribusi (tidak perlu instalasi terpisah).
2. Menulis konfigurasi MCP sesuai standar tiap klien (hanya menambah/memperbarui node servbay, konfigurasi MCP lainnya tetap dipertahankan).
3. Menampilkan status integrasi.

Untuk membatalkan integrasi, cukup klik Hapus (Remove).

Status Integrasi

Setiap klien akan menampilkan status integrasi terhadap "ServBay di perangkat ini":

Status	Arti
Sudah Terintegrasi	Klien sudah diarahkan ke file servbay-mcp dari ServBay di perangkat ini
Terintegrasi (Path Lain)	Klien sudah mengatur servbay namun mengarah ke path lain (misal: dari instalasi ServBay lain)
Belum Terintegrasi	Klien terdeteksi, namun belum terintegrasi
Tidak Ditemukan	Klien tidak ditemukan di perangkat ini

Klien yang Didukung & Cara Integrasi

Klien	Cara Integrasi	Lokasi Konfigurasi
Claude Code	CLI resmi: claude mcp add --scope user --transport stdio servbay -- <bin>	Konfigurasi MCP pengguna Claude Code
Codex	CLI resmi: codex mcp add (jika CLI tidak tersedia, tulis ke ~/.codex/config.toml)	Konfigurasi Codex
Cursor	Tulis ke ~/.cursor/mcp.json (node mcpServers di level atas)	~/.cursor/mcp.json
VS Code / GitHub Copilot	Tulis ke mcp.json pengguna (node servers di level atas, type: stdio)	mcp.json pengguna VS Code
Claude Desktop	Tulis ke claude_desktop_config.json (node mcpServers di level atas)	claude_desktop_config.json

Perbedaan schema konfigurasi

Kunci tingkat atas pada konfigurasi MCP berbeda untuk tiap klien: VS Code menggunakan servers, sedangkan Cursor / Claude Desktop menggunakan mcpServers. ServBay akan otomatis menulis kunci yang benar sesuai dengan standar masing-masing klien, sehingga Anda tidak perlu khawatir mengenai perbedaannya.

Verifikasi Integrasi

Setelah integrasi, coba lakukan permintaan yang berkaitan dengan lingkungan lewat klien AI tersebut (misal: "Daftar layanan yang sedang berjalan di ServBay"). Bila AI bisa menampilkan daftar layanan nyata, berarti integrasi telah berhasil.

Pertanyaan Umum (FAQ)

• Q: Apakah integrasi akan menimpa konfigurasi MCP saya yang sudah ada?
  • A: Tidak. ServBay hanya akan menambah/memperbarui node servbay dan mempertahankan MCP Server lain yang sudah Anda atur.
• Q: Kenapa status klien “Tidak Ditemukan”?
  • A: Klien AI tidak ditemukan di perangkat Anda. Pastikan klien sudah diinstal dan sudah pernah dijalankan sebelum integrasi.
• Q: Setelah integrasi, kenapa permintaan AI gagal?
  • A: Pastikan ServBay sedang berjalan. Untuk Claude Code/Codex yang diintegrasikan lewat CLI, pastikan CLI resmi berfungsi. Anda bisa mencoba menghapus dan mengintegrasikan kembali.
• Q: Apa yang disarankan setelah integrasi?
  • A: Sangat disarankan untuk menginstal Aturan AI agar AI dapat menggunakan ServBay MCP dengan optimal dan benar.

Kesimpulan

Dengan fitur "Integrasi Klien AI", Anda dapat menghubungkan ServBay MCP ke berbagai alat AI populer hanya dengan satu klik tanpa perlu konfigurasi manual, dan konfigurasi lama Anda tetap aman. Setelah integrasi, kombinasikan dengan Aturan AI agar AI dapat mengelola lingkungan pengembangan lokal Anda secara efisien.