diff --git a/development/cloud/mcp-server.mdx b/development/cloud/mcp-server.mdx
index ba65a9dfd..ae8a94ea7 100644
--- a/development/cloud/mcp-server.mdx
+++ b/development/cloud/mcp-server.mdx
@@ -16,10 +16,20 @@ Comfy Cloud MCP connects AI assistants — including Claude Desktop, Claude Code
 **Before you start, make sure you have:**
 
 - An active **Comfy Cloud subscription** (required to submit workflows)
-- A **Comfy API key** (starts with `comfyui-`)
 - Your email enabled for the **closed beta** (see note above)
+- A way to sign in: **OAuth** (recommended where supported) or a **Comfy API key** (`comfyui-…`)
 
-If you don't have an API key yet, see the guide to get one:
+### Sign in with OAuth or API key
+
+**OAuth (no API key to paste)** — In **Claude Code** or **Claude Desktop**, add the remote server `https://cloud.comfy.org/mcp` and use the client’s **Authenticate** control to sign in with your Comfy account. Partner generation and workflows use the same tools once connected.
+
+**API key** — Still fully supported. Use the one-click installer or manual setup below if your client does not offer OAuth, or if you prefer a key.
+
+<Warning>
+  **OAuth rollout.** The MCP server already accepts OAuth on production, but sign-in may not work end-to-end for everyone until the next Comfy Cloud production deployment finishes (the discovery endpoint must catch up). Until OAuth works for you, use an API key — existing API-key setups are unchanged.
+</Warning>
+
+If you use an API key and do not have one yet, see the guide to get one:
 
 <CardGroup cols={1}>
   <Card title="Getting an API Key" icon="key" href="/development/api-development/getting-an-api-key">
@@ -27,9 +37,9 @@ If you don't have an API key yet, see the guide to get one:
   </Card>
 </CardGroup>
 
-### Install & Connect
+### Install & Connect (API key)
 
-The easiest way to get started is with the one-click installer. It detects your MCP client (Claude Code, Cursor, Amp), asks for your Comfy API key, and configures the remote MCP server — no Node.js or other dependencies required.
+The one-click installer detects your MCP client (Claude Code, Cursor, Amp), asks for your Comfy API key, and configures the remote MCP server — no Node.js or other dependencies required.
 
 <Tabs>
   <Tab title="macOS / Linux">
@@ -45,9 +55,9 @@ The easiest way to get started is with the one-click installer. It detects your
   </Tab>
 </Tabs>
 
-### Manual Setup (Alternative)
+### Manual setup with API key
 
-If you prefer to configure manually, Comfy Cloud MCP is hosted at `https://cloud.comfy.org/mcp`. Point your MCP client at the server URL with your API key:
+Comfy Cloud MCP is hosted at `https://cloud.comfy.org/mcp`. Point your MCP client at that URL with your API key:
 
 <Tabs>
   <Tab title="Claude Code">
@@ -112,9 +122,22 @@ If you prefer to configure manually, Comfy Cloud MCP is hosted at `https://cloud
 
 **Just ask.** The agent picks the right tools on its own — *"generate a cat astronaut in space"*, *"find SDXL checkpoints"*, *"upscale this"*.
 
+### How generation is routed
+
+The agent chooses between two paths:
+
+| Path | Tool | Best for |
+|:-----|:-----|:---------|
+| **Partner APIs** | `partner_generate` | Named providers (Flux, Grok, Nano Banana, Ideogram, GPT-image, Seedream, etc.) |
+| **Custom workflows** | `submit_workflow` | Open-source models, LoRA/ControlNet, multi-step graphs, or anything not covered by `partner_generate` |
+
+For partner providers, `partner_generate` **always tries a real Comfy Cloud workflow run first**. The output is saved to your asset library with the workflow embedded so you can reopen it in the editor. The tool returns a `prompt_id` — poll with `get_job_status`, then download with `get_output` (same as any other workflow).
+
+For image-input requests or models not yet on the persistable set, the server **falls back automatically** to a direct partner-proxy response with instant download URLs. That fallback is internal; you cannot opt into or out of it. Those direct results are **not** saved to the asset library.
+
 ## Available Tools
 
-### Generate via Workflow
+### Workflow execution
 
 | Tool | Description |
 |:-----|:------------|
@@ -124,11 +147,11 @@ If you prefer to configure manually, Comfy Cloud MCP is hosted at `https://cloud
 | `cancel_job` | Cancel a pending or running job |
 | `get_queue` | Check how many jobs are running and pending |
 
