Solisk Pc MCP

Install · Windows GUI · Connect an AI · Security · Self-host · CLI · FAQ

Let your AI work with files and apps on your PC

Solisk connects MCP-compatible AI clients to your machine. Read a project file, inspect a Git diff, or use Windows desktop tools without building a separate integration for each app. Start locally; use the hosted relay or run your own relay when the client needs a remote URL.

• Local or self-hosted: the runtime and relay are MIT-licensed and included here.
• A Windows control room: manage connections and approve supported shell commands locally.
• CLI on Windows, Linux and macOS: capabilities differ by platform; see OS support.

PC access is powerful. Use a test folder first and read the trust boundaries before granting shell or desktop access. Approval is not a universal gate for every tool.

See the first win

Run a complete local workflow before connecting a real project or remote relay:

node examples/first-win.js

The demo uses synthetic data and real MCP stdio calls to read a CSV, write and verify a Markdown report, then prove a path outside the allowed folder is denied. No account, model API key, relay or network is required. See LAUNCH.md for the recording script, interactive product film and launch copy.

Open the interactive product film at assets/launch/solisk-brand-film.html for the visual overview, then run the technical demo to verify the local MCP path.

Install

npm install -g solisk      # requires Node 22.5+

solisk setup # configure identity and approval mode

Then choose one connection path below. For Windows users who prefer an installer, skip npm and use the Windows GUI.

Local client on the same machine

For an MCP client that accepts command-based servers, add this entry to its MCP configuration. The client starts and stops Solisk; don't also start an HTTP server for this connection.

{

"mcpServers": { "solisk": { "command": "solisk", "args": ["--mode=stdio"] } } }

If the client cannot find solisk, restart it after installation or configure the absolute path to the installed command. Stdio uses the permissions of the local process, not a bearer-key login. It does not open the web dashboard or a relay.

Hosted or HTTP clients

Start the server and leave this terminal running:

solisk --mode=http

In a second terminal, open the control room:

solisk dashboard

Use the MCP URL shown by the running instance for remote clients. For local HTTP, the default endpoint is http://127.0.0.1:3000/mcp and requires authentication. Use solisk --mode=http --no-relay to disable the hosted relay for that run; also leave Cloudflare and Tailscale exposure off for a local-only setup.

Windows GUI

1. Open the latest release and download its `PC Control MCP Setup … .exe` asset and SHA256SUMS.txt. An MSI is not included in every release.
2. Run it: point-and-click control room, same engine as the CLI.
3. Already have the CLI? solisk gui setup --installer " " installs it silently.
4. On Linux/macOS, solisk gui refuses by design and points you to the web dashboard.

[!WARNING]

The Windows installer is unsigned and may trigger SmartScreen. Download only from the official release and compare its SHA-256 hash with SHA256SUMS.txt before deciding whether to run it. A checksum is not a publisher signature. Older release assets may still carry a 1.0.0 filename; consult the release notes rather than guessing a download URL.

Connect an AI

For a remote connector, use your instance's URL and complete the client's authorization flow. Keep the room key out of chat messages and screenshots. Available connector features depend on the client and account.

flowchart LR

A[Copy MCP URL from your running instance] --> B[Add a remote MCP connector] B --> C[Approve once consent + room key] C --> D[Verify tools are listed then try a read-only task] style D fill:#4fd1b5,color:#03211b

[!NOTE]

If discovery fails, first check that the runtime and selected connection path are online. If a client cached an earlier failed connection, removing and re-adding the connector may help; it is not a substitute for checking the server error.

Your first successful task

Choose a non-sensitive text file in a folder you have allowed, then ask:

Use Solisk's read_file tool to read the file at the absolute path I provide

and summarize it in three bullets. Do not run shell commands or change files.

Success means the client lists Solisk's tools, read_file returns that file's contents, and the summary matches. If access is denied, correct the allowed path or key scope rather than switching to Turbo. Next, try inspecting a Git diff in a test repository. Desktop automation can wait until this basic flow works.

Security model

Full policy: SECURITY.md · found something? Security advisory — not a public issue.

Everything, live

Architecture

flowchart TB

AI["AI client Claude.ai / ChatGPT / Cursor"] AI -->|MCP URL + OAuth 2.1 PKCE S256, resource-bound tokens| RELAY subgraph RELAY["Cloud relay"] R1[rooms · tokens · rate limits scrypt-hashed keys] end RELAY -->|one outbound WebSocket per PC takeover-protected| PC subgraph PC["Your machine :3000"] P1[StreamableHTTP · 97 tools · 5 sessions max] P2[Cloudflare tunnel quick or your domain] P3[tailnet serve · web dashboard /app] end

One config file, one event bus, one session store. Thin faces (Electron, CLI, web shim) never own state.

OS support

Windows-only implementations stay off elsewhere. macOS includes native screenshot and input tools that need Screen Recording and Accessibility permissions. Run solisk --list-tools for the actual inventory on your machine. Platform support does not imply identical tool behavior or security coverage.

Requirements

• Node ≥ 22.5 for the CLI.
• Windows 10/11 x64 for the GUI.
• Nothing else — no Docker, no reverse proxy needed for localhost use.

Self-host the relay

ssh root@YOUR_VPS

bash -c "$(curl -fsSL https://raw.githubusercontent.com/Kyzenkms/solisk-pc-mcp/main/self-hosted-setup/vps/install.sh)"

What the script does

Picks your domain type (yours or sslip.io for testing), then runtime (Docker or PM2), then prints the room + key to paste into the app. Backups, firewall, updates: self-hosted-setup/README.md.

CLI reference

solisk is the command — pc-control remains as a compatibility alias.

Daily

solisk dashboard [--no-open]      web console for the running server

solisk doctor [--fix] 11 health checks — 0 failing is the goal solisk logs [--lines N] live server log, whichever face owns it solisk setup step-by-step onboarding wizard solisk backup config snapshot for restores

Access control

solisk config get|set|validate    ports, modes, domains (secrets refused)

solisk rotate-key new owner key, zero-downtime rotation solisk keys list|add|revoke scoped client keys (fail-cl