============================================================
  Soar PowerPoint 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 PowerPoint 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/Word)

[ INSTALL STEPS ]

1. Unzip this package to any folder (recommended: D:\SoarMCP\PPT)
   * 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 PowerPoint 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 PowerPoint (any edition) and load a .pptx
* Open Claude / Cowork
* Ask Claude in plain language, for example:
    "Add 5 slides, each with a title"
    "Shrink this image by half and center it"
    "Make the bullets on slide 3 dark blue"
    "Export as PDF"
    "Add a fade transition to every slide"

[ 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-ppt" entry inside the Cowork config
* Note: the AccessVBOM registry value is intentionally kept
  (it is a PowerPoint-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 PowerPoint command does nothing.
A: Make sure PowerPoint has an open presentation (not the Start page).
   Check logs\launcher.log for clues.

Q: A "Print" or "Slide Show" full-screen pops up.
A: print_presentation / start_slideshow are already blacklisted and
   never trigger. For any other dialog or full-screen mode, press ESC
   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)

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