feat(ui,docs): Agent 流式侧栏 + 结果区/MCP 点/确认条 + 官网文案

- 侧栏消费 Agent SSE：时间线边 append、正文 ▌、停止按钮
- 「在结果区打开」不抢编辑器 focus；MCP 活跃点；写操作确认条
- 文档/落地页补充 Ask|Agent 与 npx @rlwj-lab/opsxdb-mcp（不宣传默认可写）

server/internal/docs/content/01-intro.md

@@ -13,7 +13,7 @@ OpsxDB 是一款**本地优先**的桌面数据库工作台，面向运维与开
 | 结果处理 | 一键复制 / CSV / 生成 INSERT；双击单元格复制；截断有提示 |
 | Redis 工作台 | 编辑器执行 PING / GET / SET / DEL / KEYS，键空间浏览 |
 | 安全通道 | 每连接独立配置 SSL/TLS 与 SSH 隧道；密码本机混淆存储 |
-| AI 面板 | 生成 / 解释 / 优化 / 修复 / 方言转换 / 样例 SQL |
+| AI 面板 | Ask 生成/解释/优化；Agent 真查库（与 MCP 同源只读工具） |
 | 危险操作防护 | DROP / TRUNCATE / 无 WHERE 的 UPDATE·DELETE 执行前确认 |
 | 桌面唯一形态 | 桌面 GUI（Tauri 2），本地后端随应用自动拉起 |
 

server/internal/docs/content/10-ai.md

@@ -12,16 +12,30 @@ AI 面板的目标：让「写不出的 SQL」和「看不懂的 SQL」不再阻
 | 样例 | 按表结构生成示例查询 |
 
 
-## Ask | Agent（阶段 2）
+## Ask | Agent
 
 侧栏输入框上方可切换模式：
 
 | 模式 | 行为 |
 | --- | --- |
 | **Ask** | 只生成/解释/优化 SQL，**不执行**数据库工具 |
-| **Agent** | 多轮调用与 MCP 同源的只读工具（列连接/库表、描述表、只读 SQL / Redis 读命令），步骤时间线挂在回复下 |
+| **Agent** | 多轮调用与 MCP 同源工具；步骤时间线边跑边推（SSE）；可「插入编辑器」「在结果区打开」 |
 
-Agent 需要已配置的 OpenAI 兼容模型（如 DeepSeek）。连接须在 `~/.opsxdb/mcp.json` 白名单内；写操作一律拒绝。
+Agent 支持 openai-chat（DeepSeek 等）、Anthropic messages、OpenAI responses。连接须在 `~/.opsxdb/mcp.json` 白名单内。
+
+默认 **只读**。若将 `mode` 设为 `read_write`，写操作仍须在气泡确认条点「执行」（一次一刀），模型不能自行带确认令牌。
+
+## MCP
+
+把同一套工具暴露给 Cursor / Claude / Codex：
+
+```bash
+npx @rlwj-lab/opsxdb-mcp
+```
+
+配置示例见仓库 `docs/mcp-cursor.example.json`。白名单写在 `~/.opsxdb/mcp.json` 的 `allowed_connection_ids`；空白名单拒绝全部连接。审计：`~/.opsxdb/logs/mcp-audit.jsonl`。
+
+侧栏标题旁仅在外部 MCP **近期有调用**时显示绿色「MCP」点；悬停/点击可看最近摘要。
 
 ## 使用方式
 

server/internal/docs/content/11-faq.md

@@ -38,3 +38,14 @@
 
 **Q：快捷键有哪些？**
 核心就一个：⌘/Ctrl + Enter 执行当前语句或选区；双击结果单元格复制。完整列表见《SQL 工作台》。
+
+
+## 如何把 OpsxDB 接到 Cursor？
+
+安装并配置 MCP：
+
+```bash
+npx @rlwj-lab/opsxdb-mcp
+```
+
+在 Cursor 的 `mcp.json` 中指向该命令（或本机构建的 `bin/opsxdb-mcp`），并在 `~/.opsxdb/mcp.json` 填写允许的连接 id。默认只读；详见《AI 助手》。