html2pptx-local-mcp 1.1.17 → 1.1.19

package/app/docs/content.js

@@ -185,8 +185,8 @@ npx skills add https://html2pptx.app --list
 # More agents / multiple targets: use the interactive selector
 npx skills add https://html2pptx.app
 
-# Install remote MCP and local MCP for edit-slide
-npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude`;
+# Claude Code users: run this one line
+npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp claude`;
 
 const SKILL_INSTALL_COMMAND_JA = `# 使うエージェントのコマンドを選択
 # Claude Code
@@ -207,8 +207,8 @@ npx skills add https://html2pptx.app --list
 # その他のエージェント / 複数指定は対話形式で選択
 npx skills add https://html2pptx.app
 
-# Remote MCP と edit-slide 用 Local MCP をまとめて追加
-npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude`;
+# Claude Codeユーザーはこの1行でOK
+npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp claude`;
 
 const SKILL_INVOCATION_EXAMPLE = `# 例: Claude Code でスライド作成 → PPTX出力
 
@@ -239,12 +239,12 @@ const SKILL_AVAILABLE_LIST = [
   {
     name: 'edit-slide',
     description: 'ローカルHTMLスライドをlocalhost上のvisual editorで開き、localhost bridge 経由で同じファイルに保存。',
-    capabilities: ['html2pptx_open_local_slide_editor', 'PowerPoint風UIで視覚編集', 'ローカルHTMLへの自動保存', '変更検知と競合防止'],
+    capabilities: ['html2pptx edit <file>', 'PowerPoint風UIで視覚編集', 'ローカルHTMLへの自動保存', '変更検知と競合防止'],
   },
 ];
 
-const MCP_INSTALL_EXAMPLE = `# Remote MCP と edit-slide 用 Local MCP をまとめて追加
-npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude`;
+const MCP_INSTALL_EXAMPLE = `# Claude Codeユーザーはこの1行でOK
+npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp claude`;
 
 const MCP_CONFIG_EXAMPLE = `// 方法2: 設定ファイルに手動追加
 
@@ -254,13 +254,13 @@ const MCP_CONFIG_EXAMPLE = `// 方法2: 設定ファイルに手動追加
 
 {
   "mcpServers": {
-    "html2pptx-local": {
-      "type": "stdio",
-      "command": "node",
-      "args": [
-        "/Users/<you>/.html2pptx/bin/html2pptx-local-mcp-launcher.mjs"
-      ],
-      "env": {}
+    "html2pptx": {
+      "command": "npx",
+      "args": ["-y", "-p", "html2pptx-local-mcp@latest", "html2pptx-mcp"],
+      "env": {
+        "PPTX_STUDIO_API_KEY": "sk_live_xxxx",
+        "PPTX_STUDIO_BASE_URL": "http://127.0.0.1:<app-port>"
+      }
     }
   }
 }`;
@@ -495,7 +495,7 @@ export const DOCS_COPY = {
       {
         title: 'MCP (Model Context Protocol)',
         icon: '<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="2"/><path d="M16.24 7.76a6 6 0 010 8.49m-8.48-.01a6 6 0 010-8.49m11.31-2.82a10 10 0 010 14.14m-14.14 0a10 10 0 010-14.14"/></svg>',
-        body: 'Expose the backend to AI agents via the MCP protocol. Use the remote HTTP endpoint at /mcp for export, docs, catalog, and template publishing tools; use local stdio MCP or direct CLI for opening local HTML in edit-slide. HTML template drafts must be created through remote MCP after validation.',
+        body: 'Expose the backend to AI agents via the MCP protocol. Use the remote HTTP endpoint at /mcp for export, docs, catalog, and template publishing tools; use local stdio MCP only for opening local HTML in edit-slide. HTML template drafts must be created through remote MCP after validation.',
       },
     ],
     overviewCssTitle: 'Supported CSS Features',
@@ -747,8 +747,8 @@ export const DOCS_COPY = {
     skillsTitle: 'Skills Integration',
     skillsSubtitle: 'What are Skills',
     skillsDescription:
-      'Skills are packaged capabilities that extend AI coding agents with domain-specific knowledge and workflows. The html2pptx.app skill teaches your agent how to author slide-safe HTML, validate it against the PPTX conversion contract, optionally open the local visual editor, export through the remote MCP workflow, and publish HTML template drafts through its built-in remote MCP publishing workflow. Install once, and your agent can convert natural language instructions into production-ready PowerPoint files or creator-owned HTML drafts.',
-    skillsHowItWorks: 'The skill bundles four core capabilities: (1) HTML authoring knowledge -- the rules for writing HTML/CSS that converts cleanly to editable PowerPoint, (2) MCP-based export automation -- connecting to the remote html2pptx.app MCP server to create jobs, poll status, and retrieve results, (3) local visual editing -- opening edit-slide through a localhost bridge when the user wants to inspect or tweak the HTML before export, and (4) template publishing -- requiring HTML drafts to go through the remote MCP validate/publish loop. The agent should ask before adding a local MCP server because that changes the user’s MCP configuration.',
+      'Skills are packaged capabilities that extend AI coding agents with domain-specific knowledge and workflows. The html2pptx.app skill teaches your agent how to author slide-safe HTML, validate it against the PPTX conversion contract, optionally open the local visual editor, export through remote or local MCP workflows, and publish HTML template drafts through its built-in remote MCP publishing workflow. Install once, and your agent can convert natural language instructions into production-ready PowerPoint files or creator-owned HTML drafts.',
+    skillsHowItWorks: 'The skill bundles four core capabilities: (1) HTML authoring knowledge -- the rules for writing HTML/CSS that converts cleanly to editable PowerPoint, (2) MCP-based export automation -- connecting to the remote html2pptx.app MCP server or a local stdio MCP server to create jobs, poll status, and retrieve results, (3) local visual editing -- opening edit-slide through a localhost bridge when the user wants to inspect or tweak the HTML before export, and (4) template publishing -- requiring HTML drafts to go through the remote MCP validate/publish loop. The agent should ask before adding a local MCP server because that changes the user’s MCP configuration.',
     skillsCompatibility: 'Works with 18+ AI agents including Claude Code, Cursor, GitHub Copilot, Windsurf, Cline, Codex, and more. Use the skills CLI command for the specific agent you use, or the interactive selector for other supported agents.',
     skillsWorkflowTitle: 'Workflow',
 	    skillsWorkflow: [
@@ -756,24 +756,31 @@ export const DOCS_COPY = {
 	      'Agent reads the skill definition to understand the html2pptx.app HTML contract',
 	      'Agent generates slide-safe HTML with .slide class elements and explicit dimensions. 1600x900 is the default example',
 	      'Agent validates the markup against the conversion contract',
-	      'If visual review is needed, the agent opens the local edit-slide editor through local stdio MCP, then re-reads the edited HTML from disk',
-	      'Agent connects to remote MCP and calls html2pptx_create_export_job',
+	      'If visual review is needed, the agent opens the local edit-slide editor through the CLI or local stdio MCP, then re-reads the edited HTML from disk',
+	      'Agent connects to remote MCP or local stdio MCP and calls html2pptx_create_export_job',
 	      'Agent polls with html2pptx_wait_for_export_job until completed',
 	      'If the user wants to create an HTML template draft, the agent uses the html2pptx skill and remote MCP: infer title/tags from the HTML, run AI security preflight, validate, fix errors, save a draft, then return draftUrl for dashboard review',
 	      'Agent returns the completed job summary to the user',
 	    ],
 	    skillsLocalEditorTitle: 'Local Visual Editor',
 	    skillsLocalEditorLead:
-	      'The edit-slide skill lets an agent open a local HTML slide deck in a PowerPoint-style visual editor served from an available loopback origin such as http://localhost:<port>. Hosted edit-slide is not allowed for local file editing. The local dev script chooses a free port and registers it in .html2pptx/edit-slide/editor-server.json inside the current project. The deck file stays on the user machine and is read/written through a localhost bridge started by the local stdio MCP tool. If the local MCP server is not already configured, the agent should explain that it will change MCP settings and ask the user before adding it.',
-	    skillsLocalEditorCode: `# Use the local MCP tool only
-html2pptx_open_local_slide_editor({ "filePath": "html2pptx/slides.html" })
+	      'The edit-slide skill lets an agent open a local HTML slide deck in a PowerPoint-style visual editor served from an available loopback origin such as http://localhost:<port>. Hosted edit-slide is not allowed for local file editing. The local dev script chooses a free port and registers it in .html2pptx/edit-slide/editor-server.json inside the current project. The deck file stays on the user machine and is read/written through a localhost bridge started by the CLI or by the local stdio MCP tool. If the local MCP server is not already configured, the agent should explain that it will change MCP settings and ask the user before adding it.',
+	    skillsLocalEditorCode: `# From the project that contains your slide HTML
+node scripts/dev-studio.mjs
+npx --yes https://html2pptx.app/downloads/html2pptx-cli-0.4.0.tgz edit ./html2pptx/slides.html
+
+# If html2pptx-cli@0.4.0+ is available from npm
+npx --yes html2pptx-cli edit ./html2pptx/slides.html
+
+# If the CLI is installed globally
+html2pptx edit ./html2pptx/slides.html
 
-# Claude Code local MCP setup
-npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude`,
+# Print the URL instead of opening a browser
+html2pptx edit ./html2pptx/slides.html --no-open`,
 	    skillsLocalEditorFlowTitle: 'How the local editor flow works',
 	    skillsLocalEditorFlow: [
-	      { label: '1. Choose remote or local MCP', detail: 'Use remote MCP for normal PPTX export and catalog/docs tools. Use local stdio MCP or `html2pptx edit <file>` when the agent must open or edit a local `.html` / `.htm` file through edit-slide. If local MCP is missing, use direct CLI when the local editor app is running or ask before installing it.' },
-	      { label: '2. Start bridge', detail: '`html2pptx_open_local_slide_editor` starts a tiny HTTP server on `127.0.0.1`. Unless a port is specified, the OS assigns a free port. Access is scoped to the current working directory.' },
+	      { label: '1. Choose remote or local MCP', detail: 'Use remote MCP for normal PPTX export and catalog/docs tools. Use local stdio MCP only when the agent must open or edit a local `.html` / `.htm` file through edit-slide. If local MCP is missing, ask the user before installing it.' },
+	      { label: '2. Start bridge', detail: '`html2pptx edit <file>` or `html2pptx_open_local_slide_editor` starts a tiny HTTP server on `127.0.0.1`. Unless a port is specified, the OS assigns a free port. Access is scoped to the current working directory.' },
 	      { label: '3. Open editor', detail: 'The command opens `http://localhost:<editor-port>/edit-slide?file=...&bridge=http://127.0.0.1:<bridge-port>#bridgeToken=...`. The one-time token is kept in the URL fragment and the editor removes it from the address bar after startup.' },
 	      { label: '4. Load local file', detail: 'The browser editor presents the token and fetches the selected `.html` or `.htm` file from the localhost bridge. No marketplace draft or public page is created.' },
 	      { label: '5. Edit visually', detail: 'Users can click slide elements and adjust text, typography, color, size, padding, margin, radius, border, opacity, and other properties from the right panel.' },
@@ -793,10 +800,10 @@ npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude`,
 	    ],
 	    skillsLocalEditorTroubleshootingTitle: 'Common issues',
 	    skillsLocalEditorTroubleshooting: [
-	      { issue: 'The local editor tool is not available', fix: 'Ask before adding local MCP with `npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude`.' },
-	      { issue: '`html2pptx edit` cannot find the local editor', fix: 'Start `node scripts/dev-studio.mjs` first, or pass the active loopback URL with `--base-url http://localhost:<port>`. Hosted edit-slide is never used.' },
+	      { issue: 'The command is not found', fix: 'Start `node scripts/dev-studio.mjs`, then use `npx --yes https://html2pptx.app/downloads/html2pptx-cli-0.4.0.tgz edit ./path/to/slides.html`, or install `html2pptx-cli@0.4.0+` globally.' },
+	      { issue: '`npx` is not available', fix: 'Use the already-configured local stdio MCP tool `html2pptx_open_local_slide_editor`, or ask before adding local MCP. If local MCP is unavailable, install/expose npm or a global `html2pptx` CLI first.' },
 	      { issue: 'The editor opens but the deck does not load', fix: 'Confirm the path is relative to the directory where the command was run and the file extension is `.html` or `.htm`.' },
-	      { issue: 'Changes do not save', fix: 'Keep the local MCP session running. Stopping it stops the localhost bridge.' },
+	      { issue: 'Changes do not save', fix: 'Keep the terminal running. Closing the `html2pptx edit` process stops the localhost bridge.' },
 	      { issue: 'The agent wants to add local MCP', fix: 'Confirm with the user first. Local MCP is optional and only needed for MCP-driven local edit-slide sessions; remote MCP can still export PPTX without local file access.' },
 	      { issue: 'Another tab is read-only', fix: 'The editor uses a local tab lock to avoid two tabs writing to the same file. Use the active tab or click the transfer edit control.' },
 	    ],
@@ -841,9 +848,9 @@ echo 'HTML2PPTX_API_KEY=sk_live_xxxx' >> .env`,
     mcpTitle: 'MCP Integration',
     mcpSubtitle: 'What is MCP',
     mcpDescription:
-      'MCP (Model Context Protocol) is an open protocol that exposes backend capabilities to AI agents through a standardized tool interface. html2pptx.app supports two MCP surfaces: the remote HTTP MCP endpoint at /mcp for export, usage, docs, templates, catalog, and HTML template publishing workflows, and the local stdio MCP server for local edit-slide sessions through a localhost bridge. Use remote MCP when the agent needs to convert HTML to PPTX or create an HTML template draft. Use local stdio MCP or `html2pptx edit <file>` when the agent must open, preview, or edit a local HTML file on the user machine; local MCP does not publish templates.',
+      'MCP (Model Context Protocol) is an open protocol that exposes backend capabilities to AI agents through a standardized tool interface. html2pptx.app supports two MCP surfaces: the remote HTTP MCP endpoint at /mcp for export, usage, docs, templates, catalog, and HTML template publishing workflows, and the local stdio MCP server for export tools plus local edit-slide sessions through a localhost bridge. Use remote MCP when the agent needs to convert HTML to PPTX or create an HTML template draft. Use local stdio MCP only when the agent must open, preview, or edit a local HTML file on the user machine; local MCP does not publish templates.',
     mcpSetupTitle: 'Installation & Setup',
-    mcpSetupLead: 'Claude Code users can run the one-command installer to add both remote MCP and local edit-slide MCP. Use the remote-only command when local visual editing is not needed.',
+    mcpSetupLead: 'For Claude Code, users can run one command to register both remote export tools and local edit-slide. Remote MCP follows the hosted service; local MCP uses html2pptx-local-mcp@latest so future starts pick up the newest published package.',
     mcpEditorTabs: [
       {
         id: 'claude-code',
@@ -851,19 +858,20 @@ echo 'HTML2PPTX_API_KEY=sk_live_xxxx' >> .env`,
         icon: 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/claude/default.svg',
         recommended: true,
         steps: [
-          { title: 'Set up the remote server (recommended)', body: 'Run the following command in your terminal.', code: `claude mcp add --transport http html2pptx https://html2pptx.app/mcp` },
-          { title: 'Manual setup for Claude Code', body: 'If the command above does not work, run the following to add the MCP server manually.', code: `claude mcp add html2pptx --transport http https://html2pptx.app/mcp` },
-          { title: 'One-command remote + local setup', body: 'Installs the remote MCP for exports/docs/templates and the local MCP for edit-slide. It runs from the published package, so no repository checkout is required. The local MCP is registered through a stable launcher for reliable Claude Code startup.', code: `npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude` },
+          { title: 'Claude Code users: run this one line', body: 'This registers remote export as `html2pptx`, then writes local edit-slide as `html2pptx-local` directly into Claude Code user config.', code: `npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp claude` },
+          { title: 'Manual remote setup', body: 'If you only need hosted export tools, add the remote MCP server directly.', code: `claude mcp add --scope user --transport http html2pptx https://html2pptx.app/mcp` },
+          { title: 'Compatible local edit-slide setup', body: 'If Claude Code stdio registration is unreliable, use the installer because it writes the local server entry directly.', code: `npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp claude` },
         ],
-        tip: 'To make the MCP server available across all projects, install it with the --scope user flag:\nclaude mcp add --scope user --transport http html2pptx https://html2pptx.app/mcp',
+        tip: 'The installer registers the remote MCP with user scope and writes the local stdio MCP directly to Claude Code user config for better compatibility.',
       },
       {
         id: 'codex',
         label: 'Codex',
         icon: 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/openai/light.svg',
         steps: [
-          { title: 'Run the CLI command (recommended)', body: 'Run the following command in your terminal. OAuth authentication will start automatically.', code: `codex mcp add html2pptx --url https://html2pptx.app/mcp` },
-          { title: 'Optional local stdio MCP for edit-slide', body: 'Use this when Codex needs to launch local edit-slide for a `.html` file. It runs from the published package, so no repository checkout is required. The editor app and localhost bridge use free ports. Codex should ask before adding it because it modifies the local MCP configuration.', code: `codex mcp add html2pptx-local -- npx -y html2pptx-local-mcp@latest html2pptx-mcp` },
+          { title: 'Run the CLI command (recommended)', body: 'Add the hosted remote MCP server. OAuth authentication will start automatically.', code: `codex mcp add html2pptx --url https://html2pptx.app/mcp` },
+          { title: 'Manual remote setup', body: 'If you only need hosted export tools, add the remote MCP server directly.', code: `codex mcp add html2pptx --url https://html2pptx.app/mcp` },
+          { title: 'Optional local stdio MCP for edit-slide', body: 'Use this only when Codex needs to launch local edit-slide for a `.html` file. It runs from the published package, so no repository checkout is required.', code: `codex mcp add html2pptx-local -- npx -y -p html2pptx-local-mcp@latest html2pptx-mcp` },
           { title: 'Manual setup via codex.json', body: 'Alternatively, create or edit codex.json in your project root.', code: `{\n  "mcpServers": {\n    "html2pptx": {\n      "type": "url",\n      "url": "https://html2pptx.app/mcp"\n    }\n  }\n}` },
         ],
       },
@@ -1583,8 +1591,8 @@ echo 'HTML2PPTX_API_KEY=sk_live_xxxx' >> .env`,
     skillsTitle: 'Skills統合ガイド',
     skillsSubtitle: 'Skillsとは',
     skillsDescription:
-      'Skillsは、AIコーディングエージェントにドメイン固有の知識とワークフローを追加するパッケージ機能です。html2pptx.app のスキルをインストールすると、エージェントがスライド用HTMLの作成方法を理解し、PPTX変換契約に対する検証を行い、必要に応じてローカル Visual Editor を開き、remote MCP のワークフローでエクスポートし、内蔵のremote MCP公開ワークフローでHTMLテンプレートdraftを作成できます。自然言語の指示だけで、本番品質のPowerPointファイルや作成者所有のHTML draftを生成できます。',
-    skillsHowItWorks: 'スキルには4つのコア機能がバンドルされています: (1) HTMLオーサリング知識 -- 高品質なPowerPointに変換されるHTML/CSSの書き方ルール、(2) MCPベースのエクスポート自動化 -- remote MCP に接続してジョブ作成・ステータスポーリング・結果取得を行う仕組み、(3) ローカル Visual Editor -- ユーザーがPPTX出力前にHTMLを目視確認・微調整したい場合に edit-slide を localhost bridge 経由で開く仕組み、(4) テンプレート公開 -- HTML draft を remote MCP の validate/publish ループに限定する仕組みです。local MCP の追加はユーザーのMCP設定を変更するため、エージェントは必ず事前に確認します。',
+      'Skillsは、AIコーディングエージェントにドメイン固有の知識とワークフローを追加するパッケージ機能です。html2pptx.app のスキルをインストールすると、エージェントがスライド用HTMLの作成方法を理解し、PPTX変換契約に対する検証を行い、必要に応じてローカル Visual Editor を開き、remote MCP または local MCP のワークフローでエクスポートし、内蔵のremote MCP公開ワークフローでHTMLテンプレートdraftを作成できます。自然言語の指示だけで、本番品質のPowerPointファイルや作成者所有のHTML draftを生成できます。',
+    skillsHowItWorks: 'スキルには4つのコア機能がバンドルされています: (1) HTMLオーサリング知識 -- 高品質なPowerPointに変換されるHTML/CSSの書き方ルール、(2) MCPベースのエクスポート自動化 -- remote MCP または local stdio MCP に接続してジョブ作成・ステータスポーリング・結果取得を行う仕組み、(3) ローカル Visual Editor -- ユーザーがPPTX出力前にHTMLを目視確認・微調整したい場合に edit-slide を localhost bridge 経由で開く仕組み、(4) テンプレート公開 -- HTML draft を remote MCP の validate/publish ループに限定する仕組みです。local MCP の追加はユーザーのMCP設定を変更するため、エージェントは必ず事前に確認します。',
     skillsCompatibility: 'Claude Code、Cursor、GitHub Copilot、Windsurf、Cline、Codex 等 18以上のAIエージェントに対応。使うエージェントに対応する skills CLI コマンドを選ぶか、その他の対応エージェントは対話形式で選択します。',
     skillsWorkflowTitle: 'ワークフロー',
 	    skillsWorkflow: [
@@ -1592,24 +1600,31 @@ echo 'HTML2PPTX_API_KEY=sk_live_xxxx' >> .env`,
 	      'エージェントがスキル定義を読み取り、html2pptx.appのHTML契約を理解',
 	      'エージェントが .slide クラス要素と明示サイズ付きのスライドセーフHTMLを生成。1600x900 はデフォルト例',
 	      'エージェントが変換契約に対してマークアップを検証',
-	      '目視確認が必要な場合は、local stdio MCP で edit-slide を開き、編集後のHTMLをディスクから再読み込み',
-	      'エージェントが remote MCP に接続し html2pptx_create_export_job を呼び出し',
+	      '目視確認が必要な場合は、CLI または local stdio MCP で edit-slide を開き、編集後のHTMLをディスクから再読み込み',
+	      'エージェントが remote MCP または local stdio MCP に接続し html2pptx_create_export_job を呼び出し',
 	      'エージェントが html2pptx_wait_for_export_job で完了をポーリング',
 	      'HTMLテンプレートdraftを作る場合は、html2pptx スキルと remote MCP でHTMLから題名・タグを推定し、AIセキュリティ事前診断、検証、エラー修正、下書き保存を行い、draftUrlを返却',
 	      'エージェントが completed 状態のジョブサマリーをユーザーに返却',
 	    ],
 	    skillsLocalEditorTitle: 'ローカル Visual Editor',
 	    skillsLocalEditorLead:
-	      'edit-slide スキルを使うと、エージェントが作成したローカルHTMLスライドを、http://localhost:<port> のような空き loopback origin で動くPowerPoint風のノーコード編集画面で開けます。ローカルファイル編集に hosted edit-slide は使えません。ローカル dev script が空きポートを選び、現在のプロジェクト内の .html2pptx/edit-slide/editor-server.json に登録します。スライドHTMLファイルはユーザーのPC上に残り、CLI または local stdio MCP が起動する localhost bridge 経由で読み書きされます。local MCP が未設定の場合は、local editor が動いていれば `html2pptx edit <file>` を使い、MCP設定を変更する場合はユーザー確認を取ってから追加します。',
-	    skillsLocalEditorCode: `# local MCP tool だけを使う
-html2pptx_open_local_slide_editor({ "filePath": "html2pptx/slides.html" })
+	      'edit-slide スキルを使うと、エージェントが作成したローカルHTMLスライドを、http://localhost:<port> のような空き loopback origin で動くPowerPoint風のノーコード編集画面で開けます。ローカルファイル編集に hosted edit-slide は使えません。ローカル dev script が空きポートを選び、現在のプロジェクト内の .html2pptx/edit-slide/editor-server.json に登録します。スライドHTMLファイルはユーザーのPC上に残り、CLI または local stdio MCP が起動する localhost bridge 経由で読み書きされます。local MCP が未設定の場合、エージェントはMCP設定を変更することを説明し、ユーザー確認を取ってから追加します。',
+	    skillsLocalEditorCode: `# スライドHTMLがあるプロジェクトで実行
+node scripts/dev-studio.mjs
+npx --yes https://html2pptx.app/downloads/html2pptx-cli-0.4.0.tgz edit ./html2pptx/slides.html
+
+# npm から html2pptx-cli@0.4.0+ を使える場合
+npx --yes html2pptx-cli edit ./html2pptx/slides.html
+
+# CLIをグローバルインストール済みの場合
+html2pptx edit ./html2pptx/slides.html
 
-# Claude Code local MCP setup
-npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude`,
+# ブラウザを自動で開かず、URLだけ表示
+html2pptx edit ./html2pptx/slides.html --no-open`,
 	    skillsLocalEditorFlowTitle: 'ローカル編集の仕組み',
 	    skillsLocalEditorFlow: [
-	      { label: '1. remote / local MCP を選ぶ', detail: '通常のPPTX出力、docs、template、usage 取得は remote MCP を使えます。ローカル `.html` / `.htm` を edit-slide で開いて編集する場合は local stdio MCP または `html2pptx edit <file>` を使います。local MCP が未設定なら、直接CLIを使うか、追加前にユーザーへ確認します。' },
-	      { label: '2. bridge を起動', detail: '`html2pptx_open_local_slide_editor` が `127.0.0.1` に小さなHTTPサーバーを起動します。ポートは指定しない限りOSが選ぶ空きポートになります。アクセス範囲はコマンドを実行したカレントディレクトリ内に限定されます。' },
+	      { label: '1. remote / local MCP を選ぶ', detail: '通常のPPTX出力、docs、template、usage 取得は remote MCP を使えます。ローカル `.html` / `.htm` を edit-slide で開いて編集する必要がある場合だけ local stdio MCP を使います。local MCP が未設定なら、追加前にユーザーへ確認します。' },
+	      { label: '2. bridge を起動', detail: '`html2pptx edit <file>` または `html2pptx_open_local_slide_editor` が `127.0.0.1` に小さなHTTPサーバーを起動します。ポートは指定しない限りOSが選ぶ空きポートになります。アクセス範囲はコマンドを実行したカレントディレクトリ内に限定されます。' },
 	      { label: '3. エディタを開く', detail: 'コマンドが `http://localhost:<editor-port>/edit-slide?file=...&bridge=http://127.0.0.1:<bridge-port>#bridgeToken=...` を開きます。ワンタイム token は URL fragment に置かれ、起動後にエディタがアドレスバーから消します。' },
 	      { label: '4. ローカルHTMLを読み込む', detail: 'ブラウザの編集画面が token を提示し、localhost bridge から対象の `.html` / `.htm` ファイルを取得します。マーケットプレイス下書きや公開ページは作成されません。' },
 	      { label: '5. ノーコードで編集', detail: 'スライド上の要素をクリックし、右パネルからテキスト、タイポグラフィ、色、サイズ、余白、角丸、ボーダー、不透明度などを調整できます。' },
@@ -1629,11 +1644,11 @@ npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude`,
 	    ],
 	    skillsLocalEditorTroubleshootingTitle: 'よくあるつまずき',
 	    skillsLocalEditorTroubleshooting: [
-	      { issue: 'local editor tool が使えない', fix: '`npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude` で local MCP を追加してよいか、先にユーザーへ確認してください。' },
-	      { issue: '`html2pptx edit` が local editor を見つけられない', fix: '`node scripts/dev-studio.mjs` を先に起動するか、`--base-url http://localhost:<port>` で loopback URL を渡してください。hosted edit-slide は使いません。' },
+	      { issue: 'コマンドが見つからない', fix: '`node scripts/dev-studio.mjs` を起動してから `npx --yes https://html2pptx.app/downloads/html2pptx-cli-0.4.0.tgz edit ./path/to/slides.html` を使うか、`html2pptx-cli@0.4.0+` をグローバルインストールしてください。' },
+	      { issue: '`npx` が使えない', fix: 'すでに設定済みの local stdio MCP ツール `html2pptx_open_local_slide_editor` を使うか、local MCP を追加する前にユーザーへ確認してください。local MCP も使えない場合は、npm またはグローバル `html2pptx` CLI を先に使える状態にします。' },
 	      { issue: '画面は開くがスライドが読み込まれない', fix: 'コマンドを実行したディレクトリからの相対パスになっているか、拡張子が `.html` / `.htm` かを確認してください。' },
-	      { issue: '編集内容が保存されない', fix: 'local MCP セッションを終了しないでください。bridge が止まると保存できません。' },
-	      { issue: 'エージェントが local MCP を追加しようとする', fix: '先にユーザーへ確認してください。local MCP は MCP 経由でローカル edit-slide を開く場合だけ必要です。CLI の `html2pptx edit <file>` でも local editor を開けます。' },
+	      { issue: '編集内容が保存されない', fix: 'ターミナルで起動している `html2pptx edit` を終了しないでください。bridge が止まると保存できません。' },
+	      { issue: 'エージェントが local MCP を追加しようとする', fix: '先にユーザーへ確認してください。local MCP は MCP 経由でローカル edit-slide を開く場合だけ必要です。remote MCP だけでもPPTX出力はできます。' },
 	      { issue: '別タブが読み取り専用になる', fix: '同じHTMLを複数タブで編集して競合しないよう、エディタはタブロックを使います。編集権限のあるタブを使うか、画面上の移譲操作を行ってください。' },
 	    ],
 	    skillsSetupTitle: 'セットアップ',
@@ -1677,9 +1692,9 @@ echo 'HTML2PPTX_API_KEY=sk_live_xxxx' >> .env`,
     mcpTitle: 'MCP統合ガイド',
     mcpSubtitle: 'MCPとは',
     mcpDescription:
-      'MCP (Model Context Protocol) は、標準化されたツールインターフェースを通じてAIエージェントにバックエンド機能を公開するオープンプロトコルです。html2pptx.app は2種類のMCPサーフェスを提供します。remote HTTP MCP (`/mcp`) はエクスポート、usage、docs、templates、catalog、HTMLテンプレート公開に使います。local stdio MCP は localhost bridge 経由でローカルHTMLを edit-slide で開くために使います。HTMLをPPTXに変換する、またはHTMLテンプレートdraftを作るなら remote MCP、ユーザーPC上の `.html` を開いてプレビュー・編集するなら local MCP を選びます。local MCP はテンプレート公開には使いません。',
+      'MCP (Model Context Protocol) は、標準化されたツールインターフェースを通じてAIエージェントにバックエンド機能を公開するオープンプロトコルです。html2pptx.app は2種類のMCPサーフェスを提供します。remote HTTP MCP (`/mcp`) はエクスポート、usage、docs、templates、catalog、HTMLテンプレート公開に使います。local stdio MCP は同じエクスポート系ツールに加えて、localhost bridge 経由でローカルHTMLを edit-slide で開くために使います。HTMLをPPTXに変換する、またはHTMLテンプレートdraftを作るなら remote MCP、ユーザーPC上の `.html` を開いてプレビュー・編集するなら local MCP を選びます。local MCP はテンプレート公開には使いません。',
     mcpSetupTitle: 'インストール & セットアップ',
-    mcpSetupLead: 'Claude Code では1コマンドインストーラで remote MCP と edit-slide 用 local MCP をまとめて追加できます。ローカル編集が不要な場合だけ remote-only コマンドを使ってください。',
+    mcpSetupLead: 'Claude Codeユーザーは1コマンドで remote export と local edit-slide の両方を登録できます。remote MCP は hosted service 側の更新が反映され、local MCP は html2pptx-local-mcp@latest 経由で起動するため、次回起動時に新しい公開パッケージへ追従できます。',
     mcpEditorTabs: [
       {
         id: 'claude-code',
@@ -1687,19 +1702,20 @@ echo 'HTML2PPTX_API_KEY=sk_live_xxxx' >> .env`,
         icon: 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/claude/default.svg',
         recommended: true,
         steps: [
-          { title: 'リモートサーバーをセットアップ（推奨）', body: 'ターミナルで以下のコマンドを実行してください。', code: `claude mcp add --transport http html2pptx https://html2pptx.app/mcp` },
-          { title: '手動セットアップ', body: 'コマンドが使えない場合は、以下を実行してMCPサーバーを手動で追加してください。', code: `claude mcp add html2pptx --transport http https://html2pptx.app/mcp` },
-          { title: 'Remote + Local を1コマンドで追加', body: 'PPTX出力・docs・templates 用の remote MCP と、edit-slide 用の local MCP をまとめて追加します。公開パッケージから導入するため、リポジトリの checkout は不要です。local MCP は Claude Code が安定して起動できるよう stable launcher として登録されます。', code: `npx -y html2pptx-local-mcp@latest html2pptx-install-mcp claude` },
+          { title: 'Claude Codeユーザーはこの1行でOK', body: '`html2pptx` として remote export を登録し、`html2pptx-local` として local edit-slide を Claude Code の user config に直接書き込みます。', code: `npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp claude` },
+          { title: 'remote だけ手動セットアップ', body: 'PPTX出力などのホスト側ツールだけ必要な場合はこちらを使います。', code: `claude mcp add --scope user --transport http html2pptx https://html2pptx.app/mcp` },
+          { title: 'local edit-slide 互換セットアップ', body: 'Claude Code の stdio 登録が不安定な場合も、このインストーラーが local server 設定を直接書き込みます。', code: `npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp claude` },
         ],
-        tip: 'すべてのプロジェクトでMCPサーバーを使用するには --scope user フラグを追加してください:\nclaude mcp add --scope user --transport http html2pptx https://html2pptx.app/mcp',
+        tip: 'このインストーラーは remote MCP を user scope で登録し、互換性のため local stdio MCP は Claude Code の user config に直接書き込みます。',
       },
       {
         id: 'codex',
         label: 'Codex',
         icon: 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/openai/light.svg',
         steps: [
-          { title: 'CLIコマンドで追加（推奨）', body: 'ターミナルで以下のコマンドを実行してください。OAuth認証が自動的に開始されます。', code: `codex mcp add html2pptx --url https://html2pptx.app/mcp` },
-          { title: 'edit-slide 用 local stdio MCP（任意）', body: 'Codex がローカル `.html` を edit-slide で開く必要がある場合だけ追加します。公開パッケージから起動するため、リポジトリのcheckoutは不要です。エディタ本体と localhost bridge は空きポートを使います。MCP設定を変更するため、Codex は実行前にユーザー確認を取ってください。', code: `codex mcp add html2pptx-local -- npx -y html2pptx-local-mcp@latest html2pptx-mcp` },
+          { title: 'CLIコマンドで追加（推奨）', body: 'hosted remote MCP server を追加します。OAuth認証が自動的に開始されます。', code: `codex mcp add html2pptx --url https://html2pptx.app/mcp` },
+          { title: 'remote だけ手動セットアップ', body: 'PPTX出力などのホスト側ツールだけ必要な場合はこちらを使います。', code: `codex mcp add html2pptx --url https://html2pptx.app/mcp` },
+          { title: 'edit-slide 用 local stdio MCP（任意）', body: 'Codex がローカル `.html` を edit-slide で開く必要がある場合だけ追加します。公開パッケージから起動するため、リポジトリの checkout は不要です。', code: `codex mcp add html2pptx-local -- npx -y -p html2pptx-local-mcp@latest html2pptx-mcp` },
           { title: 'codex.json で手動セットアップ', body: 'コマンドが使えない場合は、プロジェクトルートの codex.json に以下を追加してください。', code: `{\n  "mcpServers": {\n    "html2pptx": {\n      "type": "url",\n      "url": "https://html2pptx.app/mcp"\n    }\n  }\n}` },
         ],
       },

