Skip to content
Jim Daley edited this page Jul 4, 2026 · 85 revisions

Master Control Orchestration Server Operator Wiki

version

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.

Current Alpha

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.

Set Up

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

Connect Clients

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

Operate

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

Maintain And Troubleshoot

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

Reference

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

Source Notes

  • 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.ps1 and installer/Build-Msi.ps1

Related Pages

Quick Start | Configuration | TLS and HTTPS | Gateway | Worker Pools | API Reference | Troubleshooting | Versions

Clone this wiki locally