Skip to content

docs(agent-tools): expand Cloud MCP install guide for multiple clients#1219

Merged
comfyui-wiki merged 4 commits into
mainfrom
docs/cloud-mcp-client-tabs
Jul 3, 2026
Merged

docs(agent-tools): expand Cloud MCP install guide for multiple clients#1219
comfyui-wiki merged 4 commits into
mainfrom
docs/cloud-mcp-client-tabs

Conversation

@comfyui-wiki

Copy link
Copy Markdown
Member

Summary

  • Restructure the Cloud MCP install section with client tabs (Claude Code, Claude Desktop, Cursor, Codex, Other clients) and move it above the tools reference.
  • Add step-by-step screenshots for Claude Desktop and Codex setup, plus shared OAuth authorization image and demo videos.
  • Note Comfy Cloud account requirement before connecting; sync updated page to ja, zh, and ko.

Test plan

  • Preview agent-tools/cloud on Mintlify (pnpm dev) and verify all install tabs, images, and videos render.
  • Confirm ja/zh/ko agent-tools/cloud pages match the English structure and links work.
  • Check OAuth/auth screenshot and numbered step labels in Claude Desktop and Codex tabs.

Add tabbed setup for Claude Code, Desktop, Cursor, Codex, and other MCP clients with step screenshots and OAuth flow assets. Move install section above the tools reference and sync ja/zh/ko translations.
@mintlify

mintlify Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
comfy 🟢 Ready View Preview Jul 3, 2026, 4:41 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@coderabbitai

coderabbitai Bot commented Jul 3, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 24f4110a-fedc-4ac5-9910-345af5951d87

📥 Commits

Reviewing files that changed from the base of the PR and between 2c3a64d and 0d0d945.

📒 Files selected for processing (3)
  • ja/agent-tools/cloud.mdx
  • ko/agent-tools/cloud.mdx
  • zh/agent-tools/cloud.mdx

📝 Walkthrough

Walkthrough

This PR expands Comfy Cloud MCP documentation across English, Japanese, Korean, and Chinese agent-tools/cloud.mdx pages. Install instructions now cover Claude Code, Claude Desktop, Cursor, Codex, and other MCP-compatible clients, with updated OAuth, API-key, spending, and FAQ guidance.

Changes

Comfy Cloud MCP documentation update

Layer / File(s) Summary
English docs: expanded install and FAQ
agent-tools/cloud.mdx
Description broadened to mention Cursor, Codex, and any MCP-compatible agent; old install section replaced with client-specific tabbed setup (URL, OAuth, headless API key); old install block removed; FAQ answers updated for broader client support and API-key scope.
Japanese translation: install, tools, and FAQ updates
ja/agent-tools/cloud.mdx
Frontmatter metadata and translation hashes updated; install section rewritten with client-specific tabs; MCP tools and credits/spending content refreshed; FAQ answers revised for expanded client support and spend gating.
Korean translation: install and FAQ updates
ko/agent-tools/cloud.mdx
Translation metadata hashes updated; install guidance expanded with plugin, OAuth, and API-key flows per client; FAQ entries on supported clients, API-key need, and local execution alternatives updated.
Chinese translation: install and FAQ updates
zh/agent-tools/cloud.mdx
Translation metadata hashes updated; general MCP connectivity note and new tabbed install section added; agent flow, credits/spending, known limitation, and FAQ content updated.

Possibly related PRs

  • Comfy-Org/docs#1204: Also rewrites agent-tools/cloud.mdx install instructions and FAQ, overlapping on client onboarding and auth behavior.
