Tích hợp MCP / AI Agent

MCP là gì?

MCP (Model Context Protocol) là giao thức mở cho phép AI agent (Claude, GitHub Copilot, n8n, ...) gọi các công cụ bên ngoài. WinWraper đi kèm WinWraper.MCP, một MCP server cho phép AI điều khiển toàn bộ service của bạn.

Ví dụ, bạn có thể nói với Claude:

"Khởi động tất cả service của tôi" "Service my-api đang chạy không?" "Restart con api-gateway hộ tôi"

Claude sẽ gọi MCP tools của WinWraper để thực hiện ngay lập tức.

Cài đặt WinWraper.MCP

Với Claude Desktop

Mở file cấu hình Claude: %APPDATA%\Claude\claude_desktop_config.json
Thêm vào mục mcpServers:

{
  "mcpServers": {
    "winwraper": {
      "command": "C:\\Program Files\\WinWraper\\WinWraper.MCP.exe"
    }
  }
}

Khởi động lại Claude Desktop.

Với GitHub Copilot (VS Code)

Mở .vscode/mcp.json trong workspace của bạn (hoặc tạo mới).
Thêm:

{
  "servers": {
    "winwraper": {
      "command": "C:\\Program Files\\WinWraper\\WinWraper.MCP.exe"
    }
  }
}

VS Code tự nhận dạng MCP server khi khởi động workspace.

ℹ️Ghi chú

WinWraper.MCP chỉ hoạt động trên cùng máy tính và chỉ user đang đăng nhập mới có quyền truy cập. Không cần mở port mạng nào.

Các MCP Tools có sẵn

Tool	Mô tả
`start` / `stop` / `restart`	Khởi động / dừng / restart một service theo tên
`start_all` / `stop_all` / `restart_all`	Thao tác hàng loạt tất cả service
`get_all`	Lấy danh sách tất cả service và trạng thái
`get_one`	Lấy thông tin chi tiết một service
`register_win_service`	Đăng ký service vào Windows SCM
`unregister_win_service`	Huỷ đăng ký Windows Service
`start_service` / `stop_service`	Khởi động / dừng qua Windows SCM
`show_window` / `hide_window`	Hiện / ẩn cửa sổ WinWraper
`get_license_info`	Xem thông tin license hiện tại

Chế độ MCP HTTP/SSE (nâng cao)

Ngoài chế độ stdio (mặc định), WinWraper.MCP hỗ trợ chế độ HTTP/SSE để các AI client không hỗ trợ stdio (hoặc công cụ gọi từ container/WSL) có thể kết nối qua HTTP.

Chế độ này được bật tự động khi bạn cài OpenClaw Gateway qua nút Cài đặt nhanh, đây là cách chính để bật nó. Hiện phiên bản này không có mục Settings UI để bật/tắt thủ công.

⚠️Lưu ý

Khi bật MCP HTTP mode, đảm bảo port không bị expose ra ngoài mạng nội bộ. MCP HTTP không có authentication, chỉ dùng trên localhost hoặc mạng tin cậy.

Bảo mật

Chế độ stdio (mặc định): chỉ user hiện tại trên máy có thể kết nối, an toàn mặc định.
HTTP/SSE mode: bất kỳ process nào trên máy có thể kết nối, chỉ bật khi cần thiết.

Tiếp theo: System Tray →