Integrasi Pelanggan AI (IDE Integration)

ServBay membolehkan anda menyambungkan MCP Server terbina dalam ke pelanggan AI yang sering anda guna dengan satu klik, dan secara automatik menulis konfigurasi MCP yang diperlukan tanpa perlu anda sunting fail konfigurasi secara manual. Dokumen ini menerangkan langkah sambungan, pelanggan yang disokong, dan cara integrasi untuk setiap pelanggan.

Prasyarat

• Telah memasang dan menjalankan ServBay.
• Telah memasang pelanggan AI sasaran (ServBay akan mengesan dan menentukan jika sambungan boleh dibuat berdasarkan konfigurasi).

Sambungan Satu Klik

Pergi ke ServBay Tetapan (Settings) → Integrasi Pelanggan AI (IDE Integrations), cari pelanggan dalam senarai, dan klik Integrasi (Integrate). ServBay akan:

1. Mengenal pasti fail boleh laksana servbay-mcp yang disertakan dengan pakej (anda tidak perlu memasang secara berasingan).
2. Menulis konfigurasi MCP mengikut piawai pelanggan sasaran (hanya menambah / mengemas kini nod servbay, konfigurasi MCP sedia ada anda yang lain tidak akan diubah).
3. Memaparkan status sambungan.

Untuk membatalkan sambungan, klik Buang (Remove).

Status Sambungan

Setiap pelanggan akan menunjukkan status sambungannya berbanding salinan ServBay di komputer anda:

Status	Makna
Telah disambungkan	Pelanggan sudah mengarah ke servbay-mcp milik ServBay pada komputer ini
Telah disambungkan (laluan lain)	Pelanggan telah mengandungi servbay, tetapi mengarah ke laluan lain (contohnya, satu lagi pemasangan ServBay)
Belum disambungkan	Pelanggan dikesan, tetapi belum diintegrasi
Tidak dikesan	Pelanggan tidak ditemui pada komputer ini

Pelanggan Disokong & Kaedah Sambungan

Pelanggan	Cara Sambungan	Lokasi Konfigurasi
Claude Code	CLI rasmi: claude mcp add --scope user --transport stdio servbay -- <bin>	Konfigurasi MCP per pengguna Claude Code
Codex	CLI rasmi: codex mcp add (jika CLI tidak tersedia, terus tulis ke ~/.codex/config.toml)	Konfigurasi Codex
Cursor	Tulis ke ~/.cursor/mcp.json (kunci aras atas: mcpServers)	~/.cursor/mcp.json
VS Code / GitHub Copilot	Tulis ke mcp.json per pengguna (kunci aras atas: servers, type: stdio)	mcp.json pengguna VS Code
Claude Desktop	Tulis ke claude_desktop_config.json (kunci aras atas: mcpServers)	claude_desktop_config.json

Perbezaan skema konfigurasi

Kunci aras atas konfigurasi MCP berbeza mengikut pelanggan: VS Code menggunakan servers, Cursor / Claude Desktop menggunakan mcpServers. ServBay akan menulis konfigurasi dengan kunci yang betul secara automatik mengikut keperluan pelanggan; anda tidak perlu risau tentang perbezaan ini.

Sahkan Sambungan

Selepas sambungan, hantar permintaan berkaitan persekitaran daripada pelanggan AI (contohnya “senaraikan servis yang sedang dijalankan oleh ServBay”). Jika AI berjaya memaparkan senarai servis sebenar, maka sambungan telah berjaya.

Soalan Lazim (FAQ)

• S: Adakah sambungan ini akan menindih konfigurasi MCP sedia ada saya?
  • J: Tidak. ServBay hanya menambah / mengemas kini nod servbay sahaja — konfigurasi MCP Server lain anda dikekalkan.
• S: Pelanggan menunjukkan “Tidak dikesan”?
  • J: Ini bermaksud pelanggan tersebut tidak ditemui pada komputer anda. Sila pastikan anda telah memasang dan menjalankan pelanggan tersebut sebelum cuba integrasi.
• S: Sambungan berjaya tetapi AI gagal dijalankan?
  • J: Pastikan ServBay sedang berjalan; untuk Claude Code / Codex yang menggunakan CLI rasmi, pastikan CLI boleh digunakan. Anda boleh cuba buang sambungan dan sambung semula.
• S: Apa yang digalakkan selepas sambungan?
  • J: Sebaiknya pasang Peraturan AI untuk membantu AI mengenal pasti dan menggunakan MCP ServBay dengan lebih tepat dan berkesan.

Rumusan

Dengan ciri “Integrasi Pelanggan AI”, anda boleh menyambungkan ServBay MCP ke pelbagai alat AI terkemuka dengan satu klik tanpa perlu mengubah konfigurasi secara manual dan tanpa menjejaskan tetapan sedia ada anda. Selepas integrasi, digalakkan untuk pasang Peraturan AI supaya AI dapat mengurus persekitaran pembangunan tempatan anda dengan lebih lancar.