dominds 1.19.2 → 1.19.3

package/dist/tools/env.js

@@ -13,47 +13,20 @@ const log_1 = require("../log");
 const tool_1 = require("../tool");
 const log = (0, log_1.createLogger)('tools/env');
 const ENV_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
-const DEFAULT_ALLOWED_PREFIXES = ['MCP_', 'UX_', 'DOMINDS_TEST_'];
-const DEFAULT_ALLOWED_EXACT = ['DOMINDS_LOG_LEVEL'];
-function isAllowedEnvKey(key) {
-    if (!ENV_KEY_RE.test(key))
-        return false;
-    if (DEFAULT_ALLOWED_EXACT.includes(key))
-        return true;
-    for (const p of DEFAULT_ALLOWED_PREFIXES) {
-        if (key.startsWith(p))
-            return true;
-    }
-    return false;
-}
-function isSensitiveKeyName(key) {
-    const upper = key.toUpperCase();
-    return (upper.includes('KEY') ||
-        upper.includes('TOKEN') ||
-        upper.includes('SECRET') ||
-        upper.includes('PASSWORD'));
-}
-function redactValue(value) {
-    if (value.length <= 4)
-        return '<redacted>';
-    return `<redacted len=${value.length} prefix=${JSON.stringify(value.slice(0, 2))} suffix=${JSON.stringify(value.slice(-2))}>`;
-}
 function parseEnvGetArgs(args) {
     const key = args.key;
     if (typeof key !== 'string' || !key.trim()) {
         throw new Error(`env_get.key must be a non-empty string`);
     }
-    const revealVal = args.reveal;
-    if (revealVal !== undefined && typeof revealVal !== 'boolean') {
-        throw new Error(`env_get.reveal must be a boolean if provided`);
-    }
-    return { key, reveal: revealVal };
+    assertValidEnvKey('env_get', key);
+    return { key };
 }
 function parseEnvSetArgs(args) {
     const key = args.key;
     if (typeof key !== 'string' || !key.trim()) {
         throw new Error(`env_set.key must be a non-empty string`);
     }
+    assertValidEnvKey('env_set', key);
     const value = args.value;
     if (typeof value !== 'string') {
         throw new Error(`env_set.value must be a string`);
@@ -65,16 +38,13 @@ function parseEnvUnsetArgs(args) {
     if (typeof key !== 'string' || !key.trim()) {
         throw new Error(`env_unset.key must be a non-empty string`);
     }
+    assertValidEnvKey('env_unset', key);
     return { key };
 }
 const envGetSchema = {
     type: 'object',
     properties: {
         key: { type: 'string', description: 'Environment variable name to read' },
-        reveal: {
-            type: 'boolean',
-            description: 'When true, returns the raw value. For keys that look like secrets, default is redacted unless reveal=true.',
-        },
     },
     required: ['key'],
     additionalProperties: false,
@@ -96,12 +66,9 @@ const envUnsetSchema = {
     required: ['key'],
     additionalProperties: false,
 };
-function assertAllowedKey(key) {
-    if (!isAllowedEnvKey(key)) {
-        throw new Error(`env key '${key}' is not allowed. Allowed: ${[
-            ...DEFAULT_ALLOWED_EXACT,
-            ...DEFAULT_ALLOWED_PREFIXES.map((p) => `${p}*`),
-        ].join(', ')}`);
+function assertValidEnvKey(toolName, key) {
+    if (!ENV_KEY_RE.test(key)) {
+        throw new Error(`${toolName}.key must be a valid environment variable name matching ${ENV_KEY_RE.source}`);
     }
 }
 exports.envGetTool = {
@@ -116,7 +83,6 @@ exports.envGetTool = {
     argsValidation: 'dominds',
     call: async (_dlg, caller, args) => {
         const parsed = parseEnvGetArgs(args);
-        assertAllowedKey(parsed.key);
         const raw = process.env[parsed.key];
         const value = raw === undefined ? undefined : String(raw);
         log.debug('env_get', undefined, {
@@ -126,10 +92,6 @@ exports.envGetTool = {
         });
         if (value === undefined)
             return (0, tool_1.toolSuccess)('(unset)');
-        if (parsed.reveal === true)
-            return (0, tool_1.toolSuccess)(value);
-        if (isSensitiveKeyName(parsed.key))
-            return (0, tool_1.toolSuccess)(redactValue(value));
         return (0, tool_1.toolSuccess)(value);
     },
 };
@@ -145,7 +107,6 @@ exports.envSetTool = {
     argsValidation: 'dominds',
     call: async (_dlg, caller, args) => {
         const parsed = parseEnvSetArgs(args);
-        assertAllowedKey(parsed.key);
         const prev = process.env[parsed.key];
         process.env[parsed.key] = parsed.value;
         log.warn('env_set', undefined, {
@@ -154,12 +115,8 @@ exports.envSetTool = {
             prevSet: prev !== undefined,
             nextLen: parsed.value.length,
         });
-        const prevStr = prev === undefined
-            ? '(unset)'
-            : isSensitiveKeyName(parsed.key)
-                ? redactValue(String(prev))
-                : String(prev);
-        const nextStr = isSensitiveKeyName(parsed.key) ? redactValue(parsed.value) : parsed.value;
+        const prevStr = prev === undefined ? '(unset)' : String(prev);
+        const nextStr = parsed.value;
         return (0, tool_1.toolSuccess)(`ok: ${parsed.key}\nprev: ${prevStr}\nnext: ${nextStr}`);
     },
 };
@@ -175,7 +132,6 @@ exports.envUnsetTool = {
     argsValidation: 'dominds',
     call: async (_dlg, caller, args) => {
         const parsed = parseEnvUnsetArgs(args);
-        assertAllowedKey(parsed.key);
         const prev = process.env[parsed.key];
         delete process.env[parsed.key];
         log.warn('env_unset', undefined, {
@@ -183,11 +139,7 @@ exports.envUnsetTool = {
             key: parsed.key,
             prevSet: prev !== undefined,
         });
-        const prevStr = prev === undefined
-            ? '(unset)'
-            : isSensitiveKeyName(parsed.key)
-                ? redactValue(String(prev))
-                : String(prev);
+        const prevStr = prev === undefined ? '(unset)' : String(prev);
         return (0, tool_1.toolSuccess)(`ok: ${parsed.key}\nprev: ${prevStr}\nnext: (unset)`);
     },
 };

package/dist/tools/manual/render.js

@@ -84,6 +84,10 @@ function renderToolsetManual(input) {
         }
     }
     const sections = [];
+    const notice = meta.manualNoticeI18n?.[input.language]?.trim();
+    if (notice) {
+        sections.push(notice);
+    }
     if (missingTopics.length > 0) {
         sections.push(renderMissingTopicsWarning(input.language, input.toolsetId, missingTopics));
     }

package/dist/tools/mcp.d.ts

@@ -6,4 +6,5 @@
 import type { FuncTool, ReminderOwner } from '../tool';
 export declare const mcpRestartTool: FuncTool;
 export declare const mcpReleaseTool: FuncTool;
+export declare const mcpDisableTool: FuncTool;
 export declare const mcpLeaseReminderOwner: ReminderOwner;

package/dist/tools/mcp.js

@@ -5,7 +5,7 @@
  * Local MCP supervisor control tools for testing and operations.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mcpLeaseReminderOwner = exports.mcpReleaseTool = exports.mcpRestartTool = void 0;
+exports.mcpLeaseReminderOwner = exports.mcpDisableTool = exports.mcpReleaseTool = exports.mcpRestartTool = void 0;
 const log_1 = require("../log");
 const supervisor_1 = require("../mcp/supervisor");
 const driver_messages_1 = require("../runtime/driver-messages");
@@ -27,6 +27,13 @@ function parseMcpReleaseArgs(args) {
     }
     return { serverId };
 }
+function parseMcpDisableArgs(args) {
+    const serverId = args.serverId;
+    if (typeof serverId !== 'string' || !serverId.trim()) {
+        throw new Error(`mcp_disable.serverId must be a non-empty string`);
+    }
+    return { serverId };
+}
 function isMcpLeaseReminderMeta(value) {
     if (!isRecord(value) || Array.isArray(value))
         return false;
@@ -39,7 +46,7 @@ const mcpRestartSchema = {
     properties: {
         serverId: {
             type: 'string',
-            description: "MCP server id from `.minds/mcp.yaml` (e.g., 'sdk_stdio'). Restarts this server only.",
+            description: "MCP server id from `.minds/mcp.yaml` (e.g., 'sdk_stdio'). Enables the server if needed, then restarts this server only.",
         },
     },
     required: ['serverId'],
@@ -56,13 +63,24 @@ const mcpReleaseSchema = {
     required: ['serverId'],
     additionalProperties: false,
 };
+const mcpDisableSchema = {
+    type: 'object',
+    properties: {
+        serverId: {
+            type: 'string',
+            description: "MCP server id from `.minds/mcp.yaml` (e.g., 'playwright'). Stops any loaded runtime/leases and writes servers.<id>.enabled=false.",
+        },
+    },
+    required: ['serverId'],
+    additionalProperties: false,
+};
 exports.mcpRestartTool = {
     type: 'func',
     name: 'mcp_restart',
-    description: 'Restart a configured MCP server using the current `.minds/mcp.yaml` config (best-effort).',
+    description: 'Enable a configured MCP server if needed, then restart it using the current `.minds/mcp.yaml` config.',
     descriptionI18n: {
-        en: 'Restart a configured MCP server using the current `.minds/mcp.yaml` config (best-effort).',
-        zh: '使用当前的 `.minds/mcp.yaml` 配置重启指定的 MCP 服务器（尽力而为）。',
+        en: 'Enable a configured MCP server if needed, then restart it using the current `.minds/mcp.yaml` config.',
+        zh: '按需启用指定 MCP 服务器，然后使用当前 `.minds/mcp.yaml` 配置重启它。',
     },
     parameters: mcpRestartSchema,
     argsValidation: 'dominds',
@@ -126,6 +144,38 @@ exports.mcpReleaseTool = {
         return (0, tool_1.toolSuccess)(`ok: released ${parsed.serverId} for dialog ${dialogKey}`);
     },
 };
+exports.mcpDisableTool = {
+    type: 'func',
+    name: 'mcp_disable',
+    description: 'Disable a configured MCP server, clear its loaded runtime/leases, and persist enabled=false in `.minds/mcp.yaml`.',
+    descriptionI18n: {
+        en: 'Disable a configured MCP server, clear its loaded runtime/leases, and persist enabled=false in `.minds/mcp.yaml`.',
+        zh: '禁用指定 MCP 服务器，清理其已加载运行时/租约，并在 `.minds/mcp.yaml` 中持久写入 enabled=false。',
+    },
+    parameters: mcpDisableSchema,
+    argsValidation: 'dominds',
+    call: async (_dlg, caller, args) => {
+        const parsed = parseMcpDisableArgs(args);
+        const res = await (0, supervisor_1.requestMcpServerDisable)(parsed.serverId);
+        if (res.ok) {
+            log.info('mcp_disable', undefined, {
+                caller: caller.id,
+                serverId: parsed.serverId,
+                ok: true,
+            });
+        }
+        else {
+            log.warn('mcp_disable failed', undefined, {
+                caller: caller.id,
+                serverId: parsed.serverId,
+                ok: false,
+                errorText: res.errorText,
+            });
+            return (0, tool_1.toolFailure)(`error: ${res.errorText}`);
+        }
+        return (0, tool_1.toolSuccess)(`ok: disabled ${parsed.serverId} and set enabled=false`);
+    },
+};
 exports.mcpLeaseReminderOwner = {
     name: 'mcpLease',
     async updateReminder(dlg, reminder) {

package/dist/tools/prompts/mcp_admin/en/errors.md

@@ -68,20 +68,6 @@
 - Check lease status
 - Contact administrator
 
-### ENV_NOT_FOUND
-
-**Description:** Environment variable doesn't exist.
-
-**Cause:**
-
-- Environment variable not set
-- Environment variable name is incorrect
-
-**Solution:**
-
-- Check environment variable name
-- Set required environment variable
-
 ## Frequently Asked Questions
 
 ### Q: What is an MCP lease?

package/dist/tools/prompts/mcp_admin/en/index.md

@@ -26,9 +26,10 @@
 
 mcp_admin is Dominds' **MCP administration toolset** for managing MCP (Model Context Protocol) connections and resources:
 
-- **MCP restart**: Restart MCP service
+- **MCP restart/enable**: Enable and restart MCP service
 - **MCP release**: Release MCP lease
-- **Environment variables**: Read environment variables
+- **MCP disable**: Disable MCP service while keeping a zero-tool toolset/manual visible
+- **Environment variables**: Read, set, and delete local environment variables
 
 ## Quick Navigation
 
@@ -43,7 +44,8 @@ mcp_admin is Dominds' **MCP administration toolset** for managing MCP (Model Con
 
 - Status: Implemented
 - Main implementation files:
-  - Tool implementation: `dominds/main/tools/mcp-admin.ts`
+  - MCP tool implementation: `dominds/main/tools/mcp.ts`
+  - Environment variable tool implementation: `dominds/main/tools/env.ts`
   - Toolset metadata: `dominds/main/tools/builtins.ts`, `dominds/main/tools/registry.ts`
 
 ## Core Concepts

package/dist/tools/prompts/mcp_admin/en/principles.md

@@ -45,17 +45,22 @@ MCP uses a lease mechanism to manage runtime resources such as HTTP connections
 - **Hold lease**: Keep using that runtime instance
 - **Release lease**: Stop/disconnect and release resources
 
+`mcp_restart` changes the target server from `enabled: false` back to `enabled: true`, then tries to start it. When it succeeds, it replaces the global MCP runtime and clears all dialog leases on the old runtime; you do not need to call `mcp_release` first. To force a server into the disabled state, use `mcp_disable`.
+
 ### 3. Environment Variables
 
 Shared with os toolset for environment variable functionality.
 
 ## Tool Overview
 
-| Tool        | Function                 |
-| ----------- | ------------------------ |
-| mcp_restart | Restart MCP service      |
-| mcp_release | Release MCP lease        |
-| env_get     | Get environment variable |
+| Tool        | Function                       |
+| ----------- | ------------------------------ |
+| mcp_restart | Enable and restart MCP service |
+| mcp_release | Release MCP lease              |
+| mcp_disable | Disable MCP service            |
+| env_get     | Get environment variable       |
+| env_set     | Set environment variable       |
+| env_unset   | Delete environment variable    |
 
 ## Best Practices
 
@@ -64,6 +69,7 @@ Shared with os toolset for environment variable functionality.
 - **Release timely**: Release lease when MCP is no longer used
 - **Monitor status**: Regularly check MCP connection status
 - **Error handling**: Handle connection failures
+- **Responsibility routing**: teammates without the `mcp_admin` toolset should use the team responsibility quick table / routing cards to ask the MCP troubleshooter or administrator for help when MCP tools stop working; they should not improvise a bypass.
 
 ### 2. Resource Management
 

package/dist/tools/prompts/mcp_admin/en/scenarios.md

@@ -15,7 +15,9 @@
 
 ### Scenario Description
 
-When MCP service has issues or needs to refresh the connection, restart the MCP service.
+When an MCP service has issues, needs to refresh the connection, or is currently disabled with `enabled: false`, enable and restart the MCP service.
+
+`mcp_restart` writes `enabled: true` when the server is currently `enabled: false`, then tries to start it. After it succeeds, it clears every dialog lease on the old runtime; you do not need to call `mcp_release` first.
 
 ### Example
 
@@ -53,7 +55,21 @@ env_get({
 });
 ```
 
-## Scenario 4: MCP Connection Failure Handling
+## Scenario 4: Disable MCP Service
+
+### Scenario Description
+
+When an MCP server should stop providing tools, or troubleshooting needs to force it offline, disable that server and write `enabled: false`. A disabled server is still exposed as a zero-tool toolset, and its manual clearly marks it as disabled.
+
+### Example
+
+```typescript
+mcp_disable({
+  serverId: 'filesystem',
+});
+```
+
+## Scenario 5: MCP Connection Failure Handling
 
 ### Scenario Description
 
@@ -69,7 +85,7 @@ mcp_restart({
 });
 ```
 
-## Scenario 5: Resource Cleanup
+## Scenario 6: Resource Cleanup
 
 ### Scenario Description
 

package/dist/tools/prompts/mcp_admin/en/tools.md

@@ -21,7 +21,7 @@
 
 ### 1. mcp_restart
 
-Restart MCP service.
+Enable and rebuild an MCP service using the current `.minds/mcp.yaml` config. If the target server is currently `enabled: false`, this writes `enabled: true` before trying to start it. After a successful restart, Dominds replaces the global MCP runtime/tool registration and clears all dialog leases held on the old runtime. If restart fails, the old runtime/leases are kept so troubleshooting does not tear down a still-working connection.
 
 **Parameters:**
 
@@ -30,9 +30,7 @@ Restart MCP service.
 **Returns:**
 
 ```yaml
-status: ok|error
-serverId: <MCP service identifier>
-restarted_at: <restart timestamp>
+ok: restarted <MCP service identifier>
 ```
 
 **Errors:**
@@ -50,9 +48,13 @@ Release the current dialog's leased MCP runtime instance for a server. This stop
 **Returns:**
 
 ```yaml
-status: ok|error
-serverId: <MCP service identifier>
-released_at: <release timestamp>
+ok: released <MCP service identifier> for dialog <dialog identifier>
+```
+
+If the current dialog has no releasable lease, returns:
+
+```yaml
+ok: no active lease for <MCP service identifier> (or server is truely-stateless)
 ```
 
 **Errors:**
@@ -60,7 +62,21 @@ released_at: <release timestamp>
 - `MCP_NOT_FOUND`: MCP service doesn't exist
 - `MCP_NOT_RUNNING`: MCP service not running
 
-### 3. env_get
+### 3. mcp_disable
+
+Disable an MCP service and write `enabled: false` for that server in `.minds/mcp.yaml`. This does not wait for a replacement service to become available: it unconditionally clears the loaded runtime/leases. The disabled server remains visible as a zero-tool MCP toolset, with its manual clearly marked disabled.
+
+**Parameters:**
+
+- `serverId` (required): MCP service identifier
+
+**Returns:**
+
+```yaml
+ok: disabled <MCP service identifier> and set enabled=false
+```
+
+### 4. env_get
 
 Get environment variable (shared with os toolset).
 
@@ -70,16 +86,41 @@ Get environment variable (shared with os toolset).
 
 **Returns:**
 
+- Set: returns the environment variable value directly
+- Unset: returns `(unset)`
+
+### 5. env_set
+
+Set an environment variable in the Dominds server process (shared with os toolset).
+
+**Parameters:**
+
+- `key` (required): Environment variable name
+- `value` (required): Environment variable value
+
+**Returns:**
+
 ```yaml
-status: ok|error
-key: <environment variable name>
-value: <environment variable value>
-retrieved_at: <retrieval timestamp>
+ok: <environment variable name>
+prev: <previous value or (unset)>
+next: <new value>
 ```
 
-**Errors:**
+### 6. env_unset
 
-- `ENV_NOT_FOUND`: Environment variable doesn't exist
+Delete an environment variable from the Dominds server process (shared with os toolset).
+
+**Parameters:**
+
+- `key` (required): Environment variable name
+
+**Returns:**
+
+```yaml
+ok: <environment variable name>
+prev: <previous value or (unset)>
+next: (unset)
+```
 
 ## Usage Examples
 
@@ -99,6 +140,14 @@ mcp_release({
 });
 ```
 
+### Disable MCP Service
+
+```typescript
+mcp_disable({
+  serverId: 'browser',
+});
+```
+
 ### Get Environment Variable
 
 ```typescript
@@ -107,17 +156,32 @@ env_get({
 });
 ```
 
-## YAML Output Contract
+### Set Environment Variable
+
+```typescript
+env_set({
+  key: 'MCP_AUTH_TOKEN',
+  value: 'local-token',
+});
+```
+
+### Delete Environment Variable
+
+```typescript
+env_unset({
+  key: 'MCP_AUTH_TOKEN',
+});
+```
+
+## Output Contract
 
-All tool outputs use YAML format for programmatic processing:
+These tools use the short text return formats described in their own sections:
 
-- `status`: Operation status, `ok` for success, `error` for failure
-- Other fields: Additional information for specific operations
+- Success: starts with `ok:`
+- Failure: starts with `error:`
 
 On error, returns:
 
 ```yaml
-status: error
-error_code: <error code>
-message: <error message>
+error: <error message>
 ```

package/dist/tools/prompts/mcp_admin/zh/errors.md

@@ -68,20 +68,6 @@
 - 检查租约状态
 - 联系管理员
 
-### ENV_NOT_FOUND
-
-**描述：** 环境变量不存在。
-
-**原因：**
-
-- 环境变量未被设置
-- 环境变量名称错误
-
-**解决方案：**
-
-- 检查环境变量名称
-- 设置所需的环境变量
-
 ## 常见问题
 
 ### Q: MCP 租约是什么？

package/dist/tools/prompts/mcp_admin/zh/index.md

@@ -26,9 +26,10 @@
 
 mcp_admin 是 Dominds 的 **MCP 管理工具集**，用于管理 MCP（Model Context Protocol）连接和资源：
 
-- **MCP 重启**：重启 MCP 服务
+- **MCP 重启/启用**：启用并重启 MCP 服务
 - **MCP 释放**：释放 MCP 租约
-- **环境变量**：读取环境变量
+- **MCP 禁用**：禁用 MCP 服务，并保留 0 工具 toolset/手册可见性
+- **环境变量**：读取、设置、删除本地环境变量
 
 ## 快速导航
 
@@ -43,7 +44,8 @@ mcp_admin 是 Dominds 的 **MCP 管理工具集**，用于管理 MCP（Model Con
 
 - 状态：已实现
 - 主要实现文件：
-  - 工具实现：`dominds/main/tools/mcp-admin.ts`
+  - MCP 工具实现：`dominds/main/tools/mcp.ts`
+  - 环境变量工具实现：`dominds/main/tools/env.ts`
   - toolset 元信息：`dominds/main/tools/builtins.ts`、`dominds/main/tools/registry.ts`
 
 ## 核心概念

package/dist/tools/prompts/mcp_admin/zh/principles.md

@@ -45,17 +45,22 @@ MCP 使用租约机制管理运行时资源，例如 HTTP 连接和 stdio 进程
 - **持有租约**：继续使用该运行时实例
 - **释放租约**：停止/断开并释放资源
 
+`mcp_restart` 会把目标 server 的 `enabled: false` 改回 `enabled: true`，然后尝试启动；成功时会替换全局 MCP runtime 并清掉旧 runtime 的所有对话 lease；不需要先逐个 `mcp_release`。如果需要强制禁用某个 server，使用 `mcp_disable`。
+
 ### 3. 环境变量
 
 与 os 工具集共享环境变量功能。
 
 ## 工具概览
 
-| 工具        | 功能          |
-| ----------- | ------------- |
-| mcp_restart | 重启 MCP 服务 |
-| mcp_release | 释放 MCP 租约 |
-| env_get     | 获取环境变量  |
+| 工具        | 功能                |
+| ----------- | ------------------- |
+| mcp_restart | 启用并重启 MCP 服务 |
+| mcp_release | 释放 MCP 租约       |
+| mcp_disable | 禁用 MCP 服务       |
+| env_get     | 获取环境变量        |
+| env_set     | 设置环境变量        |
+| env_unset   | 删除环境变量        |
 
 ## 最佳实践
 
@@ -64,6 +69,7 @@ MCP 使用租约机制管理运行时资源，例如 HTTP 连接和 stdio 进程
 - **及时释放**：不再使用 MCP 时及时释放租约
 - **监控状态**：定期检查 MCP 连接状态
 - **错误处理**：处理连接失败的情况
+- **职责路由**：没有 `mcp_admin` 工具集的队友遇到 MCP 工具异常时，应按团队职责速查表/路由卡找到 MCP 排障或管理员队友协助，不要自行绕过。
 
 ### 2. 资源管理
 

package/dist/tools/prompts/mcp_admin/zh/scenarios.md

@@ -15,7 +15,9 @@
 
 ### 场景描述
 
-当 MCP 服务出现故障或需要刷新连接时，重启 MCP 服务。
+当 MCP 服务出现故障、需要刷新连接，或当前被 `enabled: false` 禁用时，启用并重启 MCP 服务。
+
+`mcp_restart` 会把 `enabled: false` 写回 `enabled: true` 后尝试启动；成功后会清理旧 runtime 的全部对话 lease，不需要先 `mcp_release`。
 
 ### 示例
 
@@ -53,7 +55,21 @@ env_get({
 });
 ```
 
-## 场景 4：MCP 连接故障处理
+## 场景 4：禁用 MCP 服务
+
+### 场景描述
+
+当某个 MCP server 不应继续提供工具，或排障时需要强制下线它，禁用该 server 并写入 `enabled: false`。禁用后的 server 仍会作为 0 工具 toolset 暴露，手册会明确标记已禁用。
+
+### 示例
+
+```typescript
+mcp_disable({
+  serverId: 'filesystem',
+});
+```
+
+## 场景 5：MCP 连接故障处理
 
 ### 场景描述
 
@@ -69,7 +85,7 @@ mcp_restart({
 });
 ```
 
-## 场景 5：资源清理
+## 场景 6：资源清理
 
 ### 场景描述