-### Generate via Partner APIs (No Cloud GPU Cost)
+### Partner API generation
 
 | Tool | Description |
 |:-----|:------------|
-| `partner_generate` | Generate using partner APIs — Flux Pro, Nano Banana, Grok, GPT-image-1, Ideogram, Seedream (no Cloud GPU cost) |
+| `partner_generate` | Generate with partner APIs (Flux, Nano Banana, Grok, GPT-image, Ideogram, Seedream, etc.). Runs through a Comfy Cloud workflow by default; returns `prompt_id` and saves to your asset library. Poll `get_job_status` / `get_output` like any workflow. Unsupported cases fall back to instant proxy URLs automatically. |
 
 ### Discovery
 
@@ -152,8 +175,8 @@ If you prefer to configure manually, Comfy Cloud MCP is hosted at `https://cloud
 |:-----|:------------|
 | `list_saved_workflows` | Browse your saved workflows from Comfy Cloud |
 | `get_saved_workflow` | Inspect a saved workflow's nodes, inputs, and configuration |
-| `save_workflow` | Save the current workflow configuration |
-| `run_saved_workflow` | Execute a previously saved workflow |
+| `save_workflow` | Save a workflow to your workspace (save or API format; API format is converted automatically) |
+| `run_saved_workflow` | Fetch a saved workflow, convert to API format, and submit it for execution |
 
 ### Feedback (Beta)
 
@@ -185,15 +208,15 @@ Tool errors include a once-per-session pointer back to these channels so you don
 ```
 ┌──────────────┐    HTTPS/MCP    ┌─────────────────────────────────────────────┐
 │  AI Agent    │◄───────────────►│            Comfy Cloud                      │
