============================================================
  Soar Navisworks 2027 MCP — V1.0
  One-click installer (Customer Edition for Claude / Cowork)
  For Autodesk Navisworks Manage 2027
  By Soar Design (Jimmy Kwok) © 2026
============================================================

[ BEFORE YOU INSTALL ]

1. Windows 10 / 11, 64-bit
2. Autodesk Navisworks Manage 2027 installed
3. Claude Desktop or Cowork already installed
4. A Soar Design Navisworks license key
       Format: SOAR-NAVI-XXXX-XXXX-XXXX
       (Navisworks and Revit / Office licenses are independent)

* No Python required! The installer includes all executables.

[ ARCHITECTURE OVERVIEW ]

Soar Navisworks MCP has two parts:

  (a) C# Navisworks Plugin (NavisMCPBridge.dll)
      - Runs inside Navisworks, listens on a Named Pipe, calls the API directly
      - Auto-installed to the ApplicationPlugins bundle folder

  (b) MCP Server (launcher.exe + in-memory server)
      - Runs as the stdio subprocess that Claude / Cowork spawns
      - On every launch, checks Cloudflare for a newer server module
      - The C# Plugin DLL is NOT auto-updated (re-run the installer to update it)

[ INSTALL STEPS ]

1. Unzip this package to any folder (recommended: D:\Soar\Navis_MCP)
   * Avoid Program Files (permission issues)
   * Avoid paths containing Chinese characters, spaces, parentheses,
     or special characters

2. Double-click install.bat
   Wait for the script to finish all 5 steps:
   - Check launcher.exe exists
   - Prompt for your license key
   - Auto-copy NavisMCPBridge.dll + PackageContents.xml to
     C:\ProgramData\Autodesk\ApplicationPlugins\NavisMCPBridge.bundle\
   - Test connection to Cloudflare and pull the latest server module
   - Write the Cowork MCP config

3. When you see "Installation complete!":
   a. If Navisworks is already running, close and reopen it
   b. Open any .nwd or .nwf file
   c. Quit Cowork / Claude Desktop completely and reopen
   d. Test prompt: "ping Navisworks" or "get doc info"

[ DAILY USE ]

* Open Autodesk Navisworks Manage 2027 + a .nwd/.nwf file
* Open Claude / Cowork
* Ask Claude in plain language, for example:
    "Get doc info"
    "List all clash tests"
    "Run clash test 'Arch vs Structure'"
    "List saved viewpoints"
    "Create section plane"
    "Play timeliner simulation"

The MCP routes commands to the Navisworks MCP Bridge and drives Navisworks directly.

[ AUTO-UPDATE ]

The server logic auto-updates: each time the MCP starts, the launcher
checks Cloudflare for a newer server module and downloads it into RAM.
You don't have to do anything.

NOTE: The C# Plugin DLL does NOT auto-update. Re-run install.bat to update it
      (Navisworks must be closed before the DLL can be replaced).

[ UNINSTALL ]

Double-click uninstall.bat. It removes:
* Local lock/log files
* The "soar-navisworks2027" entry inside the Cowork / Claude config
* The plugin bundle at C:\ProgramData\Autodesk\ApplicationPlugins\NavisMCPBridge.bundle\
  (close Navisworks before running uninstall.bat, otherwise files will be locked)

[ EMERGENCY UNLOCK ]

If the MCP is locked (e.g. anomaly triggered), double-click unlock_mcp.bat
to clear local lock files, then restart the MCP.

[ TROUBLESHOOTING ]

Q: install.bat says "Install path contains special characters".
A: The path has parentheses, !, & or similar. Move to a simple path
   like D:\Soar\Navis_MCP

Q: install.bat says launcher.exe not found.
A: Make sure the launcher.dist folder and launcher.exe are intact.
   If corrupted, re-download the installer package.

Q: Navisworks opens but the plugin doesn't load.
A: Check C:\ProgramData\Autodesk\ApplicationPlugins\NavisMCPBridge.bundle\
   for PackageContents.xml and Contents\NavisMCPBridge.dll

Q: MCP connects but commands report "pipe not connected".
A: Navisworks must be running and have at least one model file open.

Q: License says invalid.
A: Double-check the key. If expired, contact Soar.

Q: License says "bound to another machine".
A: Each license is bound to one machine. Contact Soar for a transfer.

[ SUPPORT ]

Email   : info@soarmcpsoftware.com
Subject : Please include the first 8 chars of your license key
          (e.g. SOAR-NAVI Navisworks issue)

============================================================
