Kết nối công cụ cục bộ bằng connector cục bộ

Connector cục bộ cho phép trợ lý dùng công cụ chạy trên máy tính hoặc mạng nội bộ của bạn. Connector chạy cạnh máy chủ MCP của bạn và chủ động mở kết nối WebSocket tới Assistant Core, rồi trợ lý gọi công cụ qua kết nối đó. Không cần URL công khai hay mở port.

Ví dụ hoàn chỉnh: mcp-bash, gồm connector và máy chủ MCP cho phép trợ lý chạy lệnh bash trên máy bạn. Hãy đọc Giữ bí mật token của connector trước khi chạy.

Máy chủ từ xa hay connector cục bộ?Sao chép liên kết đến mục này

Cả hai nằm trong trang MCP của Admin Panel.

Điều kiệnSao chép liên kết đến mục này

• Vai trò Chủ sở hữu trợ lý. Quản trị viên trợ lý xem được connector và công cụ nhưng không sửa được.
• Một máy có thể mở kết nối ra ngoài tới wss://api.assistantcore.com.

Kết nối connectorSao chép liên kết đến mục này

1. Mở Admin Panel và chọn trợ lý.

2. Vào MCP → Connector cục bộ và bật Bật connector cục bộ.

3. Ở mục Connector, nhập Tên connector cho máy (ví dụ web01) và bấm Thêm Connector.

4. Sao chép cấu hình connector ngay. Token chỉ hiển thị một lần.

5. Chạy connector với cấu hình đó, ví dụ với mcp-bash:

   Sao chép

   export LOCAL_CONNECTOR_URL="wss://api.assistantcore.com/local-connector/ws"
   export LOCAL_CONNECTOR_TOKEN="lc_..."
   python connector.py

   Connector tự viết sẽ kết nối tới LOCAL_CONNECTOR_URL với header Authorization: Bearer <token>, rồi trả lời các yêu cầu MCP (JSON-RPC, mỗi message một frame WebSocket) bằng máy chủ MCP của bạn.

6. Quay lại Admin Panel và bấm Làm mới. Công cụ hiện ở mục Các công cụ có sẵn, kèm connector cung cấp từng công cụ.

7. Tắt những công cụ trợ lý không cần, và đặt Khả dụng trên cho các công cụ còn lại.

Nếu tab báo Connector cục bộ chưa sẵn sàng, đơn vị vận hành nền tảng chưa thiết lập tính năng này.

Làm mới là duyệt công cụSao chép liên kết đến mục này

Trợ lý dùng công cụ của connector đúng như lúc bạn bấm Làm mới gần nhất. Nếu connector thêm công cụ, hoặc đổi mô tả, tham số hay nơi dùng của một công cụ, công cụ đó bị giữ lại cho tới khi bạn làm mới lần nữa, nên connector không thể lặng lẽ thay đổi công cụ.

Hãy làm mới sau khi thêm connector, cập nhật máy chủ MCP hoặc thay đổi công cụ. Connector đang offline lúc làm mới vẫn giữ các công cụ bạn đã duyệt trước đó. Làm mới cũng ghi nhận readOnlyHint, destructiveHint và shell_argument của từng công cụ, là những gì quyết định lệnh gọi có phải chờ duyệt hay không.

Nhiều máySao chép liên kết đến mục này

Thêm một connector cho mỗi máy, tối đa 20 connector cho mỗi trợ lý. Mỗi connector có token riêng, nên bạn có thể tạo lại hoặc xoá một cái mà không ảnh hưởng cái khác.

• Mỗi token chỉ kết nối một máy tại một thời điểm. Kết nối thứ hai với cùng token bị từ chối, nên token bị lộ không thể chiếm máy đang online.
• Tên công cụ thuộc về connector cung cấp nó trước. Connector khác cung cấp cùng tên sẽ bị từ chối và log của nó ghi rõ lý do. Hãy đặt tên công cụ khác nhau cho mỗi máy, ví dụ web01_bash và db01_bash.
• Mỗi token thuộc về một trợ lý. Để nối một máy với nhiều trợ lý, chạy một connector cho mỗi trợ lý, mỗi cái dùng token của trợ lý đó.

Giữ bí mật token của connectorSao chép liên kết đến mục này

Token của connector là thông tin xác thực. Ai có token đều có thể cung cấp công cụ cho trợ lý và nhận các lệnh gọi công cụ cùng tham số của chúng.

• Không commit token vào git hay dán vào nơi công khai.
• Nếu token bị lộ hoặc bị mất, bấm Tạo lại token ở connector đó. Token cũ ngừng hoạt động ngay và connector đó bị ngắt cho tới khi bạn cập nhật; các connector khác vẫn hoạt động.
• Bấm Xoá Connector để ngắt hẳn connector.

Không thấy công cụ?Sao chép liên kết đến mục này

• Kiểm tra Bật connector cục bộ đang bật và connector có trong mục Connector.
• Kiểm tra connector đang chạy với token hiện tại. Token cũ bị từ chối sau khi tạo lại.
• Kiểm tra log của connector: kết nối bị từ chối sẽ ghi rõ lý do (token đang được dùng, hoặc tên công cụ đã thuộc connector khác).
• Bấm Làm mới: công cụ mới hoặc đã thay đổi bị giữ lại cho tới khi bạn làm mới.