============================================================
  Soar Word MCP — V1.1
  One-click installer (Customer Edition for Claude / Cowork)
  By Soar Design (Jimmy Kwok) © 2026
============================================================

[ BEFORE YOU INSTALL ]

1. Windows 10 / 11, 64-bit
2. Microsoft Word 2016 / 2019 / 2021 / 365 (any edition works)
3. Claude Desktop or Cowork already installed
4. A Soar Design license key
   Format: SOAR-XXXX-XXXX-XXXX-XXXX
   (Office Bundle license shared with Excel/PPT)

[ INSTALL STEPS ]

1. Unzip this package to any folder (recommended: D:\SoarMCP\Word)
   * Avoid Program Files (permission issues)
   * Avoid paths containing Chinese characters or spaces
2. Double-click install.bat
3. Wait for the script to finish:
   - Check launcher.exe exists
   - Prompt for your license key
   - Apply registry patch (enable VBA trust so run_vba can work)
   - Test connection to the Cloudflare server
   - Write the Cowork MCP config
4. When you see "Installation complete", you can close the window.

[ DAILY USE ]

* Open Word (any edition) and load a .docx file
* Open Claude / Cowork
* Ask Claude in plain language, for example:
    "Change this paragraph to Heading 1"
    "Insert a 3x3 table with a header row"
    "Add page numbers to the footer"
    "Export as PDF"

[ AUTO-UPDATE ]

Business-logic updates are automatic. Each time run_mcp.bat starts:
* The launcher checks Cloudflare for a newer version
* If found, the new module is downloaded automatically
* You don't have to do anything

Only the launcher needs a re-install when it changes.

[ UNINSTALL ]

Double-click uninstall.bat. It removes:
* The "soar-word" entry inside the Cowork config
* Note: the AccessVBOM registry value is intentionally kept
  (it is a Word-wide setting that other tools may rely on).

[ TROUBLESHOOTING ]

Q: install.bat says launcher.exe not found.
A: Make sure the launcher.dist\ folder is fully extracted
   and contains launcher.exe.

Q: License says invalid.
A: Double-check the key (uppercase + dashes). If expired, contact Soar.
   Note: Office Bundle — one key unlocks Excel + Word + PPT.

Q: Claude does not see the MCP.
A: Quit Cowork completely and reopen. If it still fails, check logs\*.log.

Q: A Word command does nothing.
A: Make sure Word has an open document (not the Start page).
   Check logs\launcher.log for clues.

Q: A "Choose data source", "Spell check", or similar dialog pops up.
A: mail_merge_start / spell_check / print_doc / print_preview are
   already blacklisted and never trigger.
   For any other dialog, click Cancel and report the action name to Soar.

[ SUPPORT ]

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

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