Chuyển tới nội dung chính

Máy khách MCP

Model Context Protocol (MCP) là một chuẩn mở để cung cấp công cụ cho các mô hình AI. Nhiều dịch vụ có sẵn máy chủ MCP, và bạn cũng có thể tự viết. Một máy khách MCP AI kết nối MonoChat với một máy chủ MCP, để các công cụ mà máy chủ đó cung cấp có thể được trao cho các nút AI và tác tử AI của bạn, bên cạnh các hàm Công cụ AI bạn viết trong MonoChat.

Bạn quản lý chúng tại Cài đặt › Tự động hóa › Máy khách MCP AI.

Cách hoạt động​

  1. Bạn thêm địa chỉ của máy chủ MCP và kết nối. MonoChat đọc những gì máy chủ cung cấp: Công cụ, Tài nguyên, Mẫu tài nguyên và Prompt của nó.
  2. Khi bạn lưu, MonoChat giữ danh sách đó làm nội dung của máy khách.
  3. Trong nút Tạo chat completion bằng AI hoặc nút Tác tử AI, bạn chọn các công cụ muốn nút đó có, và có thể viết lại mô tả của từng công cụ cho mô hình.
  4. Trong cuộc hội thoại, mô hình quyết định khi nào gọi một công cụ; MonoChat gọi máy chủ MCP và trả kết quả về cho mô hình.

Chỉ những công cụ bạn thêm vào một nút mới khả dụng với nút đó, nên mỗi nút chỉ thấy những gì nó cần.

Thêm máy khách MCP​

  1. Vào Cài đặt › Tự động hóa › Máy khách MCP AI và bấm + (Tạo).

  2. Điền các trường:

    TrườngMô tả
    TênTên của máy chủ, hiển thị bên cạnh từng công cụ của nó trong các ngăn của nút.
    Mô tảGhi chú tùy chọn.
    Phiên bảnPhiên bản máy khách mà MonoChat thông báo cho máy chủ khi kết nối, ví dụ 1.0.0.
    Điểm cuốiURL gốc của máy chủ MCP. MonoChat kết nối bằng kiểu truyền tải SSE tại <Endpoint>/sse, nên hãy nhập địa chỉ không có /sse.
    Loại xác thựcNone, Basic (với Tên đăng nhập và Mật khẩu) hoặc Bearer (với Token). Thông tin xác thực được lưu cùng máy khách.

  3. Bấm Kết nối. MonoChat kết nối tới máy chủ và hiển thị những gì tìm thấy trong các tab:

    • Thông tin máy chủ: Tên, Phiên bản, Phiên bản giao thức và Hướng dẫn của máy chủ.
    • Công cụ: tên và mô tả của từng công cụ.
    • Tài nguyên, Mẫu tài nguyên và Prompt, nếu máy chủ có cung cấp.

  4. Nếu danh sách trông đúng, bấm Lưu. Để đổi địa chỉ và thử lại, bấm nút Ngắt kết nối bên cạnh.

mẹo

Nếu Kết nối thất bại, hãy kiểm tra điểm cuối có truy cập được từ internet không, máy chủ có hỗ trợ kiểu truyền tải SSE không, và URL chưa kết thúc bằng /sse.

Cập nhật danh sách công cụ​

Khi máy chủ MCP thêm hoặc thay đổi công cụ, hãy mở máy khách bằng Cập nhật. MonoChat kết nối lại và hiển thị nội dung hiện tại; bấm Cập nhật để lưu danh sách mới.

Xóa một máy khách cũng xóa nội dung của nó, nên các nút sẽ mất những công cụ đến từ máy khách đó.

Trao công cụ cho một nút​

Nút Tạo chat completion bằng AI​

  1. Mở nút và cuộn đến Cài đặt công cụ nội dung máy khách MCP AI.
  2. Bấm Thiết lập công cụ nội dung máy khách MCP AI. Ngăn Công cụ nội dung máy khách MCP AI liệt kê các công cụ đã được thêm vào nút này.
  3. Bấm + (Tạo), rồi chọn một công cụ trong Công cụ nội dung máy khách MCP AI. Các công cụ được liệt kê theo dạng <client name> - <tool name>.
  4. Mô tả được điền sẵn bằng mô tả của chính công cụ. Hãy sửa nếu bạn muốn nói rõ hơn cho mô hình khi nào nên dùng công cụ, ví dụ "Dùng công cụ này để tra cứu đơn hàng theo số đơn". Mô tả là bắt buộc.
  5. Lặp lại cho từng công cụ, rồi lưu nút.

Bạn có thể cập nhật mô tả của một công cụ hoặc gỡ nó khỏi nút ngay trong cùng ngăn.

Nút Tác tử AI​

Nút Tác tử AI có cùng nút Thiết lập công cụ nội dung máy khách MCP AI trong phần Cài đặt công cụ của nó. Các công cụ MCP đã chọn được cung cấp cho tác tử cùng với các phạm vi AI và công cụ AI của nút, trên mọi harness. Xem Tác tử AI.

thông tin

Mỗi lượt chạy tác tử kiểm tra rằng mọi công cụ MCP trên nút vẫn còn tồn tại trong không gian làm việc của bạn. Nếu bạn xóa một máy khách MCP mà một nút đang dùng, các lượt chạy của nút đó sẽ thất bại với thông báo "Không tìm thấy phạm vi AI hoặc công cụ MCP trong không gian làm việc này." cho đến khi bạn gỡ công cụ khỏi nút.

Quyền​

Quyền truy cập được kiểm soát bởi các quyền vai trò Xem / Tạo / Cập nhật / Xóa máy khách AI MCP trong tự động hóa và Xem nội dung máy khách AI MCP trong tự động hóa. Xem Vai trò.