Repository navigation
Home
This wiki is the operator manual for MCOS, a Windows-native LAN MCP Gateway host. Use it to install the service, configure the gateway, connect trusted-LAN clients, operate worker pools, review diagnostics, and troubleshoot the host.
| Field | Value |
|---|---|
| Version | vA3.11.0 |
| Version source | VERSION.json |
| Released | 2026-07-03 |
| Channel | Internal alpha |
| Version meaning |
A3.11.0 is the alpha-stage expression of the tree previously documented as 0.11.0-alpha.3. |
| Release policy | No GitHub Releases during alpha; the Windows Build, Test, and Package workflow is the repository health gate. |
| Gateway substrate | Native in-process HTTP.sys behind IMcpGateway; no external gateway binary is required. |
| Trust posture |
auth=none, trust=lan; app-layer authentication is deferred to a later hardening track. |
MCOS is internal alpha software. Repository checks and tests validate the source tree, but each target Windows host still needs environment-specific validation for HTTP.sys binding, TLS binding, MSI installation, service behavior, DNS-SD visibility, and live LAN-client interoperability.
Archived documents are historical evidence only. They are not current installation, operation, release, or implementation guidance.
| Task | Page |
|---|---|
| Install or build from source | Quick Start |
| Configure ports, identity, gateway, security, and resource fields | Configuration |
| Enable gateway or admin TLS | TLS and HTTPS |
| Open Windows Firewall for LAN use | Windows Firewall and LAN Mode |
| Understand MSI and package artifacts | Packaging and Gateway Binary |
| Task | Page |
|---|---|
| Generate per-client onboarding profiles | Onboarding |
| Inspect client bundle fields | Client Config Bundle |
| Verify DNS-SD, UDP beacon, and discovery documents | LAN Discovery |
| Manage LAN client identity and capabilities | LAN Clients |
| Connect a remote trusted-LAN peer | Remote Client |
| Use the local bridge plugin | Claude Code Plugin |
| Task | Page |
|---|---|
| Run daily health checks | Daily Operations |
| Use the browser dashboard and WinUI shell | Dashboard |
| Interpret activity, diagnostics, and unavailable metrics | Telemetry and Activity |
| Start, stop, and inspect the MCP gateway | Gateway |
| Add, drain, scale, and remove worker pools | Worker Pools |
| Understand sub-agent behavior | Sub-Agents |
| Review CLU/Forsetti governance | Governance and CLU Governance |
| Grant least-privilege capabilities | Privileges |
| Task | Page |
|---|---|
| Back up, restore, repair, upgrade, or uninstall | Maintenance |
| Run build, test, package, and local operations commands | Operations |
| Understand alpha release gates | Release Gate |
| Review service, ProgramData, HTTP.sys, firewall, and discovery infrastructure | Infrastructure |
| Inspect existing automation surfaces | Automation |
| Diagnose common failures | Troubleshooting |
| Topic | Page |
|---|---|
| Runtime architecture | Architecture |
| ADR index | Architecture Decisions |
| LAN client control-plane decision | ADR-001 |
| Gateway-first MCP decision | ADR-002 |
| Gateway substrate decision | ADR-003 |
| Admin API routes and capability requirements | API Reference |
| Version scheme and release history | Versions |
| UI theme notes | Tron UI Theme |
- Version authority:
VERSION.json - Route registry:
include/MasterControl/AdminRouteRegistry.h - Capability policy:
include/MasterControl/AdminRouteAuthorization.h - Configuration defaults and paths:
src/MasterControlApp/MasterControlDefaults.cpp - Gateway adapter:
src/MasterControlApp/McpGatewayAdapters.cpp - Packaging:
scripts/Package-MasterControlOrchestrationServer.ps1andinstaller/Build-Msi.ps1
Quick Start | Configuration | TLS and HTTPS | Gateway | Worker Pools | API Reference | Troubleshooting | Versions
Source for this wiki is maintained under docs/wiki/ in the Master-Control-Orchestration-Server repository.
Setup
Connect Clients
Operate
- Daily Operations
- Dashboard
- Telemetry and Activity
- Gateway
- Worker Pools
- Sub-Agents
- Governance
- CLU Governance
- Privileges
Maintain
Troubleshoot
Reference