huly-mcp-selfhost 3.1.0 → 3.3.0

package/dist/utils/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,MAAM,GAAG,GAAG,qCAAqC,CAAA;AAEjD,uBAA+B,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC/D,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAW,CAAC,CAAA;QAC9D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAW,CAAC,CAAC,CAAC,SAAS,CAAA;QACnF,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,6GAA6G;AAC7G;IACE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,MAAM,GAAG,GAAG,CAAC,GAAG,IAAe,EAAQ,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAA,CAAC,CAAC,CAAA;IAC/E,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,GAAG,CAAA;AACjF,CAAC"}

package/dist/utils/spec.d.ts

@@ -0,0 +1,10 @@
+export interface SpecTask {
+    title: string;
+    description?: string;
+}
+export interface SpecPlan {
+    source: 'checklist' | 'headings' | 'none';
+    tasks: SpecTask[];
+    skippedDone: number;
+}
+export declare function planFromMarkup(root: any): SpecPlan;

package/dist/utils/spec.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planFromMarkup = planFromMarkup;
+// Spec → issues: turn a document's structure into planned issues without an LLM round trip.
+// Open checklist items become issues; without a checklist, the sections (lowest heading level
+// that occurs more than once, else level 2/1) become issues with their text as description.
+const markdown_1 = require("./markdown");
+const CHECK = /^\s*\[( |x|X)\]\s+/;
+function childrenOf(node) {
+    return Array.isArray(node?.content) ? node.content : [];
+}
+/** Open checklist items: Huly todo/task nodes, or "[ ] text" list items from Markdown imports. */
+function checklist(root) {
+    const open = [];
+    let done = 0;
+    const walk = (node) => {
+        const type = String(node?.type ?? '');
+        if (type === 'todoItem' || type === 'taskItem') {
+            const [first, ...rest] = childrenOf(node);
+            const title = (0, markdown_1.extractText)(first ?? node).trim();
+            const nested = rest.map(markdown_1.extractText).join('\n').trim();
+            if (node.attrs?.checked === true)
+                done++;
+            else if (title !== '')
+                open.push({ title, description: nested !== '' ? nested : undefined });
+            return;
+        }
+        if (type === 'listItem') {
+            const [first, ...rest] = childrenOf(node);
+            const text = (0, markdown_1.extractText)(first ?? node).trim();
+            const m = CHECK.exec(text);
+            if (m != null) {
+                const nested = rest.map(markdown_1.extractText).join('\n').trim();
+                if (m[1] !== ' ')
+                    done++;
+                else
+                    open.push({ title: text.replace(CHECK, '').trim(), description: nested !== '' ? nested : undefined });
+                return;
+            }
+        }
+        for (const c of childrenOf(node))
+            walk(c);
+    };
+    walk(root);
+    return { open, done };
+}
+function headings(root) {
+    const blocks = childrenOf(root);
+    const levels = blocks.filter((b) => b?.type === 'heading').map((b) => Number(b.attrs?.level ?? 1));
+    if (levels.length === 0)
+        return [];
+    const count = (l) => levels.filter((x) => x === l).length;
+    // Sections are the most common heading level among 2/3; a single H1 is usually the title.
+    const level = [2, 3, 1].find((l) => count(l) > 1) ?? [2, 3, 1].find((l) => count(l) > 0) ?? levels[0];
+    const tasks = [];
+    let current;
+    const flush = () => {
+        if (current == null)
+            return;
+        const body = current.body.join('\n').trim();
+        tasks.push({ title: current.title, description: body !== '' ? body.slice(0, 2000) : undefined });
+    };
+    for (const b of blocks) {
+        if (b?.type === 'heading') {
+            const l = Number(b.attrs?.level ?? 1);
+            if (l === level) {
+                flush();
+                current = { title: (0, markdown_1.extractText)(b).trim(), body: [] };
+                continue;
+            }
+            if (l < level) {
+                flush();
+                current = undefined;
+                continue;
+            }
+        }
+        if (current != null)
+            current.body.push((0, markdown_1.extractText)(b));
+    }
+    flush();
+    return tasks.filter((t) => t.title !== '');
+}
+function planFromMarkup(root) {
+    const list = checklist(root);
+    if (list.open.length > 0 || list.done > 0)
+        return { source: 'checklist', tasks: list.open, skippedDone: list.done };
+    const secs = headings(root);
+    return { source: secs.length > 0 ? 'headings' : 'none', tasks: secs, skippedDone: 0 };
+}
+//# sourceMappingURL=spec.js.map

