feat: update docs

docs/users/features/_meta.ts

@@ -7,6 +7,5 @@ export default {
   },
   'approval-mode': 'Approval Mode',
   'token-caching': 'Token Caching',
-  mcp: 'MCP',
   sandbox: 'Sandboxing',
 };

docs/users/mcp/mcp.md

@@ -15,6 +15,7 @@ An MCP server enables the CLI to:
 With an MCP server, you can extend the CLI’s capabilities to perform actions beyond its built-in features, such as interacting with databases, APIs, custom scripts, or specialized workflows.
 
 ## Core Integration Architecture
+
 Qwen Code integrates with MCP servers through a sophisticated discovery and execution system built into the core package (`packages/core/src/tools/`):
 
 ### Discovery Layer (`mcp-client.ts`)
@@ -37,6 +38,7 @@ Each discovered MCP tool is wrapped in a `DiscoveredMCPTool` instance that:
 - **Maintains connection state** and handles timeouts
 
 ### Transport Mechanisms
+
 The CLI supports three MCP transport types:
 
 - **Stdio Transport:** Spawns a subprocess and communicates via stdin/stdout
@@ -52,6 +54,7 @@ Qwen Code uses the `mcpServers` configuration in your `settings.json` file t
 You can configure MCP servers in your `settings.json` file in two main ways: through the top-level `mcpServers`object for specific server definitions, and through the `mcp` object for global settings that control server discovery and execution.
 
 #### Global MCP Settings (`mcp`)
+
 The `mcp` object in your `settings.json` allows you to define global rules for all MCP servers.
 
 - **`mcp.serverCommand`** : A global command to start an MCP server.
@@ -70,9 +73,11 @@ The `mcp` object in your `settings.json` allows you to define global rules f
 ```
 
 #### Server-Specific Configuration (`mcpServers`)
+
 The `mcpServers` object is where you define each individual MCP server you want the CLI to connect to.
 
 ### Configuration Structure
+
 Add an `mcpServers` object to your `settings.json` file:
 
 ```
@@ -112,7 +117,7 @@ Each server configuration supports the following properties:
 - **`trust`** (boolean): When `true`, bypasses all tool call confirmations for this server (default: `false`)
 - **`includeTools`** : List of tool names to include from this MCP server. When specified, only the tools listed here will be available from this server (allowlist behavior). If not specified, all tools from the server are enabled by default.
 - **`excludeTools`** : List of tool names to exclude from this MCP server. Tools listed here will not be available to the model, even if they are exposed by the server. 
-	- **Note:** `excludeTools` takes precedence over `includeTools` - if a tool is in both lists, it will be excluded.
+  - **Note:** `excludeTools` takes precedence over `includeTools` - if a tool is in both lists, it will be excluded.
 - **`targetAudience`** : The OAuth Client ID allowlisted on the IAP-protected application you are trying to access. Used with `authProviderType: 'service_account_impersonation'`.
 - **`targetServiceAccount`** : The email address of the Google Cloud Service Account to impersonate. Used with `authProviderType: 'service_account_impersonation'`.
 
@@ -206,9 +211,9 @@ OAuth tokens are automatically:
 You can specify the authentication provider type using the `authProviderType` property:
 
 - **`authProviderType`** : Specifies the authentication provider. Can be one of the following:
-    - **`dynamic_discovery`** (default): The CLI will automatically discover the OAuth configuration from the server.
+  - **`dynamic_discovery`** (default): The CLI will automatically discover the OAuth configuration from the server.
-    - **`google_credentials`**: The CLI will use the Google Application Default Credentials (ADC) to authenticate with the server. When using this provider, you must specify the required scopes.
+  - **`google_credentials`**: The CLI will use the Google Application Default Credentials (ADC) to authenticate with the server. When using this provider, you must specify the required scopes.
-    - **`service_account_impersonation`**: The CLI will impersonate a Google Cloud Service Account to authenticate with the server. This is useful for accessing IAP-protected services (this was specifically designed for Cloud Run services).
+  - **`service_account_impersonation`**: The CLI will impersonate a Google Cloud Service Account to authenticate with the server. This is useful for accessing IAP-protected services (this was specifically designed for Cloud Run services).
 
 #### Google Credentials
 
@@ -368,9 +373,9 @@ For each configured server in `mcpServers`:
 
 1. **Status tracking begins:** Server status is set to `CONNECTING`
 2. **Transport selection:** Based on configuration properties:
-    - `httpUrl` → `StreamableHTTPClientTransport`
+   - `httpUrl` → `StreamableHTTPClientTransport`
-    - `url` → `SSEClientTransport`
+   - `url` → `SSEClientTransport`
-    - `command` → `StdioClientTransport`
+   - `command` → `StdioClientTransport`
 3. **Connection establishment:** The MCP client attempts to connect with the configured timeout
 4. **Error handling:** Connection failures are logged and the server status is set to `DISCONNECTED`
 
@@ -382,8 +387,8 @@ Upon successful connection:
 2. **Schema validation:** Each tool’s function declaration is validated
 3. **Tool filtering:** Tools are filtered based on `includeTools` and `excludeTools` configuration
 4. **Name sanitization:** Tool names are cleaned to meet Qwen API requirements:
-    - Invalid characters (non-alphanumeric, underscore, dot, hyphen) are replaced with underscores
+   - Invalid characters (non-alphanumeric, underscore, dot, hyphen) are replaced with underscores
-    - Names longer than 63 characters are truncated with middle replacement (`___`)
+   - Names longer than 63 characters are truncated with middle replacement (`___`)
 
 ### 3. Conflict Resolution
 
@@ -454,7 +459,6 @@ When confirmation is required, users can choose:
 Upon confirmation (or trust bypass):
 
 1. **Parameter preparation:** Arguments are validated against the tool’s schema
-   
 2. **MCP call:** The underlying `CallableTool` invokes the server with:
 
 ```
@@ -466,7 +470,6 @@ const functionCalls = [{
 
 3. **Response processing:** Results are formatted for both LLM context and user display
 
-
 ### 4. Response Handling
 
 The execution result contains:
@@ -656,8 +659,6 @@ Here is an example of a valid JSON response from an MCP tool that returns both a
 }
 ```
 
-
-
 When Qwen Code receives this response, it will:
 
 1. Extract all the text and combine it into a single `functionResponse` part for the model.
@@ -674,7 +675,7 @@ In addition to tools, MCP servers can expose predefined prompts that can be exec
 
 Here’s a small example of a stdio MCP server that defines prompts:
 
-````
+```
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
@@ -706,7 +707,7 @@ server.registerPrompt(
 
 const transport = new StdioServerTransport();
 await server.connect(transport);
-````
+```
 
 This can be included in `settings.json` under `mcpServers` with:
 
@@ -721,8 +722,6 @@ This can be included in `settings.json` under `mcpServers` with:
 }
 ```
 
-
-
 ### Invoking Prompts
 
 Once a prompt is discovered, you can invoke it using its name as a slash command. The CLI will automatically handle parsing arguments.
@@ -784,8 +783,6 @@ qwen mcp add my-stdio-server -e API_KEY=123 /path/to/server arg1 arg2 arg3
 qwen mcp add python-server python server.py --port 8080
 ```
 
-
-
 #### Adding an HTTP server
 
 This transport is for servers that use the streamable HTTP transport.
@@ -801,8 +798,6 @@ qwen mcp add --transport http http-server https://api.example.com/mcp/
 qwen mcp add --transport http secure-http https://api.example.com/mcp/ --header "Authorization: Bearer abc123"
 ```
 
-
-
 #### Adding an SSE server
 
 This transport is for servers that use Server-Sent Events (SSE).
@@ -818,8 +813,6 @@ qwen mcp add --transport sse sse-server https://api.example.com/sse/
 qwen mcp add --transport sse secure-sse https://api.example.com/sse/ --header "Authorization: Bearer abc123"
 ```
 
-
-
 ### Listing Servers (`qwen mcp list`)
 
 To view all MCP servers currently configured, use the `list` command. It displays each server’s name, configuration details, and connection status.
@@ -838,8 +831,6 @@ qwen mcp list
 ✗ sse-server: https://api.example.com/sse (sse) - Disconnected
 ```
 
-
-
 ### Removing a Server (`qwen mcp remove`)
 
 To delete a server from your configuration, use the `remove` command with the server’s name.