docs: 重新组织帮助文档，突出 stdio 模式的简便性

- 新增'快速开始'章节，突出 stdio 模式作为推荐方式
- 将 Docker 相关内容统一到'使用 Docker（可选）'章节
- 明确区分 stdio 模式和 SSE 模式的使用场景
- 添加 Codex 中配置 SSE 模式的说明
- 消除文档中关于模式选择和 Docker 使用的混淆

Change-Id: I10c72da56a2dc3f4a680c43834a8535442a0c81d
Co-developed-by: Cursor <noreply@cursor.com>

Author: 延枚

README.md

@@ -181,20 +181,14 @@ alibabacloud-devops-mcp-server integrates various tools, including:
 
   ![The personal token authorization page](https://agent-install-beijing.oss-cn-beijing.aliyuncs.com/alibabacloud-devops-mcp-server/img_8.jpg)
 
-### Installing via Smithery
+## Quick Start (Recommended: Using Stdio Mode)
 
-To install [AlibabaCloud DevOps](https://www.aliyun.com/product/yunxiao) Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@aliyun/alibabacloud-devops-mcp-server):
-
-```bash
-npx -y @smithery/cli install @aliyun/alibabacloud-devops-mcp-server --client claude
-```
+**Stdio mode** is the simplest and most common way, suitable for most MCP clients (like Cursor, Claude Desktop, iFlow, etc.). No Docker installation required, just run via npx.
 
-### Install Yunxiao MCP server via MCP marketplace
-The MCP market built into Lingma (AlibabaCloud Tongyi Lingma) has already provided the AlibabaCloud Devops MCP service. To install it, simply enter the MCP market in Lingma and search for "Yunxiao DevOps", then click install.
+### Option 1: Direct Use via NPX (Simplest)
 
-![Install AlibabaCloud Devops MCP Service from the MCP Market](https://agent-install-beijing.oss-cn-beijing.aliyuncs.com/alibabacloud-devops-mcp-server/img_9.png)
+Add the following configuration to your MCP client configuration file:
 
-### Run MCP Server via NPX/Cursor/Claude code etc. 
 ```json
 {
   "mcpServers": {
@@ -212,53 +206,84 @@ The MCP market built into Lingma (AlibabaCloud Tongyi Lingma) has already provid
 }
 ```
 
-### Run MCP Server via Docker Container
+> **Note**: 
+> - Replace `<YOUR_TOKEN>` with your Yunxiao access token
+> - The `-y` flag automatically confirms installation without manual confirmation
+> - This method uses **stdio mode**, communicating with the MCP client via standard input/output
 
-#### Option 1: Use Official Image (Recommended)
+### Option 2: Install via MCP Marketplace
 
-You can use the official Docker image without building it yourself:
+The MCP market built into Lingma (AlibabaCloud Tongyi Lingma) has already provided the AlibabaCloud Devops MCP service. To install it, simply enter the MCP market in Lingma and search for "Yunxiao DevOps", then click install.
 
-```shell
-# Pull the official image
-docker pull build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:v0.2.0
+### Option 3: Install via Smithery
+
+To install [AlibabaCloud DevOps](https://www.aliyun.com/product/yunxiao) Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@aliyun/alibabacloud-devops-mcp-server):
+
+```bash
+npx -y @smithery/cli install @aliyun/alibabacloud-devops-mcp-server --client claude
 ```
 
-Then use the official image name in your docker run commands instead of `alibabacloud/alibabacloud-devops-mcp-server`.
+---
 
-#### Option 2: Build Your Own Image
+## Using Docker (Optional)
 
-If you prefer to build the image yourself:
+If you need to run the MCP server using Docker, you can choose **stdio mode** or **SSE mode**.
 
-```shell
-docker build -t alibabacloud/alibabacloud-devops-mcp-server .
-```
+### Docker with Stdio Mode
 
-#### 2. Run the Container
+This method is similar to using npx directly, but runs through a Docker container.
 
-The MCP server supports two modes: **stdio mode** (default) and **SSE mode** (HTTP).
+#### 1. Get Docker Image
 
-##### Stdio Mode (for MCP clients)
+**Option 1: Use Official Image (Recommended)**
 
-Run the container directly (using official image):
 ```shell
-docker run -i --rm \
-  -e YUNXIAO_ACCESS_TOKEN="your_token_here" \
-  build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:v0.2.0
+docker pull build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:v0.2.0
 ```
 
-Or use an environment file:
+**Option 2: Build Your Own Image**
+
 ```shell
-# Create .env file with: YUNXIAO_ACCESS_TOKEN=your_token_here
-docker run -i --rm \
-  --env-file .env \
-  build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:v0.2.0
+docker build -t alibabacloud/alibabacloud-devops-mcp-server .
+```
+
+#### 2. Configure MCP Client
+
+Add the following to your MCP client configuration file:
+
+```json
+{
+  "mcpServers": {
+    "yunxiao": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "YUNXIAO_ACCESS_TOKEN",
+        "build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:v0.2.0"
+      ],
+      "env": {
+        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
+      }
+    }
+  }
+}
 ```
 
-> **Note**: If you built your own image, replace the image name with `alibabacloud/alibabacloud-devops-mcp-server`.
+> **Note**: 
+> - If using a self-built image, replace the image name with `alibabacloud/alibabacloud-devops-mcp-server`
+> - This method uses **stdio mode**, with the container communicating via standard input/output
 
-##### SSE Mode (for HTTP access)
+### Docker with SSE Mode
+
+SSE mode provides service via HTTP, suitable for scenarios requiring independent service or multi-user support.
+
+#### 1. Start SSE Service
+
+**Using Official Image:**
 
-Run the container in background (using official image):
 ```shell
 docker run -d --name yunxiao-mcp \
   -p 3000:3000 \
@@ -269,85 +294,127 @@ docker run -d --name yunxiao-mcp \
   node dist/index.js --sse
 ```
 
-> **Note**: If you built your own image, replace the image name with `alibabacloud/alibabacloud-devops-mcp-server`.
-
-The server will be available at:
-- SSE endpoint: `http://localhost:3000/sse`
-- Messages endpoint: `http://localhost:3000/messages?sessionId=<session-id>`
+**Using Self-Built Image:**
 
-View logs:
 ```shell
-docker logs -f yunxiao-mcp
+docker run -d --name yunxiao-mcp \
+  -p 3000:3000 \
+  -e YUNXIAO_ACCESS_TOKEN="your_token_here" \
+  -e PORT=3000 \
+  -e MCP_TRANSPORT=sse \
+  alibabacloud/alibabacloud-devops-mcp-server \
+  node dist/index.js --sse
 ```
 
-Stop the container:
-```shell
-docker stop yunxiao-mcp
-```
+#### 2. Configure MCP Client
 
-#### 3. Configure MCP Client (for stdio mode)
+Add the following to your MCP client configuration file:
 
-If you're using a MCP client (like Claude Desktop, Cursor, etc.), configure it to use Docker:
+```json
+{
+  "mcpServers": {
+    "yunxiao": {
+      "url": "http://localhost:3000/sse"
+    }
+  }
+}
+```
+
+If you need to pass your own token when connecting (instead of using the default token from server startup):
 
 ```json
 {
   "mcpServers": {
     "yunxiao": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--rm",
-        "-e",
-        "YUNXIAO_ACCESS_TOKEN",
-        "build-steps-public-registry.cn-beijing.cr.aliyuncs.com/build-steps/alibabacloud-devops-mcp-server:v0.2.0"
-      ],
-      "env": {
-        "YUNXIAO_ACCESS_TOKEN": "<YOUR_TOKEN>"
-      }
+      "url": "http://localhost:3000/sse?yunxiao_access_token=YOUR_TOKEN_HERE"
     }
   }
 }
 ```
 
-> **Note**: If you built your own image, replace the image name with `alibabacloud/alibabacloud-devops-mcp-server`.
-###  Run MCP Server via Docker Compose
-1. Environment Setup
+#### 3. Manage SSE Service
+
+View logs:
+```shell
+docker logs -f yunxiao-mcp
+```
+
+Stop service:
+```shell
+docker stop yunxiao-mcp
+```
+
+### Run SSE Mode via Docker Compose
+
+1. **Environment Setup**
 ```shell
 cd alibabacloud-devops-mcp-server
-cp .env.example
+cp .env.example .env
+# Edit .env file and set YUNXIAO_ACCESS_TOKEN
 ```
 
-2. Running the Services:
+2. **Start Service**
 ```shell
 docker compose up -d
 ```
-3. Configure MCP Server
+
+3. **Configure MCP Client**
 ```json
 {
   "mcpServers": {
     "yunxiao": {
-      "url":"http://localhost:3000/sse"
+      "url": "http://localhost:3000/sse"
     }
   }
 }
 ```
 
-### SSE Mode with Custom Tokens
-When running in SSE mode, each user can use their own token by passing it as a query parameter or request header:
+---
+
+## Advanced SSE Mode Configuration
+
+### Using Custom Tokens
 
-1. Via query parameter:
+In SSE mode, each user can pass their own token in the following ways:
+
+1. **Via query parameter** (Recommended):
 ```
 http://localhost:3000/sse?yunxiao_access_token=USER_SPECIFIC_TOKEN
 ```
 
-2. Via request header:
+2. **Via request header**:
 ```
 x-yunxiao-token: USER_SPECIFIC_TOKEN
 ```
 
 This allows multiple users to share the same SSE service while using their own individual tokens for authentication.
 
+### Configure SSE Mode in Codex
+
+If your Yunxiao MCP server is already running in SSE mode at `http://localhost:3000`, you can configure it in Codex as follows:
+
+**Use default token (configured at server startup):**
+```json
+{
+  "mcpServers": {
+    "yunxiao": {
+      "url": "http://localhost:3000/sse"
+    }
+  }
+}
+```
+
+**Pass token in URL:**
+```json
+{
+  "mcpServers": {
+    "yunxiao": {
+      "url": "http://localhost:3000/sse?yunxiao_access_token=YOUR_TOKEN_HERE"
+    }
+  }
+}
+```
+
 ### Toolsets
 The server now supports toolsets, allowing you to enable only the tools you need. This can reduce the number of tools presented to the AI assistant and improve performance.