package/dist/utils/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/utils/spec.ts"],"names":[],"mappings":"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"}

package/dist/utils/storage.js

@@ -24,6 +24,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.uploadMarkupBlob = uploadMarkupBlob;
 exports.uploadBlob = uploadBlob;
 exports.deleteBlob = deleteBlob;
+/** Uploads can be large files; without a limit a stalled connection hangs the tool call. */
+const UPLOAD_TIMEOUT_MS = 120_000;
 const CLOUD_DATALAKE_URL = 'https://dl-eu.huly.app';
 async function uploadMarkupBlob(wsToken, workspaceUuid, blobId, content) {
     const result = await uploadBlob(wsToken, workspaceUuid, blobId, new Blob([content], { type: 'application/json' }));
@@ -43,7 +45,8 @@ async function uploadViaSelfHostedFront(frontUrl, wsToken, blobId, blob) {
     const uploadRes = await fetch(uploadUrl, {
         method: 'POST',
         headers: { Authorization: `Bearer ${wsToken}` },
-        body: form
+        body: form,
+        signal: AbortSignal.timeout(UPLOAD_TIMEOUT_MS)
     });
     if (!uploadRes.ok) {
         const body = await uploadRes.text().catch(() => '');
@@ -63,7 +66,8 @@ async function uploadViaCloudDatalake(workspaceUuid, wsToken, blobId, blob) {
     const uploadRes = await fetch(uploadUrl, {
         method: 'POST',
         headers: { Authorization: `Bearer ${wsToken}` },
-        body: form
+        body: form,
+        signal: AbortSignal.timeout(UPLOAD_TIMEOUT_MS)
     });
     if (!uploadRes.ok) {
         const body = await uploadRes.text().catch(() => '');
@@ -77,6 +81,6 @@ async function deleteBlob(wsToken, workspaceUuid, blobId) {
     const url = frontUrl != null && frontUrl !== ''
         ? `${frontUrl.replace(/\/$/, '')}/files?file=${encodeURIComponent(blobId)}`
         : `${CLOUD_DATALAKE_URL}/blob/${encodeURIComponent(workspaceUuid)}/${encodeURIComponent(blobId)}`;
-    await fetch(url, { method: 'DELETE', headers: { Authorization: `Bearer ${wsToken}` } }).catch(() => { });
+    await fetch(url, { method: 'DELETE', headers: { Authorization: `Bearer ${wsToken}` }, signal: AbortSignal.timeout(30_000) }).catch(() => { });
 }
 //# sourceMappingURL=storage.js.map

package/dist/utils/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":";AAAA,uEAAuE;AACvE,qDAAqD;AACrD,EAAE;AACF,2DAA2D;AAC3D,qEAAqE;AACrE,gFAAgF;AAChF,yEAAyE;AACzE,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,kEAAkE;AAClE,8DAA8D;AAC9D,iFAAiF;AACjF,iCAAiC;AACjC,4CAA4C;AAC5C,mEAAmE;AACnE,EAAE;AACF,uEAAuE;AACvE,0EAA0E;AAC1E,sEAAsE;AACtE,iEAAiE;;;;;AAEjE,4FAA4F;AAC5F,MAAM,iBAAiB,GAAG,OAAO,CAAA;AAEjC,MAAM,kBAAkB,GAAG,wBAAwB,CAAA;AAO5C,KAAK,2BACV,OAAe,EACf,aAAqB,EACrB,MAAc,EACd,OAAe;IAEf,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,OAAO,EACP,aAAa,EACb,MAAM,EACN,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAClD,CAAA;IACD,OAAO,MAAM,CAAC,EAAE,CAAA;AAClB,CAAC;AAEM,KAAK,qBACV,OAAe,EACf,aAAqB,EACrB,MAAc,EACd,IAAU;IAEV,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;IAE3C,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QACxC,OAAO,MAAM,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;IACxE,CAAC;IACD,OAAO,MAAM,sBAAsB,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;AAC3E,CAAC;AAED,KAAK,UAAU,wBAAwB,CACrC,QAAgB,EAChB,OAAe,EACf,MAAc,EACd,IAAU;IAEV,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;IAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IAEjC,MAAM,SAAS,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAA;IACxD,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;QACvC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,EAAE,EAAE;QAC/C,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,iBAAiB,CAAC;KAC/C,CAAC,CAAA;IAEF,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QACnD,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,CAAC,MAAM,QAAQ,SAAS,KAAK,IAAI,EAAE,CAAC,CAAA;IAClG,CAAC;IAED,MAAM,UAAU,GAAqE,MAAM,SAAS,CAAC,IAAI,EAAE,CAAA;IAC3G,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IACpC,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,oDAAoD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;IACnG,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAA;AAC7E,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,aAAqB,EACrB,OAAe,EACf,MAAc,EACd,IAAU;IAEV,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;IAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IAEjC,MAAM,SAAS,GAAG,GAAG,kBAAkB,qBAAqB,aAAa,EAAE,CAAA;IAC3E,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;QACvC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,EAAE,EAAE;QAC/C,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,iBAAiB,CAAC;KAC/C,CAAC,CAAA;IAEF,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QACnD,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAA;IAC1E,CAAC;IAED,MAAM,UAAU,GAAqE,MAAM,SAAS,CAAC,IAAI,EAAE,CAAA;IAC3G,OAAO,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAA;AAC9F,CAAC;AAEM,KAAK,qBAAsB,OAAe,EAAE,aAAqB,EAAE,MAAc;IACtF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;IAC3C,MAAM,GAAG,GAAG,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,EAAE;QAC7C,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,kBAAkB,CAAC,MAAM,CAAC,EAAE;QAC3E,CAAC,CAAC,GAAG,kBAAkB,SAAS,kBAAkB,CAAC,aAAa,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAA;IAEnG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;AAC9I,CAAC"}

package/package.json

@@ -1,26 +1,31 @@
 {
   "name": "huly-mcp-selfhost",
-  "version": "3.1.0",
-  "description": "MCP server for Huly (self-hosted + cloud) — connect Claude Desktop to your Huly workspace via the native WebSocket SDK. Fork of huly-mcp-sdk with self-hosted document/description support, chat, attachments, custom issue statuses, and organizations.",
+  "version": "3.3.0",
+  "description": "MCP server for Huly (self-hosted and Huly Cloud): 224 tools for Claude and other AI agents — issues, epics, documents, chat, planner, test management — with toolsets for low token use, an agent workflow and a Claude Code plugin.",
   "keywords": [
     "huly",
+    "huly-selfhost",
     "mcp",
+    "mcp-server",
     "model-context-protocol",
     "claude",
+    "claude-code",
+    "claude-desktop",
+    "ai-agents",
     "project-management",
     "issue-tracker",
-    "anthropic"
+    "self-hosted"
   ],
-  "homepage": "https://github.com/JoKeks2023/huly-mcp#readme",
+  "homepage": "https://jokeks2023.github.io/huly-mcp/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/JoKeks2023/huly-mcp.git"
   },
   "mcpName": "io.github.jokeks2023/huly-mcp-selfhost",
   "license": "EPL-2.0",
-  "author": "SaiVaraprasad Medapati",
+  "author": "Joris Conrad (https://github.com/JoKeks2023)",
   "contributors": [
-    "Joris Conrad (self-hosted fork: https://github.com/JoKeks2023/huly-mcp)"
+    "SaiVaraprasad Medapati (original huly-mcp-sdk: https://github.com/varaprasadreddy9676/huly-mcp)"
   ],
   "bin": {
     "huly-mcp": "dist/index.js",
@@ -31,13 +36,14 @@
     "dist/",
     "scripts/",
     ".env.example",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=20"
   },
   "scripts": {
-    "build": "node --max-old-space-size=4096 node_modules/typescript/bin/tsc",
+    "build": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\" && node --max-old-space-size=4096 node_modules/typescript/bin/tsc && node scripts/copy-guides.js",
     "dev": "tsx watch src/index.ts",
     "start": "node dist/index.js",
     "setup": "node scripts/setup.js",
@@ -70,5 +76,8 @@
   "overrides": {
     "dompurify": "^3.4.17",
     "uuid": "^11.1.1"
+  },
+  "bugs": {
+    "url": "https://github.com/JoKeks2023/huly-mcp/issues"
   }
 }

package/scripts/copy-guides.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+// Build step: the plugin skill files are the one source for the agent guides. They are copied to
+// dist/guides/ (without the skill frontmatter) so every MCP client can read them as huly://guide/*.
+'use strict'
+const fs = require('fs')
+const path = require('path')
+
+const root = path.join(__dirname, '..')
+const src = path.join(root, 'plugin', 'skills', 'huly')
+const out = path.join(root, 'dist', 'guides')
+const GUIDES = { workflow: 'SKILL.md', costs: 'costs.md', onboarding: 'onboarding.md', features: 'features.md' }
+
+fs.mkdirSync(out, { recursive: true })
+for (const [name, file] of Object.entries(GUIDES)) {
+  const text = fs.readFileSync(path.join(src, file), 'utf8').replace(/\r\n/g, '\n').replace(/^---\n[\s\S]*?\n---\n+/, '')
+  fs.writeFileSync(path.join(out, `${name}.md`), text)
+}
+console.log(`guides: ${Object.keys(GUIDES).length} copied to dist/guides`)

package/scripts/setup.js

@@ -1,18 +1,17 @@
 #!/usr/bin/env node
 /**
- * One-time setup: authenticate via OTP and save your token to .env
+ * One-time setup for SSO accounts (Google/GitHub): log in with a one-time code and get a token.
  *
  * Usage:
- *   node scripts/setup.js
+ *   npx huly-mcp-selfhost setup              (anywhere — prints the token to paste into your client)
+ *   npm run setup                            (in a checkout of this repo — also saves it to .env)
+ *   ... setup --url https://huly.example.com (self-hosted; or set HULY_ACCOUNTS_URL)
  *
  * What it does:
- *   1. Sends a one-time code to your email
- *   2. You paste the code
+ *   1. Asks for your Huly address (empty = Huly Cloud) unless HULY_ACCOUNTS_URL / --url is given
+ *   2. Sends a one-time code to your email; you paste the code
  *   3. Lists the workspaces your account can access (discovery test)
- *   4. Saves HULY_TOKEN to .env
- *
- * No workspace is configured: the MCP server discovers all workspaces of the
- * account at runtime and every tool takes a `workspace` argument.
+ *   4. In a repo checkout: saves HULY_TOKEN to .env. Otherwise: prints what to put where.
  */
 
 'use strict'
@@ -23,18 +22,47 @@ const readline = require('readline')
 
 const { getClient } = require('@hcengineering/account-client')
 
-const envFile = path.join(__dirname, '..', '.env')
-const accountsUrl = process.env.HULY_ACCOUNTS_URL ?? 'https://account.huly.app'
+const CLOUD_ACCOUNTS = 'https://account.huly.app'
+const root = path.join(__dirname, '..')
+const envFile = path.join(root, '.env')
+// Started via npx the package sits in the npm cache: a .env there would be lost and never read.
+const isCheckout = fs.existsSync(path.join(root, '.git'))
 
+// One interface for the whole run: a new one per question would drop lines already buffered (piped input).
+let rl
+const lines = []
+const waiting = []
 function ask (question) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
-  return new Promise(resolve => rl.question(question, ans => { rl.close(); resolve(ans.trim()) }))
+  if (rl == null) {
+    rl = readline.createInterface({ input: process.stdin })
+    rl.on('line', line => { const next = waiting.shift(); if (next != null) next(line.trim()); else lines.push(line.trim()) })
+    rl.on('close', () => { while (waiting.length > 0) waiting.shift()('') })
+  }
+  process.stdout.write(question)
+  if (lines.length > 0) return Promise.resolve(lines.shift())
+  return new Promise(resolve => waiting.push(resolve))
 }
 
-function writeEnv (token, accountsUrl) {
+/** "https://huly.example.com", ".../_accounts" or empty (cloud) → { accounts, front } */
+function resolveUrls (input) {
+  const value = (input ?? '').trim().replace(/\/+$/, '')
+  if (value === '' || /(^|\/\/)(app\.)?huly\.app$/.test(value) || value === CLOUD_ACCOUNTS) return { accounts: CLOUD_ACCOUNTS, front: undefined }
+  if (!/^https?:\/\//.test(value)) throw new Error(`Not a URL: ${value} (expected e.g. https://huly.example.com)`)
+  if (value.endsWith('/_accounts')) return { accounts: value, front: value.slice(0, -'/_accounts'.length) }
+  return { accounts: `${value}/_accounts`, front: value }
+}
+
+function urlArg (argv) {
+  const i = argv.indexOf('--url')
+  if (i >= 0) return argv[i + 1] ?? ''
+  const eq = argv.find(a => a.startsWith('--url='))
+  return eq != null ? eq.slice('--url='.length) : undefined
+}
+
+function writeEnv (token, urls) {
   const lines = [
     `HULY_TOKEN=${token}`,
-    accountsUrl !== 'https://account.huly.app' ? `HULY_ACCOUNTS_URL=${accountsUrl}` : null
+    urls.accounts !== CLOUD_ACCOUNTS ? `HULY_ACCOUNTS_URL=${urls.accounts}` : null
   ].filter(Boolean)
 
   // Merge with existing .env (don't overwrite unrelated vars)
@@ -51,17 +79,38 @@ function writeEnv (token, accountsUrl) {
   })
 
   fs.writeFileSync(envFile, [...keep.filter(Boolean), ...lines].join('\n') + '\n')
+  return /^HULY_WORKSPACE=/m.test(existing)
+}
+
+function printConfig (token, urls) {
+  console.log('\n  Put these values into your MCP client:')
+  console.log('     Claude Code plugin: /plugin → huly → configure (fields "Huly token", "Accounts URL", "Front URL")')
+  console.log('     Other clients: the "env" block of the huly server\n')
+  console.log(`     HULY_TOKEN=${token}`)
+  if (urls.accounts !== CLOUD_ACCOUNTS) {
+    console.log(`     HULY_ACCOUNTS_URL=${urls.accounts}`)
+    console.log(`     HULY_FRONT_URL=${urls.front}`)
+  }
+  console.log('\n  Keep the token secret — it logs in as you.')
 }
 
 async function main () {
   console.log('\n🔧  Huly MCP Setup\n')
 
-  const email = await ask('  Email address (the one you use for huly.app): ')
+  const fromEnv = (process.env.HULY_ACCOUNTS_URL ?? '').trim()
+  const given = urlArg(process.argv.slice(2)) ?? (fromEnv !== '' ? fromEnv : undefined)
+  const urls = resolveUrls(given ?? await ask('  Huly address (empty = Huly Cloud, e.g. https://huly.example.com): '))
+  if (urls.accounts !== CLOUD_ACCOUNTS) console.log(`  Accounts service: ${urls.accounts}`)
+
+  const email = await ask('  Email address of your Huly account: ')
   if (!email.includes('@')) { console.error('Invalid email.'); process.exit(1) }
 
-  console.log(`\n  Sending OTP to ${email}...`)
-  const unauthClient = getClient(accountsUrl)
-  await unauthClient.loginOtp(email)
+  console.log(`\n  Sending a one-time code to ${email}...`)
+  const unauthClient = getClient(urls.accounts)
+  await unauthClient.loginOtp(email).catch(e => {
+    const cause = e.cause?.code ?? e.message
+    throw new Error(`Could not reach the Huly accounts service at ${urls.accounts} (${cause}). Check the address — self-hosted: your Huly URL, e.g. https://huly.example.com`)
+  })
   console.log('  ✅ Code sent!\n')
 
   const code = await ask('  Enter the 6-digit code from your email: ')
@@ -75,7 +124,7 @@ async function main () {
   }
 
   // Discovery test: which workspaces can this account use?
-  const authedClient = getClient(accountsUrl, loginInfo.token)
+  const authedClient = getClient(urls.accounts, loginInfo.token)
   const workspaces = await authedClient.getUserWorkspaces().catch(e => {
     console.error(`  ❌ Workspace discovery failed: ${e.message}`)
     process.exit(1)
@@ -86,22 +135,29 @@ async function main () {
     process.exit(1)
   }
 
-  const hadWorkspace = fs.existsSync(envFile) && /^HULY_WORKSPACE=/m.test(fs.readFileSync(envFile, 'utf8'))
-  writeEnv(loginInfo.token, accountsUrl)
-
-  console.log(`\n  ✅ Setup complete! Token saved to .env`)
-  console.log(`\n  Workspaces available to this account (${workspaces.length}):`)
+  console.log(`\n  ✅ Logged in. Workspaces available to this account (${workspaces.length}):`)
   for (const ws of workspaces) {
-    console.log(`     - ${ws.name ?? ws.url}  (slug: ${ws.url}, id: ${ws.uuid})${ws.isDisabled ? '  [disabled]' : ''}`)
+    console.log(`     - ${ws.name ?? ws.url}  (slug: ${ws.url})${ws.isDisabled ? '  [disabled]' : ''}`)
   }
-  if (hadWorkspace) {
-    console.log('\n  ℹ️  Removed HULY_WORKSPACE from .env — the server now uses all workspaces above.')
-    console.log('     Re-add it only if you want to restrict this server to a single workspace.')
+
+  if (isCheckout) {
+    const hadWorkspace = writeEnv(loginInfo.token, urls)
+    console.log('\n  Token saved to .env')
+    if (hadWorkspace) {
+      console.log('  ℹ️  Removed HULY_WORKSPACE from .env — the server now uses all workspaces above.')
+      console.log('     Re-add it only if you want to restrict this server to a single workspace.')
+    }
+  } else {
+    printConfig(loginInfo.token, urls)
   }
-  console.log('\n  In your MCP client, pass the slug as `workspace`, e.g. list_projects(workspace="' + workspaces[0].url + '").\n')
+  console.log('\n  Optional: pin one workspace with HULY_WORKSPACE (a slug above) — fewer tokens per session.\n')
 }
 
-main().catch(err => {
-  console.error('\n❌ Setup failed:', err.message)
-  process.exit(1)
-})
+module.exports = { resolveUrls, urlArg }
+
+if (require.main === module || process.env.HULY_SETUP_RUN === '1') {
+  main().then(() => rl?.close()).catch(err => {
+    console.error('\n❌ Setup failed:', err.message)
+    process.exit(1)
+  })
+}