🚥 Pre-merge checks | ✅ 2
✅ Passed checks (2 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/cloud-mcp-client-tabs
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch docs/cloud-mcp-client-tabs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@zh/agent-tools/cloud.mdx`:
- Around line 216-225: The Codex tab section is left open and the Chinese setup
flow is incomplete after the “MCP servers” step in the Tabs content. Restore the
missing Codex instructions, including the two accordions, the “Other clients”
tab, and the closing </Tabs>, using the existing Tabs/Step structure in
cloud.mdx so the MDX block parses correctly.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: ca76b546-0c90-4059-b3fd-ca4d4ea07fb9

📥 Commits

Reviewing files that changed from the base of the PR and between 685272a and 4ab730c.

⛔ Files ignored due to path filters (10)
  • images/agent_tools/CodeX_Oauth_mcp.mp4 is excluded by !**/*.mp4
  • images/agent_tools/auth.png is excluded by !**/*.png
  • images/agent_tools/claude_desktop_mcp_setup_step1.png is excluded by !**/*.png
  • images/agent_tools/claude_desktop_mcp_setup_step2.png is excluded by !**/*.png
  • images/agent_tools/claude_desktop_mcp_setup_step3.png is excluded by !**/*.png
  • images/agent_tools/claude_desktop_mcp_setup_step4.png is excluded by !**/*.png
  • images/agent_tools/codex_mcp_setup_step1.png is excluded by !**/*.png
  • images/agent_tools/codex_mcp_setup_step2.png is excluded by !**/*.png
  • images/agent_tools/codex_mcp_setup_step3.png is excluded by !**/*.png
  • images/agent_tools/codex_mcp_setup_step4.png is excluded by !**/*.png
📒 Files selected for processing (4)
  • agent-tools/cloud.mdx
  • ja/agent-tools/cloud.mdx
  • ko/agent-tools/cloud.mdx
  • zh/agent-tools/cloud.mdx

Comment thread zh/agent-tools/cloud.mdx
Re-translate agent-tools/cloud.mdx for zh and ko, remove duplicate MCP tools block in zh, and merge main so i18n redirect check passes.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
ko/agent-tools/cloud.mdx (1)

37-41: 🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win

Keep the FAQ anchors stable in the localized Cloud docs
The FAQ links use the English slugs #install-comfy-cloud-mcp and #credits-and-spending, but the translated headings generate different anchors. Add explicit custom IDs to the headings, or update the fragment links to match the localized slugs. The same fix applies to the ja and zh copies.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@ko/agent-tools/cloud.mdx` around lines 37 - 41, The FAQ anchor links in the
localized Cloud docs are mismatched because translated headings generate
different fragments than the English slugs. Update the heading markup in the
Cloud MCP docs to use explicit stable IDs, or change the FAQ links to match the
localized anchors. Apply the same fix in the ko, ja, and zh versions so the
anchors referenced from the FAQ stay consistent.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@zh/agent-tools/cloud.mdx`:
- Line 326: The model name in the example phrase is inconsistent and appears to
be a translation artifact; update the wording in the relevant cloud.mdx guidance
to use the same “Wan 2.2” naming convention used elsewhere in the file. Check
the surrounding examples and the affected sentence together so the brand/model
reference is consistent and not duplicated as “Wan万相”.

---

Outside diff comments:
In `@ko/agent-tools/cloud.mdx`:
- Around line 37-41: The FAQ anchor links in the localized Cloud docs are
mismatched because translated headings generate different fragments than the
English slugs. Update the heading markup in the Cloud MCP docs to use explicit
stable IDs, or change the FAQ links to match the localized anchors. Apply the
same fix in the ko, ja, and zh versions so the anchors referenced from the FAQ
stay consistent.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 80519c67-b5a7-41cd-a5a5-e0ea3273a97e

📥 Commits

Reviewing files that changed from the base of the PR and between 4ab730c and 2c3a64d.

📒 Files selected for processing (2)
  • ko/agent-tools/cloud.mdx
  • zh/agent-tools/cloud.mdx

Comment thread zh/agent-tools/cloud.mdx Outdated
Add stable FAQ anchor IDs for install and credits sections, fix zh Wan 2.2 naming, and improve marketplace step wording.
@comfyui-wiki comfyui-wiki merged commit f2af415 into main Jul 3, 2026
9 of 10 checks passed
@github-actions github-actions Bot deleted the docs/cloud-mcp-client-tabs branch July 3, 2026 05:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant