@nado-language/mcp 0.1.9 → 0.1.10

package/README.md

@@ -136,7 +136,17 @@ export NADO_MCP_AUTH_RELAY_URL='https://language.nado.ai.kr/auth/mcp-callback'
 
 ## Client Registration
 
-Installed package, one-command setup plus browser login:
+Installed package auto-registers the supported local config writers during install/update. It writes Codex Desktop, Claude Desktop, and OpenCode config entries when possible. It does not open browser login during install, and it does not force an already-open AI chat to reload tools.
+
+After install, run browser login once:
+
+```bash
+nado-mcp login
+```
+
+Then fully restart the AI desktop app and start a new chat/session.
+
+Manual one-command setup plus browser login remains available:
 
 ```bash
 nado-mcp connect
@@ -148,6 +158,12 @@ To force every supported local config writer:
 nado-mcp connect all
 ```
 
+To skip install-time auto-registration, install with:
+
+```bash
+NADO_MCP_SKIP_POSTINSTALL=1 npm install --global @nado-language/mcp
+```
+
 Client-specific setup remains available:
 
 ```bash
@@ -161,9 +177,9 @@ For Codex, the command uses the Codex CLI when it is on `PATH`. If the user only
 - macOS/Linux: `~/.codex/config.toml`
 - Windows: `%USERPROFILE%\.codex\config.toml`
 
-Restart Codex Desktop after login completes.
+Restart Codex Desktop after install/login completes.
 If a client was already open, start a new chat/session after restart. Most local MCP clients load tool definitions when the session starts, so a config that was just written may not appear inside an already-running conversation.
-For Codex, confirm the server is active from the chat/TUI with `/mcp`. A server can appear in Settings while still failing to start for the current session.
+For Codex, `/mcp` is an optional diagnostic check to confirm the server is active in the current chat/TUI. Normal users should not need it once install-time registration, login, restart, and new chat have completed. A server can appear in Settings while still failing to start for the current session.
 On Windows, leave the Codex MCP working directory/cwd empty unless it is an existing absolute path. The Nado server does not need a working directory, and a value such as `~/code` can prevent the stdio process from starting if the client does not expand it.
 
 ChatGPT is different: it uses hosted/remote MCP apps configured from ChatGPT Apps settings, not local stdio config files. The local package can prepare local clients such as Codex, Claude Desktop, OpenCode, and generic JSON-based MCP clients.
@@ -269,7 +285,15 @@ npm run mcp:nado:probe -- save-nado-ai "serendipity"
 
 ## Package CLI
 
-Install/register/login flow:
+Install/update auto-registers supported local config writers for Codex Desktop, Claude Desktop, and OpenCode. It does not open browser login during install.
+
+Login flow:
+
+```bash
+nado-mcp login
+```
+
+Manual register/login flow:
 
 ```bash
 nado-mcp connect

package/dist/nado-mcp-cli.mjs

