@hubex/mcp 0.6.0 → 0.7.0

package/dist/auth.js

@@ -175,7 +175,12 @@ class RefreshingAuth {
     }
     /**
      * A service-token login never carries a refresh token, so ask for one.
-     * Best-effort: without it we simply re-authenticate when the access token expires.
+     * Best-effort for "service"/"login": credentials were already proven by the
+     * preceding login call, so a failure here just means retrying at expiry.
+     * Fatal for "token": the user-typed token is otherwise never round-tripped
+     * against the server, so this request is the only thing that can catch a
+     * token issued for the wrong environment (dev/stg/prod) — swallowing it
+     * would report success on a token that doesn't actually work.
      */
     async acquireRefreshToken() {
         try {
@@ -186,6 +191,8 @@ class RefreshingAuth {
             this.absorb(result);
         }
         catch (err) {
+            if (this.config.authMode === "token")
+                throw err;
             console.error("[hubex-mcp] could not obtain a refresh token; will re-authenticate on expiry: " +
                 `${err.message}`);
         }
@@ -201,7 +208,13 @@ class RefreshingAuth {
         const res = await fetch(url, init);
         if (!res.ok) {
             const body = await res.text().catch(() => "");
-            throw new Error(`${init.method ?? "GET"} ${url} failed (HTTP ${res.status}): ${body.slice(0, 500)}`);
+            let message = `${init.method ?? "GET"} ${url} failed (HTTP ${res.status}): ${body.slice(0, 500)}`;
+            if (res.status === 401 || res.status === 403) {
+                message +=
+                    ` Сейчас выбрано окружение HUBEX_ENV=${this.config.env}. Если токен получен в другом ` +
+                        `окружении (dev/stg/prod), авторизация не пройдёт — проверь, что токен именно из ${this.config.env}.`;
+            }
+            throw new Error(message);
         }
         return (await res.json());
     }

package/dist/http.js

@@ -3,6 +3,7 @@
  * injects auth + `X-Application-ID`, and normalizes responses and errors.
  */
 import { maskPii } from "./pii/mask.js";
+import { SET_TOKEN_TOOL } from "./token-prompt.js";
 /**
  * Заголовки, которые клиент проставляет сам. Подмена `Authorization` или
  * `X-Application-ID` сменила бы того, от чьего имени идёт запрос, поэтому
@@ -20,15 +21,15 @@ export class HubexApiError extends Error {
     service;
     path;
     payload;
-    constructor(status, service, path, payload) {
-        super(HubexApiError.format(status, service, path, payload));
+    constructor(status, service, path, payload, env) {
+        super(HubexApiError.format(status, service, path, payload, env));
         this.status = status;
         this.service = service;
         this.path = path;
         this.payload = payload;
         this.name = "HubexApiError";
     }
-    static format(status, service, path, payload) {
+    static format(status, service, path, payload, env) {
         let detail = "";
         if (typeof payload === "string") {
             detail = payload;
@@ -41,7 +42,17 @@ export class HubexApiError extends Error {
         else if (payload && typeof payload === "object") {
             detail = JSON.stringify(payload).slice(0, 800);
         }
-        return `HubEx ${service} ${path} -> HTTP ${status}${detail ? `: ${detail}` : ""}`;
+        let message = `HubEx ${service} ${path} -> HTTP ${status}${detail ? `: ${detail}` : ""}`;
+        // 401 здесь чаще всего не «токен протух», а «токен не из этого окружения»:
+        // dev/stg/prod выдают JWT с разными ключами подписи, и токен из другого
+        // контура падает именно так, без более внятной причины от самого HubEx.
+        if (status === 401 && env) {
+            message +=
+                ` Сейчас выбрано окружение HUBEX_ENV=${env}. Если токен был получен в другом окружении ` +
+                    `(dev/stg/prod), авторизация не пройдёт — убедись, что токен именно из ${env}, и при ` +
+                    `необходимости передай новый через ${SET_TOKEN_TOOL}.`;
+        }
+        return message;
     }
 }
 function buildQueryString(query) {
@@ -111,7 +122,7 @@ export class HubexClient {
                 exposed[name] = value;
         }
         if (!res.ok) {
-            throw new HubexApiError(res.status, req.service, req.path, visible ?? text);
+            throw new HubexApiError(res.status, req.service, req.path, visible ?? text, this.config.env);
         }
         return { status: res.status, data: visible, headers: exposed };
     }

package/dist/token-prompt.js

@@ -30,7 +30,9 @@ export function createElicitPrompter(server) {
             },
         });
         if (result.action !== "accept") {
-            throw new Error("Ввод токена отменён — авторизоваться в HubEx не удалось.");
+            throw new Error("Ввод токена отменён — авторизоваться в HubEx не удалось. " +
+                "Если клиент заявляет поддержку elicitation, но не показывает форму ввода " +
+                `(так себя ведёт часть хостов), вызови инструмент ${SET_TOKEN_TOOL} и передай access-токен HubEx напрямую.`);
         }
         const token = result.content?.token;
         if (typeof token !== "string" || token.trim() === "") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubex/mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "MCP server for managing HubEx test data (tasks, assets, companies, users) via the HubEx REST API",
   "author": "HubEx Team",