Tích hợp ứng dụng khách AI (Tích hợp IDE)
ServBay cho phép bạn tích hợp MCP Server được tích hợp sẵn chỉ với một cú nhấp vào các ứng dụng AI mà bạn thường sử dụng. Hệ thống sẽ tự động thêm cấu hình MCP tương ứng mà không cần phải chỉnh sửa file cấu hình thủ công. Bài viết này hướng dẫn các bước tích hợp, các ứng dụng được hỗ trợ và phương thức kết nối với từng ứng dụng khách.
Điều kiện tiên quyết
- Đã cài đặt và chạy ServBay.
- Đã cài đặt ứng dụng AI mục tiêu (ServBay sẽ kiểm tra cấu hình để xác định khả năng kết nối).
Kết nối chỉ với một cú nhấp
Truy cập Cài đặt ServBay (Settings) → Tích hợp ứng dụng AI (IDE Integrations), tìm ứng dụng khách bạn muốn tích hợp trong danh sách rồi chọn Tích hợp (Integrate). ServBay sẽ thực hiện:
- Xác định vị trí của tệp thực thi
servbay-mcpđược tích hợp trong bản phát hành (bạn không cần tự cài đặt riêng). - Ghi cấu hình MCP tuân theo chuẩn của ứng dụng khách (chỉ thêm mới / cập nhật nút
servbayvà giữ nguyên các cấu hình MCP khác mà bạn đã có). - Hiển thị trạng thái kết nối.
Nếu muốn hủy tích hợp, chỉ cần nhấp Xóa (Remove).
Trạng thái kết nối
Mỗi ứng dụng khách sẽ hiển thị trạng thái kết nối so với ServBay bản cục bộ như sau:
| Trạng thái | Ý nghĩa |
|---|---|
| Đã kết nối | Ứng dụng đang trỏ đến tệp servbay-mcp của ServBay trên máy này |
| Đã kết nối (đường dẫn khác) | Ứng dụng đã cấu hình servbay nhưng trỏ đến một đường dẫn khác (như một bản ServBay khác) |
| Chưa kết nối | Đã phát hiện ứng dụng, nhưng chưa thiết lập kết nối |
| Không phát hiện | Không tìm thấy ứng dụng này trên máy |
Ứng dụng được hỗ trợ & phương thức tích hợp
| Ứng dụng khách | Phương thức tích hợp | Vị trí cấu hình |
|---|---|---|
| Claude Code | CLI chính thức: claude mcp add --scope user --transport stdio servbay -- <bin> | Cấu hình MCP cấp người dùng của Claude Code |
| Codex | CLI chính thức: codex mcp add (Nếu không dùng được CLI sẽ chuyển sang ghi file ~/.codex/config.toml) | Cấu hình Codex |
| Cursor | Ghi file ~/.cursor/mcp.json (nút mcpServers ở cấp cao nhất) | ~/.cursor/mcp.json |
| VS Code / GitHub Copilot | Ghi file mcp.json cấp người dùng (nút servers ở cấp cao nhất, type: stdio) | mcp.json cấp người dùng cho VS Code |
| Claude Desktop | Ghi file claude_desktop_config.json (nút mcpServers ở cấp cao nhất) | claude_desktop_config.json |
Sự khác biệt schema cấu hình
Khóa cấu hình MCP ở cấp cao nhất ở mỗi ứng dụng khách sẽ khác nhau: VS Code dùng servers, Cursor / Claude Desktop dùng mcpServers. ServBay sẽ tự động viết đúng khóa theo chuẩn từng ứng dụng khách, bạn không cần bận tâm đến sự khác biệt này.
Kiểm tra kết nối
Sau khi tích hợp, hãy thử gửi một yêu cầu liên quan tới môi trường trong ứng dụng AI tương ứng (ví dụ: “Liệt kê các dịch vụ hiện đang chạy trên ServBay”). Nếu AI trả về danh sách dịch vụ thực tế, nghĩa là tích hợp thành công.
Câu hỏi thường gặp (FAQ)
- Hỏi: Tích hợp có ghi đè cấu hình MCP hiện tại của tôi không?
- Đáp: Không. ServBay chỉ thêm mới/cập nhật vào nút
servbay, giữ nguyên các MCP Server khác trong cấu hình của bạn.
- Đáp: Không. ServBay chỉ thêm mới/cập nhật vào nút
- Hỏi: Hiện thông báo “Không phát hiện” khi tích hợp?
- Đáp: Hệ thống không tìm thấy ứng dụng khách này trên máy. Hãy cài đặt và khởi động ứng dụng đó trước khi tích hợp.
- Hỏi: Lỗi khi gọi AI sau khi tích hợp?
- Đáp: Hãy chắc chắn ServBay đang chạy; với Claude Code / Codex tích hợp qua CLI, hãy đảm bảo CLI gốc của ứng dụng có thể chạy. Bạn có thể thử Xóa rồi Tích hợp lại.
- Hỏi: Sau khi tích hợp nên thực hiện gì tiếp theo?
- Đáp: Khuyến nghị cài thêm quy tắc AI để hướng dẫn AI ưu tiên và sử dụng chính xác ServBay MCP.
Tổng kết
Với chức năng “Tích hợp ứng dụng AI”, bạn có thể kết nối ServBay MCP với các công cụ AI phổ biến chỉ với một thao tác, hoàn toàn không cần chỉnh sửa cấu hình thủ công và không ảnh hưởng đến các thiết lập hiện có. Khi đã tích hợp, kết hợp cùng quy tắc AI, bạn có thể kiểm soát dễ dàng môi trường phát triển cục bộ bằng AI.
