MCP server và plugin trong RexAPF Desktop

Plugin mở rộng RexAPF Desktop bằng tính năng, giao diện và công cụ mới. MCP server cho trợ lý gọi công cụ của chương trình bên ngoài như thể công cụ có sẵn. Bài này hướng dẫn quản lý plugin trên giao diện và khai báo MCP server trong tệp cấu hình.

#Trang Plugin

Mở Plugin ở danh sách bảng bên trái. Trang chia hai nhóm:

• Chính thức — plugin đi kèm RexAPF Desktop. Bạn cấu hình hoặc bật/tắt từng thành phần, nhưng không gỡ được; nâng cấp RexAPF Desktop sẽ cập nhật chúng.
• Đã cài đặt — plugin bên thứ ba bạn tự thêm.

Mỗi plugin hiện trạng thái như Đang chạy, Đã tắt, Đang tải hoặc Có lỗi. Nhấn vào plugin để xem Thành phần, Nguồn và Phiên bản hiện tại.

Muốn xem toàn bộ plugin tích hợp và trạng thái hoạt động, mở Cài đặt › Plugin tích hợp (tab Danh sách plugin, có ô Tìm plugin).

#Cài plugin bên thứ ba

Plugin có thể là gói npm, kho Git hoặc thư mục trên máy.

1. Mở hộp thoại cài đặt

   Trên trang Plugin, nhấn Thêm plugin, chọn Cài đặt plugin bên thứ ba.

2. Nhập nguồn plugin

   Ở ô Tên gói hoặc địa chỉ, nhập tên gói npm (ví dụ dsh-plugin-whale-pet), địa chỉ kho GitHub hoặc đường dẫn thư mục cục bộ. Nhấn Hướng dẫn cài đặt và ví dụ nếu cần mẫu.

3. Chọn kho gói (tuỳ chọn)

   Mở Kho gói để chọn Kho npm chính thức, máy chủ mirror hoặc Địa chỉ tùy chỉnh cho kho npm nội bộ. Thông tin đăng nhập kho riêng đặt trong ~/.npmrc.

4. Cài đặt

   Nhấn Cài đặt và theo dõi tiến trình. Nếu gói có script cài đặt, RexAPF hỏi trước; chỉ nhấn Cho phép các script này và thử lại với gói bạn tin tưởng.

5. Bật plugin

   Khi xong, nhấn Bật ngay. Một số thay đổi có hiệu lực khi khởi động lần tới.

Plugin đã cài không tự cập nhật. Để nâng cấp, mở plugin, nhấn Gỡ cài đặt, rồi cài phiên bản mới.

#Kết nối MCP server

RexAPF Desktop chưa có biểu mẫu thêm MCP server trên giao diện. Bạn khai báo server trong tệp cấu hình của hồ sơ Desktop:

~/.dsh/profiles/desktop/cordis.patch.yml

Nút Mở tệp cấu hình ở đầu trang Cài đặt mở đúng tệp này bằng trình soạn thảo mặc định.

1. Cài chương trình MCP server

   RexAPF không tự tải server. Cài server trước theo hướng dẫn của nhà cung cấp (ví dụ npm install -g ...), hoặc chuẩn bị URL nếu server chạy từ xa.

2. Thêm khối khai báo

   Thêm một mục insert vào cuối tệp. Mỗi server cần id và serverName riêng.

3. Khởi động lại và kiểm tra

   Thoát rồi mở lại RexAPF Desktop. Mở Phiên mới và hỏi một việc cần công cụ của server.

- insert:
    - id: mcp-github
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: github
        transport: stdio
        command: npx
        args: ['-y', '@modelcontextprotocol/server-github']
        env:
          GITHUB_TOKEN: !!js process.env.GITHUB_TOKEN

- insert:
    - id: mcp-web
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: web
        transport: streamable-http
        url: https://mcp.example.com/mcp
        headers:
          Authorization: !!js '`Bearer ${process.env.MCP_TOKEN}`'

#Các trường thường dùng

Công cụ của server hiện với tên mcp__<serverName>__<tên công cụ>, ví dụ mcp__github__create_issue.

#Khi server lỗi

• Nếu không kết nối được lúc khởi động, RexAPF vẫn chạy nhưng không có công cụ của server đó.
• Nếu server đang chạy bị mất kết nối, RexAPF tự kết nối lại (chờ từ 0,5 giây tăng dần tới 30 giây). Trong lúc mất kết nối, công cụ vẫn hiện nhưng mọi lệnh gọi đều lỗi.
• Sau 10 lần kết nối lại thất bại liên tiếp, công cụ bị gỡ cho tới khi bạn khởi động lại ứng dụng.

#Bài liên quan