Skip to content

docs: fix slash-command claim and add /comfy /cloud FAQ in Cloud MCP page#1186

Merged
comfyui-wiki merged 2 commits into
mainfrom
matt/be-1877-cloud-mcp-slash-commands
Jun 28, 2026
Merged

docs: fix slash-command claim and add /comfy /cloud FAQ in Cloud MCP page#1186
comfyui-wiki merged 2 commits into
mainfrom
matt/be-1877-cloud-mcp-slash-commands

Conversation

@mattmillerai

Copy link
Copy Markdown
Contributor

ELI-5

The Cloud MCP docs told people who connect without the plugin that they get "no slash commands." That's wrong — connecting directly still gives you slash commands, just in the longer raw form like /mcp__comfy-cloud__generate-image. This PR fixes that line and adds an FAQ for the common mistake of typing /comfy or /cloud (neither exists) so users know the two real command prefixes and that they can also just ask in plain language.

What changed

agent-tools/cloud.mdx (English source of truth):

  1. "Prefer just the connection, without the plugin?" accordion — dropped the inaccurate "(no slash commands)" claim and added a paragraph explaining the direct path surfaces the server's MCP prompts as /mcp__comfy-cloud__<name> commands (with examples), noting the plugin is recommended because it wraps them as the friendlier /comfy-cloud:* form.
  2. New FAQ accordion — "I typed /comfy or /cloud and nothing came up." Explains there is no /comfy or /cloud, lists both real prefixes (plugin /comfy-cloud: and direct /mcp__comfy-cloud__), and points to the plain-language fallback.

Why

The previous "no slash commands" wording misled a reporter: the deployed MCP server already exposes prompts on the HTTP transport, and Claude Code surfaces those as /mcp__<configname>__<prompt> slash commands when the server is added via claude mcp add.

Verification

  • mint broken-linkssuccess, no broken links found.
  • Accordion / AccordionGroup / Steps tags balanced; code fences paired.

Judgment call — i18n (English only)

The zh/, ja/, ko/ copies of this page are machine-maintained: each stores a translationSourceHash of the English source, and npm run translate fully re-translates a page whenever that hash changes (README: "English MDX at the repo root is the source of truth … contributors do not need to hand-translate every page"). Editing this English file changes the hash, so the translated pages are now flagged stale and will be regenerated by the translation pipeline — hand-edits here would just be overwritten. The i18n-sync-check bot will post its reminder on this PR. No translated MDX is included by design.

… MCP

The 'without the plugin' accordion wrongly said the direct-connection path
has no slash commands. The deployed MCP server exposes prompts that surface
as /mcp__comfy-cloud__<name> commands, so document that form and add an FAQ
entry for users who type /comfy or /cloud and see nothing.
@mintlify

mintlify Bot commented Jun 27, 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 Jun 27, 2026, 10:08 AM

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

@mattmillerai mattmillerai added cursor-review Trigger Cursor automated review agent-coded PR authored by the agent-work loop labels Jun 27, 2026
@mattmillerai mattmillerai marked this pull request as ready for review June 27, 2026 10:05
@github-actions

Copy link
Copy Markdown

🌐 i18n translation sync reminder

@comfyui-wiki English documentation was updated in this PR. Please complete or schedule translation updates for the following files:

Japanese (ja)

  • ja/agent-tools/cloud.mdx

Simplified Chinese (zh)

  • zh/agent-tools/cloud.mdx

Korean (ko)

  • ko/agent-tools/cloud.mdx

Local sync: npm run translate (see README — Automated translation)

@coderabbitai

coderabbitai Bot commented Jun 27, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

Pull request was closed or merged during review

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: ab10547a-0892-4cdb-97cc-5c651108397a

📥 Commits

Reviewing files that changed from the base of the PR and between 955aea3 and 9c75cb3.

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

📝 Walkthrough

Walkthrough

Updated the Comfy Cloud MCP docs across languages, including metadata and wording, direct claude mcp add setup, raw /mcp__... versus /comfy-cloud:* commands, and FAQ guidance for prefix usage. Tiny wording tweaks, big command clarity—no smoke, just schema-spoke.

Changes

Comfy Cloud MCP docs localization and command guidance

Layer / File(s) Summary
Metadata and copy updates
agent-tools/cloud.mdx, ja/agent-tools/cloud.mdx, ko/agent-tools/cloud.mdx, zh/agent-tools/cloud.mdx
Translated metadata, overview text, and localized labels/sentences were updated across the docs.
Direct MCP setup guidance
agent-tools/cloud.mdx, ja/agent-tools/cloud.mdx, ko/agent-tools/cloud.mdx, zh/agent-tools/cloud.mdx
The direct-connection instructions now show claude mcp add setup and explain raw /mcp__... prefixes versus the /comfy-cloud:* plugin wrapper.
Command prefix FAQ
agent-tools/cloud.mdx, ja/agent-tools/cloud.mdx, ko/agent-tools/cloud.mdx, zh/agent-tools/cloud.mdx
The FAQ adds the /comfy and /cloud note, describes the valid prefixes for plugin and direct connections, and refreshes the browser-login guidance.
🚥 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 matt/be-1877-cloud-mcp-slash-commands
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch matt/be-1877-cloud-mcp-slash-commands

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

@comfyui-wiki

Copy link
Copy Markdown
Member

@mattmillerai, is the English version good to merge now? I can help run the translation script. I haven't fully made it work on github

Refined the descriptions in Japanese, Korean, and Chinese versions for consistency and clarity. Added colons in place of dashes for better readability in various sections. Updated translation source hash to reflect recent changes.
@comfyui-wiki comfyui-wiki merged commit 362e34e into main Jun 28, 2026
9 of 10 checks passed
@github-actions github-actions Bot deleted the matt/be-1877-cloud-mcp-slash-commands branch June 28, 2026 04:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent-coded PR authored by the agent-work loop cursor-review Trigger Cursor automated review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants