Merge pull request #578 from TencentCloudBase/docs/mcp-onboarding-flow

docs(ai): clarify MCP-first onboarding flow

Author: binggg

doc/components/AIDevelopmentPrompt.tsx

@@ -76,24 +76,24 @@ const categoryHints: Record<string, Record<string, string>> = {
 const translations: Record<string, Record<string, string>> = {
   'zh-CN': {
     title: 'AI 原生开发',
-    description: '快速体验 AI 原生开发，选择一个提示词开始',
-    promptHint: '选择一个提示词，开始你的 AI 原生开发之旅',
+    description: '完成 CloudBase MCP 连接后，选择一个提示词开始',
+    promptHint: '先完成 MCP 连接，再选择一个提示词开始你的 AI 原生开发之旅',
     changePrompt: '更换',
     startDevelopment: 'AI 开发',
     close: '关闭',
     modalTitle: '开始 AI 原生开发',
-    modalDescription: '选择一个 AI 开发工具，然后使用提示词开始开发',
+    modalDescription: '请先确认已完成 MCP 连接，再选择 AI 开发工具并使用提示词开始开发',
     promptLabel: '提示词',
   },
   'en': {
     title: 'AI-Native Development',
-    description: 'Quickly experience AI-native development, select a prompt to start',
-    promptHint: 'Select a prompt to start your AI-native development journey',
+    description: 'After connecting CloudBase MCP, select a prompt to start',
+    promptHint: 'Finish MCP setup first, then select a prompt to start your AI-native development journey',
     changePrompt: 'Change',
     startDevelopment: 'AI Development',
     close: 'Close',
     modalTitle: 'Start AI-Native Development',
-    modalDescription: 'Select an AI development tool, then use the prompt to start development',
+    modalDescription: 'Make sure MCP is already connected, then select an AI development tool and use a prompt to start',
     promptLabel: 'Prompt',
   },
 };

doc/components/prompts.json

@@ -141,7 +141,7 @@
     "category": "backend",
     "order": 1,
     "prompts": [
-      "帮我创建一个 CloudBase 云函数并部署",
+      "在完成 CloudBase MCP 连接后，帮我创建一个云函数并部署",
       "配置 CloudBase 云函数的 HTTP 访问",
       "查询 CloudBase 云函数的执行日志",
       "更新 CloudBase 云函数的环境变量"

doc/index.mdx

@@ -16,18 +16,20 @@ import AIDevelopmentPrompt from './components/AIDevelopmentPrompt';
 
 AI 负责代码生成和问题修复，CloudBase 提供运行环境。两者结合，让你专注于业务逻辑，而非基础设施配置。
 
-<AIDevelopmentPrompt />
+## 第 1 步：先连接 CloudBase MCP
 
-## CloudBase MCP 
+先选择你正在使用的 AI 开发工具，**点击下方图标进入对应安装文档**，按文档完成 MCP 安装或配置。
 
-以下是 CloudBase MCP 支持的 AI 开发工具，可点击具体的图标来查看具体指引。
+> **注意**：这里的图标列表是安装入口，不是展示列表。请先点进去完成对应工具的接入，再继续下面的 Skills 和提示词。
 
 <IDEIconGrid />
 
-## CloudBase AI Skill
+## 第 2 步：按需安装 CloudBase AI Skill（可选）
 
 将云开发最佳实践打包成「技能包」，与 MCP 搭配使用：MCP 负责连接与权限，Skills 负责规范与直觉，让 AI 既有权又懂规矩。
 
+> **这一步不是安装 MCP。** 如果你还没完成上一步，请先点击上方图标查看对应 IDE 的 MCP 安装指引。
+
 ```bash
 npx skills add tencentcloudbase/cloudbase-skills
 ```
@@ -36,6 +38,12 @@ npx skills add tencentcloudbase/cloudbase-skills
 
 详见 [如何使用 Skill](/ai/cloudbase-ai-toolkit/prompts/how-to-use)。
 
+## 第 3 步：开始 AI 原生开发
+
+完成 MCP 连接后，再选择一个提示词开始。
+
+<AIDevelopmentPrompt />
+
 <PromptScenarios />
 
 ## 核心能力

doc/prompts/cloud-functions.mdx

@@ -10,7 +10,7 @@
 
 你可以使用以下提示词来测试：
 
-- "帮我创建一个 CloudBase 云函数并部署"
+- "在完成 CloudBase MCP 连接后，帮我创建一个云函数并部署"
 - "配置 CloudBase 云函数的 HTTP 访问"
 - "查询 CloudBase 云函数的执行日志"
 - "更新 CloudBase 云函数的环境变量"

doc/prompts/config.yaml

@@ -141,7 +141,7 @@ rules:
     category: backend
     order: 1
     prompts:
-      - "帮我创建一个 CloudBase 云函数并部署"
+      - "在完成 CloudBase MCP 连接后，帮我创建一个云函数并部署"
       - "配置 CloudBase 云函数的 HTTP 访问"
       - "查询 CloudBase 云函数的执行日志"
       - "更新 CloudBase 云函数的环境变量"