-│  (Claude,    │   X-API-Key     │  cloud.comfy.org/mcp → Workflow Execution   │
-│   Cursor,    │                 │                        on Cloud GPUs        │
+│  (Claude,    │  API key or     │  cloud.comfy.org/mcp → Workflow execution   │
+│   Cursor,    │  OAuth bearer   │                        on Cloud GPUs        │
 │   Amp)       │                 │                                             │
 └──────────────┘                 └─────────────────────────────────────────────┘
 ```
 
 Your AI agent connects directly to the hosted MCP server at `cloud.comfy.org/mcp`. The server translates MCP tool calls into workflow executions on Comfy Cloud GPUs — no local server or GPU required.
 
-The AI agent uses the discovery tools to find templates and nodes, then constructs the ComfyUI API-format workflow JSON, submits it, and returns the results — just describe what you want in natural language.
+For partner models, the agent typically calls `partner_generate` first (workflow + library save). For everything else it uses discovery tools (`search_templates`, `search_nodes`, `cql`), builds ComfyUI API-format workflow JSON, and submits via `submit_workflow` — just describe what you want in natural language.
 
 ---
 
@@ -241,20 +264,20 @@ The agent will search for a matching template, build the ComfyUI workflow, submi
 </Warning>
 
 **Workflows**
-- **Cannot run saved workflows by ID.** You can browse and inspect saved workflows (`list_saved_workflows`, `get_saved_workflow`), but not always execute them directly. Saved workflows use the ComfyUI graph format, which requires conversion to API format. The AI agent must reconstruct the workflow from scratch.
-- **Generated assets have no workflow metadata.** Images created via the MCP server don't include workflow JSON in their metadata, so they won't show the workflow when opened in ComfyUI.
+- **`run_saved_workflow` coverage.** The tool fetches a saved workflow, converts save format → API format, and submits it. Complex input overrides or workflows with unsupported nodes may still need manual fixes or a rebuild via `submit_workflow`.
+- **Workflow metadata varies by path.** Outputs from `partner_generate` (workflow path) land in the asset library with the graph embedded for reopening in the editor. Outputs from `submit_workflow` or the direct `partner_generate` fallback may not include full workflow metadata in the asset library.
 - **Workflow accuracy depends on the AI.** The agent constructs ComfyUI workflows from natural language. Complex multi-node workflows or unusual node configurations may require iteration.
+- **`partner_generate` scope.** Text-to-image on the persistable model set runs as a saved workflow. Image-input generations, unmapped models, and non-image modalities use the direct proxy fallback (instant URL, not library-persisted) until workflow persist support expands.
 
 **File Handling**
 - **Upload size limits** may apply depending on your MCP client.
 - **Image previews are resized.** Inline previews are limited to 1024px (JPEG). Full-resolution files are saved to disk.
 
 **Authentication**
-- **API key only.** Authentication requires a Comfy Cloud API key passed via the `X-API-Key` header. Browser-based OAuth is not yet available.
+- **API key or OAuth.** Manual setup uses a Comfy Cloud API key in the `X-API-Key` header. MCP clients that sign in with Comfy OAuth send an `Authorization: Bearer` token instead; both are supported on the hosted server.
 
 **Client-Specific**
 - **Claude Desktop** — Generated images appear in the artifact side panel via HTML, not as native image artifacts.
-- **Claude Desktop chat mode** — Requires OAuth, which is coming soon. Use **Code mode** in the meantime — it picks up the Claude Code config automatically.
 
 ---
 
@@ -266,7 +289,7 @@ Restart your MCP client (close and reopen Claude Code, Claude Desktop, Cursor, o
 
 ### API key errors
 
-Verify your API key is valid at [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys). Make sure the key is passed in the `X-API-Key` header (not as a Bearer token). Generate a new key if needed and update your client config.
+Verify your API key is valid at [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys). For manual config, pass the key in the `X-API-Key` header — do not send a `comfyui-` key as a Bearer token. OAuth-connected clients should use `Authorization: Bearer` with the token from the Comfy sign-in flow, not `X-API-Key`. Generate a new API key if needed and update your client config.
 
 ### Connection errors
 
diff --git a/ja/development/cloud/mcp-server.mdx b/ja/development/cloud/mcp-server.mdx
index 5d7e92338..8af1c27be 100644
--- a/ja/development/cloud/mcp-server.mdx
+++ b/ja/development/cloud/mcp-server.mdx
@@ -16,10 +16,20 @@ Comfy Cloud MCPは、[モデルコンテキストプロトコル（MCP）](https
 **始める前にご確認ください：**
 
 - 有効な **Comfy Cloud サブスクリプション**（ワークフロー送信に必要）
-- **Comfy API キー**（`comfyui-` で始まる）
 - メールアドレスが **クローズドベータ** の許可リストに登録されていること（上記の注意を参照）
+- サインイン方法：**OAuth**（対応クライアントでは推奨）または **Comfy API キー**（`comfyui-` で始まる）
 
-API キーをお持ちでない場合は、以下のガイドをご覧ください：
+### OAuth または API キーでサインイン
+
+**OAuth（API キーの貼り付け不要）** — **Claude Code** または **Claude Desktop** でリモートサーバー `https://cloud.comfy.org/mcp` を追加し、クライアントの **Authenticate** から Comfy アカウントでサインインします。接続後はパートナー生成もワークフローも同じツールで利用できます。
+
+**API キー** — 引き続き完全にサポートされています。OAuth に未対応のクライアント、またはキーを使いたい場合は、下記のワンクリックインストールまたは手動設定をご利用ください。
+
+<Warning>
+  **OAuth の段階的ロールアウト。** MCP サーバーは本番で OAuth を受け付けますが、次の Comfy Cloud 本番デプロイが完了するまで（ディスカバリーエンドポイントの同期が必要）、一部のユーザーでは端到端のサインインがまだ動作しない場合があります。OAuth が使えない間は API キーをご利用ください。既存の API キー設定に変更はありません。
+</Warning>
+
+API キーを使用する場合で、まだお持ちでない場合は以下のガイドをご覧ください：
 
 <CardGroup cols={1}>
   <Card title="API キーを取得する" icon="key" href="/ja/development/api-development/getting-an-api-key">
@@ -27,9 +37,9 @@ API キーをお持ちでない場合は、以下のガイドをご覧くださ
   </Card>
 </CardGroup>
 
-### インストールと接続
+### インストールと接続（API キー）
 
-最も簡単な方法はワンクリックインストーラを使用することです。MCP クライアント（Claude Code、Cursor、Amp）を自動検出し、Comfy API キーを確認して、リモート MCP サーバーを設定します。Node.js やその他の依存関係は不要です。
+ワンクリックインストーラは MCP クライアント（Claude Code、Cursor、Amp）を自動検出し、Comfy API キーを確認してリモート MCP サーバーを設定します。Node.js やその他の依存関係は不要です。
 
 <Tabs>
   <Tab title="macOS / Linux">
@@ -45,9 +55,9 @@ API キーをお持ちでない場合は、以下のガイドをご覧くださ
   </Tab>
 </Tabs>
 
-### 手動設定（代替方法）
+### API キーで手動設定
 
-手動で設定する場合、Comfy Cloud MCPは `https://cloud.comfy.org/mcp` でホストされています。MCP クライアントをサーバー URL に向けて API キーを設定するだけです：
+Comfy Cloud MCPは `https://cloud.comfy.org/mcp` でホストされています。MCP クライアントをその URL に向け、API キーを設定します：
 
 <Tabs>
   <Tab title="Claude Code">
@@ -112,9 +122,22 @@ API キーをお持ちでない場合は、以下のガイドをご覧くださ
 
 **質問するだけ。** エージェントが自動的に適切なツールを選択します —— *"宇宙に浮かぶ猫の宇宙飛行士の画像を生成して"*、*"SDXL チェックポイントを検索して"*、*"この画像をアップスケールして"*。
 
+### 生成ルーティング
+
+エージェントは次の 2 つのパスから選択します。
+
+| パス | ツール | 用途 |
+|:-----|:-----|:-----|
+| **パートナー API** | `partner_generate` | 指定プロバイダー（Flux、Grok、Nano Banana、Ideogram、GPT-image、Seedream など） |
+| **カスタムワークフロー** | `submit_workflow` | OSS モデル、LoRA/ControlNet、多段パイプライン、`partner_generate` でカバーされないもの |
+
+パートナープロバイダーでは、`partner_generate` は**常にまず実際の Comfy Cloud ワークフロー実行を試みます**。出力はアセットライブラリに保存され、エディターで再オープンできるようワークフローが埋め込まれます。ツールは `prompt_id` を返すので、`get_job_status` でポーリングし、`get_output` で取得します（他のワークフローと同じ）。
+
+画像入力のリクエストや、まだ永続化対象に含まれないモデルでは、サーバーが**自動的に**パートナープロキシの直接応答（即時ダウンロード URL）にフォールバックします。このフォールバックは内部処理であり、オン/オフはできません。直接応答の結果は**アセットライブラリに保存されません**。
+
 ## 利用可能なツール
 
-### ワークフローによる生成
+### ワークフロー実行
 
 | ツール | 説明 |
 |:-----|:------------|
@@ -124,11 +147,11 @@ API キーをお持ちでない場合は、以下のガイドをご覧くださ
 | `cancel_job` | 保留中または実行中のジョブをキャンセル |
 | `get_queue` | 実行中および保留中のジョブ数を確認 |
 
-### パートナー API による生成（クラウド GPU 費用なし）
+### パートナー API 生成
 
 | ツール | 説明 |
 |:-----|:------------|
-| `partner_generate` | パートナー API を使用して生成 — Flux Pro、Nano Banana、Grok、GPT-image-1、Ideogram、Seedream（クラウド GPU 費用なし） |
+| `partner_generate` | パートナー API で生成（Flux、Nano Banana、Grok、GPT-image、Ideogram、Seedream など）。デフォルトは Comfy Cloud ワークフロー経由。`prompt_id` を返しアセットライブラリに保存。`get_job_status` / `get_output` で他のワークフローと同様に取得。未対応の場合は即時プロキシ URL に自動フォールバック。 |
 
 ### ディスカバリー
 
@@ -152,8 +175,8 @@ API キーをお持ちでない場合は、以下のガイドをご覧くださ
 |:-----|:------------|
 | `list_saved_workflows` | Comfy Cloud に保存されたワークフローを閲覧 |
 | `get_saved_workflow` | 保存されたワークフローのノード、入力、設定を確認 |
-| `save_workflow` | 現在のワークフロー設定を保存 |
-| `run_saved_workflow` | 保存済みワークフローを実行 |
+| `save_workflow` | ワークフローをワークスペースに保存（保存形式または API 形式；API 形式は自動変換） |
+| `run_saved_workflow` | 保存済みワークフローを取得し、API 形式に変換して実行を送信 |
 
 ### フィードバック（ベータ）
 
@@ -185,8 +208,8 @@ API キーをお持ちでない場合は、以下のガイドをご覧くださ
 ```
 ┌──────────────┐    HTTPS/MCP    ┌─────────────────────────────────────────────┐
 │  AI エージェ │◄───────────────►│            Comfy Cloud                      │
-│  ント        │   X-API-Key     │  cloud.comfy.org/mcp → クラウド GPU 上で   │
-│  (Claude,    │                 │                        ワークフロー実行     │
+│  ント        │  API キーまたは │  cloud.comfy.org/mcp → クラウド GPU 上で   │
+│  (Claude,    │  OAuth Bearer   │                        ワークフロー実行     │
 │   Cursor,    │                 │                                             │
 │   Amp)       │                 │                                             │
 └──────────────┘                 └─────────────────────────────────────────────┘
@@ -194,7 +217,7 @@ API キーをお持ちでない場合は、以下のガイドをご覧くださ
 
 AI エージェントは `cloud.comfy.org/mcp` でホストされている MCP サーバーに直接接続します。サーバーは MCP ツールコールを Comfy Cloud GPU 上のワークフロー実行に変換します。ローカルサーバーや GPU は不要です。
 
-AI エージェントはディスカバリーツールを使用してテンプレートやノードを検索し、ComfyUI API 形式のワークフロー JSON を構築して送信し、結果を返します。やりたいことを自然言語で説明するだけです。
+パートナーモデルでは、エージェントは通常まず `partner_generate`（ワークフロー + ライブラリ保存）を呼び出します。それ以外はディスカバリーツール（`search_templates`、`search_nodes`、`cql`）で ComfyUI API 形式のワークフロー JSON を構築し、`submit_workflow` で送信します。やりたいことを自然言語で説明するだけです。
 
 ---
 
@@ -242,20 +265,20 @@ SDXL チェックポイントモデルを検索して、利用可能なものを
 </Warning>
 
 **ワークフロー**
-- **保存されたワークフローを ID で実行できません。** 保存されたワークフローの閲覧と確認（`list_saved_workflows`、`get_saved_workflow`）は可能ですが、必ずしも直接実行できるわけではありません。保存されたワークフローは ComfyUI グラフ形式を使用しており、API 形式への変換が必要です。AI エージェントはワークフローをゼロから再構築する必要があります。
-- **生成されたアセットにワークフローメタデータがありません。** MCP サーバーで作成された画像にはメタデータにワークフロー JSON が含まれないため、ComfyUI で開いてもワークフローは表示されません。
+- **`run_saved_workflow` のカバレッジ。** 保存済みワークフローを取得し、保存形式 → API 形式に変換して送信します。複雑な入力上書きや未対応ノードがある場合は、手動修正や `submit_workflow` による再構築が必要な場合があります。
+- **ワークフローメタデータはパスによって異なります。** `partner_generate`（ワークフローパス）の出力はアセットライブラリに保存され、エディターで再オープンできるグラフが埋め込まれます。`submit_workflow` や `partner_generate` の直接フォールバックの出力には、ライブラリに完全なメタデータが含まれない場合があります。
 - **ワークフローの精度は AI に依存します。** エージェントは自然言語から ComfyUI ワークフローを構築します。複雑なマルチノードワークフローや特殊なノード設定では、反復が必要になる場合があります。
+- **`partner_generate` の範囲。** 永続化対象モデルセットのテキスト→画像は保存ワークフローとして実行されます。画像入力、未マップモデル、非画像モダリティは、ワークフロー永続化の拡張まで直接プロキシフォールバック（即時 URL、ライブラリ非保存）を使用します。
 
 **ファイル処理**
 - **アップロードサイズの制限**は MCP クライアントによって異なる場合があります。
 - **画像プレビューはリサイズされます。** インラインプレビューは 1024px（JPEG）に制限されます。フル解像度のファイルはディスクに保存されます。
 
 **認証**
-- **API キーのみ。** 認証には `X-API-Key` ヘッダーで Comfy Cloud API キーを渡す必要があります。ブラウザベースの OAuth はまだ利用できません。
+- **API キーまたは OAuth。** 手動設定では `X-API-Key` ヘッダーに Comfy Cloud API キーを指定します。Comfy OAuth でサインインする MCP クライアントは `Authorization: Bearer` を送信します。ホスト型サーバーは両方に対応しています。
 
 **クライアント固有**
 - **Claude Desktop** — 生成された画像はネイティブの画像アーティファクトではなく、HTML を介してアーティファクトサイドパネルに表示されます。
-- **Claude Desktop チャットモード** — OAuth が必要で、近日対応予定です。それまでは**コードモード**をご利用ください — Claude Code の設定を自動的に引き継ぎます。
 
 ---
 
@@ -267,7 +290,7 @@ MCP クライアントを再起動してください（Claude Code、Claude Desk
 
 ### API キーエラー
 
-[platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) で API キーが有効であることを確認してください。キーが `X-API-Key` ヘッダーで渡されていることを確認してください（Bearer トークンではありません）。必要に応じて新しいキーを生成し、クライアント設定を更新してください。
+[platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) で API キーが有効であることを確認してください。手動設定では `X-API-Key` ヘッダーでキーを渡してください — `comfyui-` キーを Bearer トークンとして送らないでください。OAuth 接続のクライアントは、Comfy サインインフローからの `Authorization: Bearer` を使用し、`X-API-Key` は使用しません。必要に応じて新しい API キーを生成し、クライアント設定を更新してください。
 
 ### 接続エラー
 
diff --git a/zh/development/cloud/mcp-server.mdx b/zh/development/cloud/mcp-server.mdx
index 8c27b1a52..f1289b7d0 100644
--- a/zh/development/cloud/mcp-server.mdx
+++ b/zh/development/cloud/mcp-server.mdx
@@ -16,10 +16,20 @@ Comfy Cloud MCP通过[模型上下文协议（MCP）](https://modelcontextprotoc
 **开始前请确认：**
 
 - 有效的 **Comfy Cloud 订阅**（提交工作流需要）
-- **Comfy API 密钥**（以 `comfyui-` 开头）
 - 你的邮箱已加入 **封闭测试** 白名单（见上方说明）
+- 一种登录方式：**OAuth**（在支持的客户端上推荐）或 **Comfy API 密钥**（以 `comfyui-` 开头）
 
-如果还没有 API 密钥，请查看指引获取：
+### OAuth 或 API 密钥登录
+
+**OAuth（无需粘贴 API 密钥）** — 在 **Claude Code** 或 **Claude Desktop** 中添加远程服务器 `https://cloud.comfy.org/mcp`，使用客户端的 **Authenticate** 通过 Comfy 账号登录。连接成功后，合作节点生成与工作流工具用法相同。
+
+**API 密钥** — 仍完全支持。若客户端不支持 OAuth，或你更习惯使用密钥，请使用下方的一键安装或手动配置。
+
+<Warning>
+  **OAuth 逐步开放。** MCP 服务端已在生产环境支持 OAuth，但在下一次 Comfy Cloud 生产部署完成前（发现端点需同步更新），部分用户可能还无法完成端到端登录。若 OAuth 暂时不可用，请继续使用 API 密钥——现有 API 密钥配置不受影响。
+</Warning>
+
+若使用 API 密钥且尚未创建，请查看指引获取：
 
 <CardGroup cols={1}>
   <Card title="获取 API 密钥" icon="key" href="/zh/development/api-development/getting-an-api-key">
@@ -27,9 +37,9 @@ Comfy Cloud MCP通过[模型上下文协议（MCP）](https://modelcontextprotoc
   </Card>
 </CardGroup>
 
-### 安装与连接
+### 安装与连接（API 密钥）
 
-最简单的方式是使用一键安装脚本。它会自动检测你的 MCP 客户端（Claude Code、Cursor、Amp），询问你的 Comfy API 密钥，并配置远程 MCP 服务器——无需 Node.js 或其他依赖。
+一键安装脚本会自动检测你的 MCP 客户端（Claude Code、Cursor、Amp），询问 Comfy API 密钥并配置远程 MCP 服务器——无需 Node.js 或其他依赖。
 
 <Tabs>
   <Tab title="macOS / Linux">
@@ -45,9 +55,9 @@ Comfy Cloud MCP通过[模型上下文协议（MCP）](https://modelcontextprotoc
   </Tab>
 </Tabs>
 
-### 手动配置（备选）
+### 使用 API 密钥手动配置
 
-如果你更喜欢手动配置，Comfy Cloud MCP托管在 `https://cloud.comfy.org/mcp`。将你的 MCP 客户端指向服务器 URL 并提供 API 密钥即可：
+Comfy Cloud MCP 托管在 `https://cloud.comfy.org/mcp`。将 MCP 客户端指向该 URL 并提供 API 密钥：
 
 <Tabs>
   <Tab title="Claude Code">
@@ -112,9 +122,22 @@ Comfy Cloud MCP通过[模型上下文协议（MCP）](https://modelcontextprotoc
 
 **直接提问即可。** 智能代理会自动选择正确的工具 —— *"生成一张太空中的猫宇航员图像"*、*"搜索 SDXL checkpoint"*、*"放大这张图片"*。
 
+### 生成路径如何路由
+
+代理会在两条路径之间选择：
+
+| 路径 | 工具 | 适用场景 |
+|:-----|:-----|:---------|
+| **合作 API** | `partner_generate` | 指定提供商（Flux、Grok、Nano Banana、Ideogram、GPT-image、Seedream 等） |
+| **自定义工作流** | `submit_workflow` | 开源模型、LoRA/ControlNet、多步流程，或 `partner_generate` 未覆盖的请求 |
+
+对于合作提供商，`partner_generate` **会优先尝试真实的 Comfy Cloud 工作流运行**。输出会保存到你的资源库，并嵌入工作流以便在编辑器中重新打开。工具返回 `prompt_id` —— 用 `get_job_status` 轮询，再用 `get_output` 下载（与其他工作流相同）。
+
+对于带图像输入的请求，或尚未纳入可持久化模型集的模型，服务器会**自动回退**到合作代理直连响应（即时下载 URL）。该回退是内部逻辑，无法手动开启或关闭。直连结果**不会**保存到资源库。
+
 ## 可用工具
 
-### 通过工作流生成
+### 工作流执行
 
 | 工具 | 描述 |
 |:-----|:------------|
@@ -124,11 +147,11 @@ Comfy Cloud MCP通过[模型上下文协议（MCP）](https://modelcontextprotoc
 | `cancel_job` | 取消待处理或正在运行的任务 |
 | `get_queue` | 检查正在运行和待处理的任务数量 |
 
-### 通过合作 API 生成（无需云端 GPU 费用）
+### 合作 API 生成
 
 | 工具 | 描述 |
 |:-----|:------------|
-| `partner_generate` | 使用合作 API 生成——Flux Pro、Nano Banana、Grok、GPT-image-1、Ideogram、Seedream（无云端 GPU 费用） |
+| `partner_generate` | 使用合作 API 生成（Flux、Nano Banana、Grok、GPT-image、Ideogram、Seedream 等）。默认通过 Comfy Cloud 工作流运行；返回 `prompt_id` 并保存到资源库。与任意工作流一样，使用 `get_job_status` / `get_output` 轮询获取。不支持的情况会自动回退为即时代理 URL。 |
 
 ### 发现
 
@@ -152,8 +175,8 @@ Comfy Cloud MCP通过[模型上下文协议（MCP）](https://modelcontextprotoc
 |:-----|:------------|
 | `list_saved_workflows` | 浏览你在 Comfy Cloud 上保存的工作流 |
 | `get_saved_workflow` | 查看已保存工作流的节点、输入和配置 |
-| `save_workflow` | 保存当前工作流配置 |
-| `run_saved_workflow` | 执行已保存的工作流 |
+| `save_workflow` | 保存工作流到工作区（支持保存格式或 API 格式；API 格式会自动转换） |
+| `run_saved_workflow` | 获取已保存工作流、转换为 API 格式并提交执行 |
 
 ### 反馈（测试版）
 
@@ -185,15 +208,15 @@ Comfy Cloud MCP通过[模型上下文协议（MCP）](https://modelcontextprotoc
 ```
 ┌──────────────┐    HTTPS/MCP    ┌─────────────────────────────────────────────┐
 │  AI 代理     │◄───────────────►│            Comfy Cloud                      │
-│  (Claude,    │   X-API-Key     │  cloud.comfy.org/mcp → 在云端 GPU 上       │
-│   Cursor,    │                 │                        执行工作流           │
+│  (Claude,    │  API 密钥或     │  cloud.comfy.org/mcp → 在云端 GPU 上       │
+│   Cursor,    │  OAuth Bearer   │                        执行工作流           │
 │   Amp)       │                 │                                             │
 └──────────────┘                 └─────────────────────────────────────────────┘
 ```
 
 你的 AI 代理直接连接到托管在 `cloud.comfy.org/mcp` 的 MCP 服务器。服务器将 MCP 工具调用转换为 Comfy Cloud GPU 上的工作流执行 —— 无需本地服务器或 GPU。
 
-AI 代理使用发现工具查找模板和节点，然后构建 ComfyUI API 格式的工作流 JSON，提交并返回结果 —— 只需用自然语言描述你想要的内容。
+对于合作模型，代理通常会先调用 `partner_generate`（工作流 + 资源库保存）。其他情况则使用发现工具（`search_templates`、`search_nodes`、`cql`），构建 ComfyUI API 格式的工作流 JSON，并通过 `submit_workflow` 提交 —— 只需用自然语言描述你想要的内容。
 
 ---
 
@@ -241,20 +264,20 @@ AI 代理使用发现工具查找模板和节点，然后构建 ComfyUI API 格
 </Warning>
 
 **工作流**
-- **无法通过 ID 运行已保存的工作流。** 你可以浏览和查看已保存的工作流（`list_saved_workflows`、`get_saved_workflow`），但不一定能直接执行。已保存的工作流使用 ComfyUI 图形格式，需要转换为 API 格式。AI 代理必须从头重建工作流。
-- **生成的资源没有工作流元数据。** 通过 MCP 服务器创建的图像不包含元数据中的工作流 JSON，因此在 ComfyUI 中打开时不会显示工作流。
+- **`run_saved_workflow` 覆盖范围。** 该工具会获取已保存工作流、将保存格式转换为 API 格式并提交。复杂的输入覆盖或不支持的节点可能仍需要手动修复或通过 `submit_workflow` 重建。
+- **工作流元数据因路径而异。** `partner_generate`（工作流路径）的输出会保存到资源库，并嵌入可在编辑器中重新打开的图。`submit_workflow` 或 `partner_generate` 直连回退的输出可能在资源库中不包含完整工作流元数据。
 - **工作流准确性取决于 AI。** 代理从自然语言构建 ComfyUI 工作流。复杂的多节点工作流或不常见的节点配置可能需要多次迭代。
+- **`partner_generate` 范围。** 可持久化模型集上的文生图会作为已保存工作流运行。带图像输入的生成、未映射模型和非图像模态会使用直连代理回退（即时 URL，不写入资源库），直到工作流持久化支持扩展。
 
 **文件处理**
 - **上传大小限制**可能因你的 MCP 客户端而异。
 - **图像预览会被调整大小。** 内联预览限制为 1024px（JPEG）。全分辨率文件会保存到磁盘。
 
 **认证**
-- **仅支持 API 密钥。** 认证需要通过 `X-API-Key` 头部传递 Comfy Cloud API 密钥。基于浏览器的 OAuth 尚不可用。
+- **API 密钥或 OAuth。** 手动配置使用 `X-API-Key` 头部的 Comfy Cloud API 密钥。通过 Comfy OAuth 登录的 MCP 客户端会发送 `Authorization: Bearer` 令牌；托管服务器均支持。
 
 **客户端特定**
 - **Claude Desktop** —— 生成的图像通过 HTML 显示在工件侧面板中，而非原生图像工件。
-- **Claude Desktop 聊天模式** —— 需要 OAuth，即将推出。在此期间请使用**代码模式** —— 它会自动使用 Claude Code 的配置。
 
 ---
 
@@ -266,7 +289,7 @@ AI 代理使用发现工具查找模板和节点，然后构建 ComfyUI API 格
 
 ### API 密钥错误
 
-在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 验证你的 API 密钥是否有效。确保密钥通过 `X-API-Key` 头部传递（而非 Bearer token）。如需要，生成新密钥并更新客户端配置。
+在 [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys) 验证你的 API 密钥是否有效。手动配置时，通过 `X-API-Key` 头部传递密钥 —— 不要将 `comfyui-` 密钥作为 Bearer 令牌发送。OAuth 连接的客户端应使用 Comfy 登录流程获得的 `Authorization: Bearer` 令牌，而非 `X-API-Key`。如需要，生成新 API 密钥并更新客户端配置。
 
 ### 连接错误