package/cli/dist/commands/edit.d.ts

@@ -3,6 +3,7 @@ export interface EditOptions {
     port?: string;
     baseUrl?: string;
     noOpen?: boolean;
+    open?: boolean;
     json?: boolean;
 }
 interface BridgeContext {

package/cli/dist/commands/edit.js

@@ -506,24 +506,26 @@ function bail(message, options) {
     process.exit(1);
 }
 export async function editCommand(input, options = {}) {
+    const noOpen = options.noOpen === true || options.open === false;
+    const normalizedOptions = { ...options, noOpen };
     if (!input) {
-        bail("HTML file path is required. Example: html2pptx edit ./html2pptx/slides.html", options);
+        bail("HTML file path is required. Example: html2pptx edit ./html2pptx/slides.html", normalizedOptions);
     }
     const root = await realpath(process.cwd());
     const abs = resolve(root, input);
     const rel = relativeToRoot(root, abs);
     const ext = extname(abs).toLowerCase();
     if (!ALLOWED_EXT.has(ext)) {
-        bail("Only .html/.htm files can be opened in the editor.", options);
+        bail("Only .html/.htm files can be opened in the editor.", normalizedOptions);
     }
     if (abs !== root && !abs.startsWith(root + sep)) {
-        bail("The file must be inside the current working directory.", options);
+        bail("The file must be inside the current working directory.", normalizedOptions);
     }
     try {
         await stat(abs);
     }
     catch {
-        bail(`File not found: ${rel}`, options);
+        bail(`File not found: ${rel}`, normalizedOptions);
     }
     let baseUrl;
     let requestedPort;
@@ -532,7 +534,7 @@ export async function editCommand(input, options = {}) {
         requestedPort = parsePort(options.port);
     }
     catch (error) {
-        bail(error.message, options);
+        bail(error.message, normalizedOptions);
     }
     const ctx = {
         root,
@@ -550,7 +552,7 @@ export async function editCommand(input, options = {}) {
     }
     const bridgeUrl = `http://127.0.0.1:${bridgePort}`;
     const editorUrl = buildEditorUrl(baseUrl, rel, bridgeUrl, ctx.sessionToken);
-    if (options.json) {
+    if (normalizedOptions.json) {
         console.log(JSON.stringify({
             success: true,
             editorUrl: editorUrl.toString(),
@@ -562,7 +564,7 @@ export async function editCommand(input, options = {}) {
     }
     else {
         p.log.success(`Local edit bridge listening on ${pc.cyan(bridgeUrl)} ${pc.dim("(session token required)")}`);
-        if (options.noOpen) {
+        if (normalizedOptions.noOpen) {
             p.log.info(`Open in editor: ${pc.cyan(editorUrl.toString())}`);
         }
         else {
@@ -570,7 +572,7 @@ export async function editCommand(input, options = {}) {
         }
         p.log.info(pc.dim("Press Ctrl+C to stop the bridge."));
     }
-    if (!options.noOpen) {
+    if (!normalizedOptions.noOpen) {
         openUrl(editorUrl.toString());
     }
     stopOnSignal(server);

package/cli/dist/index.js

@@ -41,7 +41,7 @@ program
     .action(convertCommand);
 program
     .command("edit")
-    .description("Open a local HTML slide file in the localhost visual editor")
+    .description("Open a local slide HTML file in the html2pptx visual editor")
     .argument("<input>", "Path to HTML file")
     .option("--port <port>", "Local bridge port. Defaults to auto.")
     .option("--no-open", "Print the editor URL without opening a browser")

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "html2pptx-cli",
-  "version": "0.4.2",
+  "version": "0.4.0",
   "description": "CLI tool to convert HTML/CSS to editable PowerPoint files via html2pptx.app",
   "type": "module",
   "bin": {

package/lib/local-slide-editor-launcher.js

@@ -21,11 +21,22 @@ export function createLocalSlideEditorManager(options = {}) {
 
   async function open(input = {}) {
     const file = await resolveEditableFile(input.filePath, rootCwd);
+    const reuseExisting = input.reuseExisting !== false;
+    if (reuseExisting) {
+      const existing = findReusableSession(file);
+      if (existing) {
+        return {
+          ...redactSessionForResponse(existing),
+          reused: true,
+        };
+      }
+    }
+
     const baseUrl = normalizeEditorBaseUrl(
       input.baseUrl || process.env.HTML2PPTX_EDITOR_BASE_URL || await readRegisteredEditorBaseUrl(file.root),
     );
     const port = normalizePort(input.port, 0);
-    const openBrowser = input.openBrowser !== false;
+    const openBrowser = input.openBrowser === true;
     const invocation = resolveCliInvocation(options);
     const childArgs = [
       ...invocation.baseArgs,
@@ -78,7 +89,25 @@ export function createLocalSlideEditorManager(options = {}) {
 
     const details = await waitForBridgeDetails(session, launchTimeoutMs);
     session.details = details;
-    return redactSessionForResponse(session);
+    return {
+      ...redactSessionForResponse(session),
+      reused: false,
+    };
+  }
+
+  function findReusableSession(file) {
+    for (const session of sessions.values()) {
+      if (
+        session.filePath === file.absolutePath &&
+        session.root === file.root &&
+        session.details &&
+        !session.child.killed &&
+        session.child.exitCode == null
+      ) {
+        return session;
+      }
+    }
+    return null;
   }
 
   async function stop(sessionId) {

package/lib/pptx-studio-mcp-core.js

@@ -416,7 +416,7 @@ export const LOCAL_TOOL_DEFINITIONS = [
     name: 'html2pptx_open_local_slide_editor',
     title: 'Open Local Slide Editor',
     description:
-      'Local stdio MCP only. Start the same localhost edit bridge used by `html2pptx edit` for a .html/.htm slide file inside the MCP server working directory, then return the tokenized editor URL. This does not publish or upload the HTML file.',
+      'Local stdio MCP only. Start the html2pptx CLI local edit bridge for a .html/.htm slide file inside the MCP server working directory, then return the tokenized editor URL. This does not publish or upload the HTML file.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -437,7 +437,11 @@ export const LOCAL_TOOL_DEFINITIONS = [
         },
         openBrowser: {
           type: 'boolean',
-          description: 'When true (default), the CLI opens the editor in the browser. Set false to only return the URL.',
+          description: 'When true, open the editor in the browser. Defaults to false for MCP calls so agents can return one URL without spawning extra tabs.',
+        },
+        reuseExisting: {
+          type: 'boolean',
+          description: 'When true (default), reuse an active editor bridge for the same file instead of starting another bridge and browser tab.',
         },
       },
       required: ['filePath'],
@@ -595,7 +599,7 @@ function buildPromptMessages(name, args) {
               `3. Save the complete HTML document to a project-local .html file, preferably "${fileName}" or another clear path under html2pptx/.`,
               '4. Open only a loopback editor UI. First ensure the local editor app is running with node scripts/dev-studio.mjs; it will choose an available port and register the editor URL under .html2pptx/edit-slide/editor-server.json in the current project.',
               '5. Call html2pptx_open_local_slide_editor with { filePath: <path> }. Pass baseUrl only when the user supplied a specific loopback editor URL. Do not use https://html2pptx.app/edit-slide for local file editing.',
-              '6. If that local editor tool is not available, use direct `html2pptx edit <path>` when the local editor app is running, or ask the user to install the local MCP with: npx -y -p https://html2pptx.app/downloads/html2pptx-local-mcp-1.1.16.tgz html2pptx-install-mcp claude.',
+              '6. If that local editor tool is not available, do not pretend the editor was opened. Return the saved HTML path and the local-UI CLI fallback command: npx --yes https://html2pptx.app/downloads/html2pptx-cli-0.4.0.tgz edit <path>. If the CLI reports that the editor is not registered, start node scripts/dev-studio.mjs first.',
               '7. Do not export PPTX from this prompt. In the editor, the export button should only show a prompt telling the user to ask Claude Code or another agent to use the html2pptx skills for PowerPoint export.',
             ].join('\n'),
           },
@@ -647,7 +651,18 @@ export function negotiateProtocol(requestedProtocol) {
 }
 
 export function getToolDefinitions(client = {}, { localOnly = false } = {}) {
-  const tools = localOnly ? [] : [...TOOL_DEFINITIONS];
+  if (localOnly) {
+    const localTools = [];
+    if (typeof client.openLocalSlideEditor === 'function') {
+      localTools.push(LOCAL_TOOL_DEFINITIONS[0]);
+    }
+    if (typeof client.stopLocalSlideEditor === 'function') {
+      localTools.push(LOCAL_TOOL_DEFINITIONS[1]);
+    }
+    return localTools;
+  }
+
+  const tools = [...TOOL_DEFINITIONS];
   if (typeof client.openLocalSlideEditor === 'function') {
     tools.push(LOCAL_TOOL_DEFINITIONS[0]);
   }
@@ -660,12 +675,11 @@ export function getToolDefinitions(client = {}, { localOnly = false } = {}) {
 function buildServerInstructions(client = {}, { localOnly = false } = {}) {
   if (localOnly) {
     return [
-      'html2pptx local MCP opens local slide HTML in the loopback edit-slide visual editor.',
-      '',
-      'This server intentionally exposes only local editor tools. Use the remote html2pptx MCP server at https://html2pptx.app/mcp for PPTX exports, docs, usage, plans, templates, and publishing.',
-      '',
-      'When the user asks to open or visually edit local slides, save the deck as a project-local .html/.htm file and call html2pptx_open_local_slide_editor with { filePath: <path> }.',
-      'The tool starts a localhost bridge and does not publish or upload the HTML file.',
+      'html2pptx local MCP opens local slide HTML files in the no-code edit-slide editor.',
+      'Use this stdio server only for local visual editing. Use the remote html2pptx MCP server for PPTX export, docs, usage, templates, and publishing workflows.',
+      'When the user asks to open, preview, no-code edit, visually edit, or launch an editing screen for generated slides, save the deck as a local .html/.htm file first, usually under html2pptx/<name>.html.',
+      'Then call html2pptx_open_local_slide_editor with the project-relative file path.',
+      'The tool starts the html2pptx CLI localhost bridge and does not publish or upload the HTML file.',
     ].join('\n');
   }
 
@@ -715,11 +729,7 @@ function buildServerInstructions(client = {}, { localOnly = false } = {}) {
   return lines.join('\n');
 }
 
-export async function executeTool(name, args, client, { sendNotification, progressToken, localOnly = false } = {}) {
-  if (localOnly && !LOCAL_TOOL_DEFINITIONS.some((tool) => tool.name === name)) {
-    throw new Error(`${name} is available from the remote html2pptx MCP server, not the local stdio MCP server.`);
-  }
-
+export async function executeTool(name, args, client, { sendNotification, progressToken } = {}) {
   switch (name) {
     case 'html2pptx_list_export_plans': {
       const data = await client.listExportPlans();
@@ -902,7 +912,8 @@ export async function executeTool(name, args, client, { sendNotification, progre
         filePath: args.filePath,
         baseUrl: typeof args.baseUrl === 'string' ? args.baseUrl : undefined,
         port: Number.isFinite(args.port) ? args.port : undefined,
-        openBrowser: args.openBrowser !== false,
+        openBrowser: args.openBrowser === true,
+        reuseExisting: args.reuseExisting !== false,
       });
       return buildToolResponse(renderLocalSlideEditorText(data), data);
     }
@@ -919,7 +930,7 @@ export async function executeTool(name, args, client, { sendNotification, progre
   }
 }
 
-export async function handleMcpMessage(message, { protocolVersion = DEFAULT_PROTOCOL, client, sendNotification, localOnly = false, serverInfo = SERVER_INFO }) {
+export async function handleMcpMessage(message, { protocolVersion = DEFAULT_PROTOCOL, client, sendNotification, serverInfo = SERVER_INFO, localOnly = false }) {
   if (!message || typeof message !== 'object') {
     return { protocolVersion, response: null };
   }
@@ -1151,7 +1162,7 @@ export async function handleMcpMessage(message, { protocolVersion = DEFAULT_PROT
     try {
       const toolArgs = params?.arguments ?? {};
       const progressToken = toolArgs._meta?.progressToken ?? params?._meta?.progressToken;
-      const payload = await executeTool(params?.name, toolArgs, client, { sendNotification, progressToken, localOnly });
+      const payload = await executeTool(params?.name, toolArgs, client, { sendNotification, progressToken });
       return {
         protocolVersion,
         response: {
@@ -1438,7 +1449,7 @@ function renderAnimationCatalogText(catalog) {
 
 function renderLocalSlideEditorText(data) {
   const lines = [
-    '# Local slide editor started',
+    data.reused ? '# Local slide editor reused' : '# Local slide editor started',
     '',
     `File: ${data.file || 'unknown'}`,
     `Bridge: ${data.bridgeUrl || 'unknown'}`,

package/mcp/pptx-studio-mcp-server.mjs

@@ -13,7 +13,7 @@ import {
 
 let inputBuffer = Buffer.alloc(0);
 let negotiatedProtocol = DEFAULT_PROTOCOL;
-let outputFraming = 'lines';
+let wireMode = 'content-length';
 
 process.stdin.on('data', (chunk) => {
   inputBuffer = Buffer.concat([inputBuffer, chunk]);
@@ -36,16 +36,22 @@ process.stdout.on('error', (error) => {
 function drainMessages() {
   while (true) {
     const headerEnd = inputBuffer.indexOf('\r\n\r\n');
-    if (headerEnd === -1) {
-      const newlineEnd = inputBuffer.indexOf('\n');
-      if (newlineEnd === -1) return;
-      const rawLine = inputBuffer.slice(0, newlineEnd).toString('utf8').trim();
-      inputBuffer = inputBuffer.slice(newlineEnd + 1);
+    const lineEnd = inputBuffer.indexOf('\n');
+
+    if (headerEnd === -1 || (lineEnd !== -1 && lineEnd < headerEnd)) {
+      if (lineEnd === -1) return;
+
+      const rawLine = inputBuffer.slice(0, lineEnd).toString('utf8').trim();
+      inputBuffer = inputBuffer.slice(lineEnd + 1);
       if (!rawLine) continue;
+
+      wireMode = 'line';
       handleRawMessage(rawLine);
       continue;
     }
 
+    wireMode = 'content-length';
+
     const headerText = inputBuffer.slice(0, headerEnd).toString('utf8');
     const contentLengthMatch = headerText.match(/Content-Length:\s*(\d+)/i);
     if (!contentLengthMatch) {
@@ -60,7 +66,6 @@ function drainMessages() {
 
     const rawBody = inputBuffer.slice(headerEnd + 4, messageEnd).toString('utf8');
     inputBuffer = inputBuffer.slice(messageEnd);
-    outputFraming = 'headers';
 
     handleRawMessage(rawBody);
   }
@@ -85,6 +90,35 @@ function handleRawMessage(rawBody) {
 
 async function handleMessage(message) {
   const client = {
+    listExportPlans: async () => requestJson('/api/export/plans'),
+    createExportJob: async (body) =>
+      requestJson('/api/export/jobs', {
+        method: 'POST',
+        requireApiKey: true,
+        body,
+      }),
+    getExportJob: async (jobId) =>
+      requestJson(`/api/export/jobs/${encodeURIComponent(jobId)}`, {
+        requireApiKey: true,
+      }),
+    getUsage: async () =>
+      requestJson('/api/export/usage', {
+        requireApiKey: true,
+      }),
+    listTemplates: async (category) => {
+      const url = category
+        ? `/api/templates?category=${encodeURIComponent(category)}`
+        : '/api/templates';
+      // requireApiKey so the API is treated as authenticated and returns
+      // template prompts (anonymous requests get hasPrompt boolean only).
+      return requestJson(url, { requireApiKey: true });
+    },
+    getTemplateHtml: async (templateId) =>
+      requestJson(`/api/templates/html?id=${encodeURIComponent(templateId)}`, {
+        // /api/templates/html now requires auth (browser session, API key,
+        // or WorkOS JWT) so anonymous curl/browser can't scrape prompts.
+        requireApiKey: true,
+      }),
     openLocalSlideEditor: async (args) => localSlideEditorManager.open(args),
     stopLocalSlideEditor: async (sessionId) => localSlideEditorManager.stop(sessionId),
   };
@@ -92,11 +126,11 @@ async function handleMessage(message) {
   const handled = await handleMcpMessage(message, {
     protocolVersion: negotiatedProtocol,
     client,
-    localOnly: true,
     serverInfo: {
       ...SERVER_INFO,
       name: 'html2pptx-local',
     },
+    localOnly: true,
     sendNotification: (notification) => {
       sendMessage(notification);
     },
@@ -182,13 +216,14 @@ function sendError(id, code, message) {
 
 function sendMessage(message) {
   const json = JSON.stringify(message);
-  if (outputFraming === 'headers') {
-    const headers = `Content-Length: ${Buffer.byteLength(json, 'utf8')}\r\nContent-Type: application/json\r\n\r\n`;
-    process.stdout.write(headers);
-    process.stdout.write(json);
+  if (wireMode === 'line') {
+    process.stdout.write(`${json}\n`);
     return;
   }
-  process.stdout.write(`${json}\n`);
+
+  const headers = `Content-Length: ${Buffer.byteLength(json, 'utf8')}\r\n\r\n`;
+  process.stdout.write(headers);
+  process.stdout.write(json);
 }
 
 function logError(context, error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "html2pptx-local-mcp",
-  "version": "1.1.17",
+  "version": "1.1.19",
   "type": "module",
   "description": "Local stdio MCP server for opening html2pptx slide HTML in the local edit-slide editor.",
   "bin": {

package/scripts/install-mcp.mjs

@@ -1,316 +1,188 @@
 #!/usr/bin/env node
 
 import { spawnSync } from 'node:child_process';
-import { chmodSync, existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { mkdirSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-import process from 'node:process';
-import packageJson from '../package.json' with { type: 'json' };
-
-const VERSION = packageJson.version;
-const PACKAGE_SPEC = 'html2pptx-local-mcp@latest';
-const VERSIONED_PACKAGE_SPEC = `html2pptx-local-mcp@${VERSION}`;
-const PACKAGE_URL = 'https://html2pptx.app/downloads/html2pptx-local-mcp-latest.tgz';
-const VERSIONED_PACKAGE_URL = `https://html2pptx.app/downloads/html2pptx-local-mcp-${VERSION}.tgz`;
-const MANIFEST_URL = 'https://html2pptx.app/downloads/latest.json';
-const REMOTE_MCP_URL = 'https://html2pptx.app/mcp';
-const LOCAL_SERVER_NAME = 'html2pptx-local';
-const REMOTE_SERVER_NAME = 'html2pptx';
-const LAUNCHER_PATH = join(homedir(), '.html2pptx', 'bin', 'html2pptx-local-mcp-launcher.mjs');
-const INSTALL_ROOT = join(homedir(), '.html2pptx', 'local-mcp', VERSION);
-const LOCAL_PACKAGE_ROOT = join(INSTALL_ROOT, 'node_modules', 'html2pptx-local-mcp');
-const LOCAL_SERVER_ENTRY = join(LOCAL_PACKAGE_ROOT, 'mcp', 'pptx-studio-mcp-server.mjs');
-
-if (isMain()) {
-  main();
-}
-
-function main() {
-  const target = process.argv[2] || 'claude';
-
-  if (!['claude'].includes(target)) {
-    fail(`Unsupported target "${target}". Usage: html2pptx-install-mcp claude`);
-  }
-
-  console.log(`Installing html2pptx MCP for ${target}.`);
-  console.log(`Remote server: ${REMOTE_SERVER_NAME} -> ${REMOTE_MCP_URL}`);
-  console.log(`Local server:  ${LOCAL_SERVER_NAME} -> ${PACKAGE_SPEC}`);
-  console.log(`Local launcher: ${LAUNCHER_PATH}`);
-  console.log('');
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
 
-  installClaude();
+const REMOTE_SERVER_NAME = 'html2pptx';
+const LOCAL_SERVER_NAME = 'html2pptx-local';
+const REMOTE_MCP_URL = 'https://html2pptx.app/mcp';
+const LOCAL_PACKAGE_SPEC = process.env.HTML2PPTX_LOCAL_MCP_PACKAGE_SPEC || 'html2pptx-local-mcp@latest';
 
-  console.log('');
-  console.log('html2pptx MCP setup finished.');
-  console.log('Restart Claude Code if it was already running.');
-}
+const args = process.argv.slice(2);
+const dryRun = args.includes('--dry-run');
+const help = args.includes('--help') || args.includes('-h');
+const client = resolveClient(args);
 
-function isMain() {
-  return import.meta.url === new URL(process.argv[1], 'file:').href;
+if (help) {
+  printHelp();
+  process.exit(0);
 }
 
-function installClaude() {
-  runClaudeRemoteAdd();
-  installLocalPackage();
-  writeLocalLauncher();
-  writeClaudeLocalConfig();
+if (!client) {
+  console.error('Unknown MCP client. Use one of: claude, codex.');
+  printHelp();
+  process.exit(1);
 }
 
-function runClaudeRemoteAdd() {
-  const args = [
-    'mcp',
-    'add',
-    '--scope',
-    'user',
-    '--transport',
-    'http',
-    REMOTE_SERVER_NAME,
-    REMOTE_MCP_URL,
-  ];
-  console.log(`> claude ${args.join(' ')}`);
-  const result = spawnSync(commandForPlatform('claude'), args, { encoding: 'utf8' });
-
-  if (result.status === 0) {
-    printOutput(result);
-    return;
-  }
-
-  const combined = `${result.stdout || ''}\n${result.stderr || ''}`;
-  if (/already exists|already registered|duplicate/i.test(combined)) {
-    console.log('claude reported that this MCP server is already registered; continuing.');
-    printOutput(result);
-    return;
-  }
+const steps = buildSteps(client);
 
-  printOutput(result);
-  fail('Failed to register the remote html2pptx MCP server with Claude Code.');
-}
+console.log(`Installing html2pptx MCP for ${client}.`);
+console.log(`Remote server: ${REMOTE_SERVER_NAME} -> ${REMOTE_MCP_URL}`);
+console.log(`Local server:  ${LOCAL_SERVER_NAME} -> npx -y -p ${LOCAL_PACKAGE_SPEC} html2pptx-mcp`);
+console.log('');
 
-function installLocalPackage() {
-  mkdirSync(INSTALL_ROOT, { recursive: true });
-  const args = ['install', '--silent', '--prefix', INSTALL_ROOT, VERSIONED_PACKAGE_SPEC];
-  console.log(`> npm ${args.join(' ')}`);
-  const result = spawnSync(commandForPlatform('npm'), args, { stdio: 'inherit' });
-  if (result.status !== 0) {
-    fail(`Failed to install ${PACKAGE_URL}.`);
-  }
-  if (!existsSync(LOCAL_SERVER_ENTRY)) {
-    fail(`Installed package is missing ${LOCAL_SERVER_ENTRY}.`);
+for (const step of steps) {
+  if (step.kind === 'claude-local-config') {
+    writeClaudeLocalMcpConfig();
+  } else {
+    runStep(step);
   }
 }
 
-function writeClaudeLocalConfig() {
-  const configPath = join(homedir(), '.claude.json');
-  const config = readJsonObject(configPath);
-  config.mcpServers = isPlainObject(config.mcpServers) ? config.mcpServers : {};
-  config.mcpServers[LOCAL_SERVER_NAME] = {
-    type: 'stdio',
-    command: process.execPath,
-    args: [LAUNCHER_PATH],
-    env: {},
-  };
-
-  mkdirSync(dirname(configPath), { recursive: true });
-  writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`);
-  console.log(`Updated ${configPath}`);
-}
+console.log('');
+console.log('html2pptx MCP setup finished.');
 
-function writeLocalLauncher() {
-  mkdirSync(dirname(LAUNCHER_PATH), { recursive: true });
-  writeFileSync(LAUNCHER_PATH, launcherSource(), 'utf8');
-  chmodSync(LAUNCHER_PATH, 0o755);
-  console.log(`Updated ${LAUNCHER_PATH}`);
-}
+function resolveClient(argv) {
+  const clientFlagIndex = argv.findIndex((value) => value === '--client');
+  if (clientFlagIndex !== -1) {
+    return normalizeClient(argv[clientFlagIndex + 1]);
+  }
 
-function readJsonObject(path) {
-  if (!existsSync(path)) return {};
-  const raw = readFileSync(path, 'utf8').trim();
-  if (!raw) return {};
-  try {
-    const parsed = JSON.parse(raw);
-    return isPlainObject(parsed) ? parsed : {};
-  } catch (error) {
-    fail(`Could not parse ${path}: ${error.message}`);
+  const clientEquals = argv.find((value) => value.startsWith('--client='));
+  if (clientEquals) {
+    return normalizeClient(clientEquals.slice('--client='.length));
   }
-}
 
-function isPlainObject(value) {
-  return value !== null && typeof value === 'object' && !Array.isArray(value);
+  const positional = argv.find((value) => !value.startsWith('-'));
+  return normalizeClient(positional || 'claude');
 }
 
-function printOutput(result) {
-  if (result.stdout) process.stdout.write(result.stdout);
-  if (result.stderr) process.stderr.write(result.stderr);
+function normalizeClient(value) {
+  if (value === 'claude' || value === 'claude-code') return 'claude';
+  if (value === 'codex') return 'codex';
+  return null;
 }
 
-function fail(message) {
-  console.error(`error: ${message}`);
-  process.exit(1);
-}
+function buildSteps(targetClient) {
+  if (targetClient === 'claude') {
+    return [
+      {
+        command: 'claude',
+        args: ['mcp', 'add', '--scope', 'user', '--transport', 'http', REMOTE_SERVER_NAME, REMOTE_MCP_URL],
+      },
+      {
+        kind: 'claude-local-config',
+      },
+    ];
+  }
 
-function commandForPlatform(command) {
-  return process.platform === 'win32' ? `${command}.cmd` : command;
+  return [
+    {
+      command: 'codex',
+      args: ['mcp', 'add', REMOTE_SERVER_NAME, '--url', REMOTE_MCP_URL],
+    },
+    {
+      command: 'codex',
+      args: [
+        'mcp',
+        'add',
+        LOCAL_SERVER_NAME,
+        '--',
+        'npx',
+        '-y',
+        '-p',
+        LOCAL_PACKAGE_SPEC,
+        'html2pptx-mcp',
+      ],
+    },
+  ];
 }
 
-function launcherSource() {
-  return `#!/usr/bin/env node
+function writeClaudeLocalMcpConfig() {
+  const configPath = join(process.env.HOME || process.cwd(), '.claude.json');
+  const serverConfig = {
+    type: 'stdio',
+    command: 'npx',
+    args: ['-y', '-p', LOCAL_PACKAGE_SPEC, 'html2pptx-mcp'],
+    env: {},
+  };
 
-import { spawn, spawnSync } from 'node:child_process';
-import { existsSync, readdirSync, readFileSync } from 'node:fs';
-import { mkdirSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import process from 'node:process';
-
-const FALLBACK_VERSION = ${JSON.stringify(VERSION)};
-const FALLBACK_PACKAGE_SPEC = ${JSON.stringify(VERSIONED_PACKAGE_SPEC)};
-const FALLBACK_PACKAGE_URL = ${JSON.stringify(VERSIONED_PACKAGE_URL)};
-const FALLBACK_LATEST_PACKAGE_URL = ${JSON.stringify(PACKAGE_URL)};
-const MANIFEST_URL = process.env.HTML2PPTX_LOCAL_MCP_MANIFEST_URL || ${JSON.stringify(MANIFEST_URL)};
-const INSTALL_BASE = join(homedir(), '.html2pptx', 'local-mcp');
-const PACKAGE_NAME = 'html2pptx-local-mcp';
-
-main().catch((error) => {
-  log('launcher failed: ' + (error?.message || String(error)));
-  process.exit(1);
-});
+  console.log(`> update ${configPath} mcpServers.${LOCAL_SERVER_NAME}`);
 
-async function main() {
-  const manifest = await fetchManifest();
-  const desired = normalizeManifest(manifest) || {
-    version: FALLBACK_VERSION,
-    packageSpec: FALLBACK_PACKAGE_SPEC || FALLBACK_PACKAGE_URL || FALLBACK_LATEST_PACKAGE_URL,
-  };
+  if (dryRun) return;
 
-  let entry = serverEntryForVersion(desired.version);
-  if (!existsSync(entry)) {
-    const installed = installVersion(desired.version, desired.packageSpec);
-    if (installed) {
-      entry = serverEntryForVersion(desired.version);
+  let config = {};
+  if (existsSync(configPath)) {
+    try {
+      config = JSON.parse(readFileSync(configPath, 'utf8'));
+    } catch (error) {
+      console.error(`Failed to parse ${configPath}: ${error.message}`);
+      process.exit(1);
     }
   }
 
-  if (!existsSync(entry)) {
-    entry = findNewestInstalledServer();
+  if (!config || typeof config !== 'object' || Array.isArray(config)) {
+    config = {};
   }
 
-  if (!entry) {
-    throw new Error('No installed html2pptx local MCP server found.');
+  if (!config.mcpServers || typeof config.mcpServers !== 'object' || Array.isArray(config.mcpServers)) {
+    config.mcpServers = {};
   }
 
-  const child = spawn(process.execPath, [entry, ...process.argv.slice(2)], {
-    stdio: 'inherit',
-    env: process.env,
-  });
-
-  child.on('exit', (code, signal) => {
-    if (signal) {
-      process.kill(process.pid, signal);
-      return;
-    }
-    process.exit(code ?? 0);
-  });
+  config.mcpServers[LOCAL_SERVER_NAME] = serverConfig;
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+  console.log(`Registered local MCP server ${LOCAL_SERVER_NAME} in Claude user config.`);
 }
 
-async function fetchManifest() {
-  try {
-    const response = await fetch('https://registry.npmjs.org/' + PACKAGE_NAME + '/latest', {
-      headers: { accept: 'application/json' },
-      signal: AbortSignal.timeout(2500),
-    });
-    if (response.ok) {
-      const payload = await response.json();
-      if (payload && typeof payload.version === 'string' && payload.version.trim()) {
-        return {
-          version: payload.version.trim(),
-          packageSpec: PACKAGE_NAME + '@' + payload.version.trim(),
-        };
-      }
-    }
-  } catch {
-    // Fall back to html2pptx.app manifest.
-  }
+function runStep(step) {
+  const rendered = [step.command, ...step.args].join(' ');
+  console.log(`> ${rendered}`);
 
-  try {
-    const response = await fetch(MANIFEST_URL, {
-      headers: { accept: 'application/json' },
-      signal: AbortSignal.timeout(2500),
-    });
-    if (!response.ok) return null;
-    return await response.json();
-  } catch {
-    return null;
-  }
-}
-
-function normalizeManifest(value) {
-  if (!value || typeof value !== 'object') return null;
-  const version = typeof value.version === 'string' ? value.version.trim() : '';
-  const packageSpec =
-    typeof value.packageSpec === 'string' ? value.packageSpec.trim()
-    : typeof value.packageUrl === 'string' ? value.packageUrl.trim()
-    : typeof value.latestPackageUrl === 'string' ? value.latestPackageUrl.trim()
-    : '';
-  if (!version || !packageSpec) return null;
-  if (
-    !packageSpec.startsWith(PACKAGE_NAME + '@') &&
-    !/^https:\\/\\/html2pptx\\.app\\/downloads\\//.test(packageSpec)
-  ) return null;
-  return { version, packageSpec };
-}
+  if (dryRun) return;
 
-function installVersion(version, packageSpec) {
-  mkdirSync(join(INSTALL_BASE, version), { recursive: true });
-  log('installing html2pptx local MCP ' + version);
-  const result = spawnSync(commandForPlatform('npm'), [
-    'install',
-    '--silent',
-    '--prefix',
-    join(INSTALL_BASE, version),
-    packageSpec,
-  ], {
+  const result = spawnSync(step.command, step.args, {
     encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
   });
-  if (result.stdout) process.stderr.write(result.stdout);
-  if (result.stderr) process.stderr.write(result.stderr);
-  return result.status === 0 && existsSync(serverEntryForVersion(version));
-}
 
-function serverEntryForVersion(version) {
-  return join(INSTALL_BASE, version, 'node_modules', PACKAGE_NAME, 'mcp', 'pptx-studio-mcp-server.mjs');
-}
+  const output = [result.stdout, result.stderr].filter(Boolean).join('\n').trim();
 
-function findNewestInstalledServer() {
-  let versions = [];
-  try {
-    versions = readdirSync(INSTALL_BASE, { withFileTypes: true })
-      .filter((entry) => entry.isDirectory())
-      .map((entry) => entry.name)
-      .filter((version) => existsSync(serverEntryForVersion(version)));
-  } catch {
-    return '';
+  if (result.error?.code === 'ENOENT') {
+    console.error(`Command not found: ${step.command}`);
+    process.exit(1);
   }
-  versions.sort(compareVersions).reverse();
-  return versions.length ? serverEntryForVersion(versions[0]) : '';
-}
 
-function compareVersions(a, b) {
-  const aa = String(a).split('.').map((part) => Number.parseInt(part, 10) || 0);
-  const bb = String(b).split('.').map((part) => Number.parseInt(part, 10) || 0);
-  for (let i = 0; i < Math.max(aa.length, bb.length); i += 1) {
-    const diff = (aa[i] || 0) - (bb[i] || 0);
-    if (diff) return diff;
+  if (result.status !== 0) {
+    if (isAlreadyRegistered(output)) {
+      console.log(`${step.command} reported that this MCP server is already registered; continuing.`);
+      if (output) console.log(output);
+      return;
+    }
+
+    if (output) console.error(output);
+    process.exit(result.status || 1);
   }
-  return String(a).localeCompare(String(b));
-}
 
-function commandForPlatform(command) {
-  return process.platform === 'win32' ? command + '.cmd' : command;
+  if (output) console.log(output);
 }
 
-function log(message) {
-  process.stderr.write('[html2pptx-local-mcp] ' + message + '\\n');
+function isAlreadyRegistered(output) {
+  return /already\s+(exists|registered|configured)|duplicate|server.*exists|同名|既に|すでに/i.test(output || '');
 }
-`;
+
+function printHelp() {
+  console.log(`
+Usage:
+  html2pptx-install-mcp [claude|codex] [--dry-run]
+  html2pptx-install-mcp --client claude
+  html2pptx-install-mcp --client codex
+
+Examples:
+  npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp claude
+  npx -y -p html2pptx-local-mcp@latest html2pptx-install-mcp codex
+
+Optional:
+  HTML2PPTX_LOCAL_MCP_PACKAGE_SPEC=<package-or-tarball> html2pptx-install-mcp claude
+`.trim());
 }