Máy chủ MCP tùy chỉnh
Ngoài các connector trong danh mục của Rephlo, bạn có thể kết nối tới một máy chủ MCP tùy chỉnh do chính bạn vận hành — hoặc do một người bạn tin tưởng vận hành. Tính năng này dành cho người dùng nâng cao đã có sẵn một máy chủ MCP và một token để truy cập nó.
Máy chủ tùy chỉnh được thêm trong ứng dụng desktop, tại Settings → Connectors → Add custom connector. Không có giao diện web cho tính năng này — mọi thứ diễn ra cục bộ trên máy của bạn.
Trước khi bắt đầu
Bạn sẽ cần:
- Một máy chủ MCP mà bạn có thể truy cập tới (lệnh chạy của nó, hoặc URL của nó).
- Một bearer token cho máy chủ đó, nếu nó yêu cầu xác thực.
Hiện tại xác thực chỉ hỗ trợ bearer token. Máy chủ tùy chỉnh hiện chỉ xác thực bằng một bearer token chia sẻ trước duy nhất — bạn dán một token, và Rephlo gửi kèm nó với mỗi yêu cầu. Máy chủ tùy chỉnh dùng OAuth (nơi bạn đăng nhập qua trình duyệt, như với Notion) chưa được hỗ trợ và sẽ có trong một bản phát hành sau.
Thêm một máy chủ tùy chỉnh
- Mở Settings → Connectors và nhấp Add custom connector.
- Đặt cho máy chủ một tên để bạn nhận ra sau này.
- Chọn một transport — cách Rephlo giao tiếp với máy chủ:
- Streamable HTTP — Rephlo kết nối tới một URL máy chủ qua mạng.
- Stdio — Rephlo khởi chạy một tệp thực thi cục bộ và giao tiếp trực tiếp với nó trên máy của bạn.
- Điền các thiết lập riêng theo từng transport (xem bảng bên dưới).
- Dán bearer token của máy chủ.
- Lưu. Rephlo kết nối, hỏi máy chủ xem nó cung cấp những công cụ nào, và các công cụ của máy chủ trở nên khả dụng trong chat.
Bảng Add custom connector, với lựa chọn transport và trường bearer token.
Thiết lập transport
| Transport | Bắt buộc | Tùy chọn |
|---|---|---|
| Streamable HTTP | URL máy chủ | Một bearer token để xác thực |
| Stdio | Đường dẫn tệp thực thi để khởi chạy | Tham số |
Danh mục connector riêng của Rephlo ghim một số máy chủ với một mã băm nhị phân SHA-256 để xác minh thêm, nhưng việc đó do phía Rephlo quản lý — đây không phải là trường bạn tự thiết lập khi thêm connector tùy chỉnh của riêng mình.
Dữ liệu của bạn nằm ở đâu
- Máy chủ tùy chỉnh và bearer token của chúng được lưu trữ trên thiết bị của bạn, mã hóa khi lưu trữ (encrypted at rest). Chúng không được gửi tới backend của Rephlo.
- Các lệnh gọi công cụ từ máy chủ tùy chỉnh chạy trực tiếp từ desktop của bạn tới máy chủ — chúng không đi qua đám mây của Rephlo.
- Như với mọi connector khác, kết quả công cụ chỉ tồn tại trong bộ nhớ trong suốt phiên làm việc, và nhật ký kiểm toán cục bộ chỉ ghi lại tên công cụ, thời lượng và trạng thái — không bao giờ ghi tham số hay nội dung.
Xử lý sự cố
Máy chủ từ chối kết nối (401 / unauthorized). Bearer token sai hoặc đã bị xoay vòng (rotated). Hãy xóa máy chủ và thêm lại với token đúng.
Kết nối h ết thời gian chờ. Kiểm tra xem URL máy chủ có thể truy cập được không và máy chủ có phản hồi đủ nhanh không — các lệnh gọi công cụ có giới hạn thời gian cố định. Nếu máy chủ đơn giản là chậm, hãy kiểm tra lại hiệu năng hoặc tính khả dụng của nó.
Công cụ không xuất hiện, hoặc lệnh gọi công cụ không phân tích được. Máy chủ phải nói đúng chuẩn MCP và khai báo các công cụ của nó khi Rephlo kết nối. Hãy xác nhận máy chủ phát ra các định nghĩa và phản hồi công cụ MCP đúng định dạng.