@nado-language/mcp 0.1.7 → 0.1.8

package/README.md

@@ -163,6 +163,8 @@ For Codex, the command uses the Codex CLI when it is on `PATH`. If the user only
 
 Restart Codex Desktop after 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.
+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.
 

package/dist/nado-mcp-cli.mjs

@@ -30,7 +30,7 @@ const command = process.argv[2] || 'help';
 const args = process.argv.slice(3);
 
 try {
-  if (command === 'help' || command === '--help' || command === '-h') {
+  if (shouldPrintHelp(command, args)) {
     printHelp();
   } else if (command === 'version' || command === '--version' || command === '-v') {
     console.log(packageVersion);
@@ -260,10 +260,12 @@ async function doctor() {
   console.log('A green local server check only proves the stdio server can list tools; it does not prove an already-open chat loaded them.');
   console.log('');
   console.log('If the server check is ok but Nado tools are not visible in the AI app:');
-  console.log('  1. Fully quit and restart the desktop app after `nado-mcp connect`.');
-  console.log('  2. Start a new chat/session; existing sessions may not reload newly added MCP tools.');
-  console.log('  3. Run `nado-mcp status` for auth and `nado-mcp probe list` for local server tools.');
-  console.log('  4. If a chat tries local files or Google Drive for "나두/Nado 암기장", that chat did not load the Nado MCP tools.');
+  console.log('  1. In Codex, run `/mcp` in the chat/TUI and confirm nado-language is active, not only listed in Settings.');
+  console.log('  2. Fully quit and restart the desktop app after `nado-mcp connect`.');
+  console.log('  3. Start a new chat/session; existing sessions may not reload newly added MCP tools.');
+  console.log('  4. On Windows, remove Working directory/cwd unless it is an existing absolute path. The Nado server does not need cwd.');
+  console.log('  5. Run `nado-mcp status` for auth and `nado-mcp probe list` for local server tools.');
+  console.log('  6. If a chat tries local files or Google Drive for "나두/Nado 암기장", that chat did not load the Nado MCP tools.');
 }
 
 function printToolProbeSummary() {
@@ -536,6 +538,11 @@ function commandExists(commandName) {
   return !result.error && result.status === 0;
 }
 
+function shouldPrintHelp(currentCommand, currentArgs) {
+  if (currentCommand === 'help' || currentCommand === '--help' || currentCommand === '-h') return true;
+  return currentArgs.includes('--help') || currentArgs.includes('-h');
+}
+
 function codexDesktopTomlSection() {
   const spec = stdioServerSpec();
   return [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nado-language/mcp",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Nado Language MCP server for saving AI-generated English flashcards and practicing saved materials.",
   "type": "module",
   "private": false,