@@ -44,6 +44,8 @@ try {
     await runAuth(['logout', ...args]);
   } else if (command === 'auth') {
     await runAuth(args.length > 0 ? args : ['login']);
+  } else if (command === 'postinstall') {
+    runPostinstallAutoSetup();
   } else if (command === 'probe') {
     await runNode(probePath, args, { stdio: 'inherit' });
   } else if (command === 'setup') {
@@ -155,6 +157,40 @@ function setupAllLocalClients(options = {}, flow = {}) {
   return true;
 }
 
+function runPostinstallAutoSetup() {
+  if (process.env.NADO_MCP_SKIP_POSTINSTALL === '1' || process.env.NADO_MCP_NO_AUTO_SETUP === '1') {
+    console.log('Nado MCP postinstall: skipped automatic client registration.');
+    return;
+  }
+
+  try {
+    console.log('Nado MCP postinstall: registering supported local MCP clients.');
+    const registrations = [
+      ['Codex Desktop', () => setupCodexDesktopConfig({ postinstall: true })],
+      ['Claude Desktop', () => setupClaudeDesktop({}, { postinstall: true })],
+      ['OpenCode', () => setupOpenCode({}, { postinstall: true })],
+    ];
+    let registeredCount = 0;
+    for (const [label, register] of registrations) {
+      try {
+        register();
+        registeredCount += 1;
+      } catch (error) {
+        console.warn(`Nado MCP postinstall warning: ${label} registration failed (${error instanceof Error ? error.message : String(error)}).`);
+      }
+    }
+    printToolProbeSummary();
+    if (registeredCount > 0) {
+      console.log('Nado MCP postinstall: registration complete. Run `nado-mcp login` once, then restart the AI app and start a new chat.');
+    } else {
+      console.warn('Nado MCP postinstall warning: no local client config was registered. Run `nado-mcp setup all` manually, or use `nado-mcp config` for a generic MCP client.');
+    }
+  } catch (error) {
+    console.warn(`Nado MCP postinstall warning: automatic registration failed (${error instanceof Error ? error.message : String(error)}).`);
+    console.warn('Run `nado-mcp setup all` manually, or use `nado-mcp config` for a generic MCP client.');
+  }
+}
+
 function setupCodex(flow = {}) {
   const check = spawnSync('codex', ['--version'], { stdio: 'ignore' });
   if (check.error || check.status !== 0) {
@@ -183,7 +219,8 @@ function setupCodexDesktopConfig(flow = {}, reason = '') {
 
   if (reason) console.log(`${reason} Falling back to Codex Desktop config.`);
   console.log(`Registered Nado Language MCP with Codex Desktop: ${configPath}`);
-  if (flow.loginAfter) console.log('Browser login will open next. Restart Codex Desktop after login completes.');
+  if (flow.postinstall) console.log('Restart Codex Desktop or start a new Codex session before expecting Nado tools to appear.');
+  else if (flow.loginAfter) console.log('Browser login will open next. Restart Codex Desktop after login completes.');
   else console.log('Restart Codex Desktop, then run `nado-mcp login`.');
 }
 
@@ -200,7 +237,8 @@ function setupClaudeDesktop(options = {}, flow = {}) {
 
   writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`);
   console.log(`Registered Nado Language MCP with Claude Desktop: ${configPath}`);
-  if (flow.loginAfter) console.log('Browser login will open next. Restart Claude Desktop after login completes.');
+  if (flow.postinstall) console.log('Restart Claude Desktop before expecting Nado tools to appear.');
+  else if (flow.loginAfter) console.log('Browser login will open next. Restart Claude Desktop after login completes.');
   else console.log('Restart Claude Desktop, then run `nado-mcp login`.');
 }
 
@@ -869,6 +907,7 @@ function codexDesktopConfigPath() {
 }
 
 function claudeDesktopConfigPath() {
+  if (process.env.NADO_MCP_CLAUDE_CONFIG_FILE) return expandHome(process.env.NADO_MCP_CLAUDE_CONFIG_FILE);
   if (process.platform === 'win32') {
     return path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
   }
@@ -912,6 +951,7 @@ function printHelp() {
   console.log(`Nado Language MCP
 
 Usage:
+  nado-mcp login                      Open browser login and save local auth
   nado-mcp connect                    Auto-register detected local MCP clients, then log in
   nado-mcp connect all                Register all supported local config writers, then log in
   nado-mcp connect codex              Register in Codex CLI/Desktop, then log in
@@ -920,7 +960,6 @@ Usage:
   nado-mcp setup <client>             Register without login
   nado-mcp setup mcp-json --file PATH Merge into a generic mcpServers JSON file
   nado-mcp config                     Print generic MCP config snippets
-  nado-mcp login                      Open browser login and save local auth
   nado-mcp status                     Show local auth status
   nado-mcp logout                     Remove local auth tokens
   nado-mcp server                     Start the stdio MCP server
@@ -936,8 +975,9 @@ Universal fallback:
   nado-mcp config
 
 AI-agent friendly flow:
-  1. Install the package
-  2. Run: nado-mcp connect
-  3. If the client is unknown or remote-only, paste the JSON from nado-mcp config
+  1. Install the package; install/update auto-registers Codex Desktop, Claude Desktop, and OpenCode
+  2. Run: nado-mcp login
+  3. Fully restart the AI app and start a new chat/session
+  4. If the client is unknown or remote-only, paste the JSON from nado-mcp config
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nado-language/mcp",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Nado Language MCP server for saving AI-generated English flashcards and practicing saved materials.",
   "type": "module",
   "private": false,
@@ -19,6 +19,7 @@
   },
   "scripts": {
     "prepack": "node ../../scripts/build-nado-mcp-package.mjs",
+    "postinstall": "node dist/nado-mcp-cli.mjs postinstall",
     "test": "node dist/nado-mcp-cli.mjs doctor"
   },
   "keywords": [