MCP / AI Agent Integration

What is MCP?

MCP (Model Context Protocol) is an open protocol that lets AI agents (Claude, GitHub Copilot, n8n, ...) call external tools. WinWraper ships with WinWraper.MCP, an MCP server that lets an AI manage all your services.

For example, you can tell Claude:

"Start all my services" "Is my-api running?" "Restart api-gateway for me"

Claude will call WinWraper's MCP tools to act immediately.

Setting up WinWraper.MCP

With Claude Desktop

Open the Claude configuration file: %APPDATA%\Claude\claude_desktop_config.json
Add to the mcpServers section:

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

Restart Claude Desktop.

With GitHub Copilot (VS Code)

Open .vscode/mcp.json in your workspace (or create it).
Add:

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

VS Code detects the MCP server automatically when the workspace opens.

ℹ️Note

WinWraper.MCP only works on the same machine and only the currently logged-in user has access. No network port is opened.

Available MCP tools

Tool	Description
`start` / `stop` / `restart`	Start / stop / restart a service by name
`start_all` / `stop_all` / `restart_all`	Batch action on all services
`get_all`	Get a list of all services and their status
`get_one`	Get detailed information about one service
`register_win_service`	Register a service with Windows SCM
`unregister_win_service`	Unregister a Windows Service
`start_service` / `stop_service`	Start / stop via Windows SCM
`show_window` / `hide_window`	Show / hide the WinWraper window
`get_license_info`	View current license information

MCP HTTP/SSE mode (advanced)

In addition to stdio mode (the default), WinWraper.MCP supports HTTP/SSE mode so AI clients that don't support stdio (or tools calling from a container/WSL) can connect over HTTP.

This mode is enabled automatically when you install the OpenClaw Gateway through ⚡ Quick Add, that's the supported way to turn it on. The current release does not have a Settings UI for toggling it manually.

⚠️Warning

When MCP HTTP mode is enabled, make sure the port is not exposed outside your local network. MCP HTTP has no authentication, use it only on localhost or a trusted network.

Security

stdio mode (default): only the current user on this machine can connect, secure by default.
HTTP/SSE mode: any process on the machine can connect, enable only when necessary.

Next: System Tray →