Skip to content

docs: rename to /agent-tools/mcp and /agent-tools/cli#1261

Merged
comfyui-wiki merged 2 commits into
mainfrom
docs/shorten-mcp-cli-urls
Jul 14, 2026
Merged

docs: rename to /agent-tools/mcp and /agent-tools/cli#1261
comfyui-wiki merged 2 commits into
mainfrom
docs/shorten-mcp-cli-urls

Conversation

@comfyui-wiki

@comfyui-wiki comfyui-wiki commented Jul 14, 2026

Copy link
Copy Markdown
Member

Summary

  • Rename Comfy Cloud MCP docs from /agent-tools/cloud/agent-tools/mcp (locales: /zh|ja|ko/agent-tools/mcp)
  • Rename agent-oriented Comfy CLI overview from /agent-tools/comfy-cli/agent-tools/cli
  • Update docs.json navigation and internal links
  • Redirect old paths; also redirect mistaken top-level /mcp and /cli if anything linked there briefly

Redirects

Old New
/agent-tools/cloud /agent-tools/mcp
/agent-tools/comfy-cli /agent-tools/cli
/development/cloud/mcp-server /agent-tools/mcp
/mcp, /cli (safety) /agent-tools/mcp, /agent-tools/cli
(+ zh / ja / ko equivalents)

Full CLI reference remains at /comfy-cli/getting-started. Overview stays at /agent-tools.

Test plan

  • /agent-tools/mcp and /agent-tools/cli render in the Agent Tools / MCP nav
  • /agent-tools/cloud and /agent-tools/comfy-cli redirect correctly
  • Spot-check zh/ja/ko paths and redirects
  • Spot-check homepage / overview internal links

Rename agent-tools/cloud → /mcp and agent-tools/comfy-cli → /cli (all locales), update nav and internal links, and redirect old paths plus the prior /development/cloud/mcp-server aliases.
@mintlify

mintlify Bot commented Jul 14, 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 14, 2026, 3:44 AM

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

@coderabbitai

coderabbitai Bot commented Jul 14, 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: a5b629f0-d4bc-4d23-b00e-5c501f1fcf2c

📥 Commits

Reviewing files that changed from the base of the PR and between 544f806 and 4ab383c.

📒 Files selected for processing (33)
  • agent-tools/cli.mdx
  • agent-tools/index.mdx
  • agent-tools/local.mdx
  • agent-tools/mcp.mdx
  • agent-tools/partner-mcp.mdx
  • development/overview.mdx
  • docs.json
  • index.mdx
  • ja/agent-tools/cli.mdx
  • ja/agent-tools/index.mdx
  • ja/agent-tools/local.mdx
  • ja/agent-tools/mcp.mdx
  • ja/agent-tools/partner-mcp.mdx
  • ja/development/overview.mdx
  • ja/index.mdx
  • ko/agent-tools/cli.mdx
  • ko/agent-tools/index.mdx
  • ko/agent-tools/local.mdx
  • ko/agent-tools/mcp.mdx
  • ko/agent-tools/partner-mcp.mdx
  • ko/development/overview.mdx
  • ko/index.mdx
  • snippets/comfy-cli/agent-skills.mdx
  • snippets/ja/comfy-cli/agent-skills.mdx
  • snippets/ko/comfy-cli/agent-skills.mdx
  • snippets/zh/comfy-cli/agent-skills.mdx
  • zh/agent-tools/cli.mdx
  • zh/agent-tools/index.mdx
  • zh/agent-tools/local.mdx
  • zh/agent-tools/mcp.mdx
  • zh/agent-tools/partner-mcp.mdx
  • zh/development/overview.mdx
  • zh/index.mdx

📝 Walkthrough

Walkthrough

Updated English and localized documentation navigation, cross-links, translation metadata, and redirects to use canonical /agent-tools/mcp and /agent-tools/cli routes, with localized short-path redirects and legacy-route compatibility.

Changes

MCP and CLI route migration

Layer / File(s) Summary
Navigation and redirect mapping
docs.json
Navigation entries now use canonical MCP and CLI paths, while legacy, short, and development routes redirect to the corresponding pages.
English documentation links
index.mdx, agent-tools/*.mdx, snippets/comfy-cli/*
English landing pages, Agent Tools pages, and CLI skill notes reference the updated MCP and CLI routes.
Localized documentation links
ja/..., ko/..., zh/...
Localized landing pages, development pages, partner pages, and local MCP pages use localized canonical routes.
Localized canonical page metadata and references
*/agent-tools/cli.mdx, */agent-tools/mcp.mdx, snippets/{ja,ko,zh}/comfy-cli/*
Localized translation sources and MCP/CLI cross-links were updated to the canonical page paths.

Possibly related PRs

  • Comfy-Org/docs#1236: Adds the local MCP documentation page containing related MCP and CLI links updated here.

Suggested reviewers: mattmillerai, lin-bot23

🚥 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/shorten-mcp-cli-urls
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch docs/shorten-mcp-cli-urls

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.

Correct the rename to keep pages under agent-tools (not top-level /mcp or /cli). Redirect old /agent-tools/cloud and /agent-tools/comfy-cli paths, plus the mistaken short URLs from the prior commit.
@comfyui-wiki comfyui-wiki changed the title docs: shorten Cloud MCP and CLI URLs to /mcp and /cli docs: rename to /agent-tools/mcp and /agent-tools/cli Jul 14, 2026

@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: 3

🤖 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 `@agent-tools/local.mdx`:
- Line 12: In agent-tools/local.mdx, simplify the sentence at lines 12-12 by
replacing the em dash with a period and splitting the stacked clauses into
shorter sentences. At lines 153-155, replace each em dash with a colon; no other
changes are needed.

In `@agent-tools/partner-mcp.mdx`:
- Line 134: Update the Comfy Cloud MCP documentation entry by replacing the em
dash after the link with a colon or a separate sentence, preserving the existing
meaning and link.

In `@ja/agent-tools/local.mdx`:
- Line 22: Remove em-dash punctuation from the edited prose: in
ja/agent-tools/local.mdx lines 22-22, replace the dash after 「ローカル MCP サーバー」
with direct sentence punctuation; in ja/agent-tools/partner-mcp.mdx lines
147-147, replace the dash after the link with a comma, colon, or separate
sentence; and in zh/mcp.mdx lines 496-496, replace `——` before the Comfy CLI
link with direct punctuation.
🪄 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: 9f75f762-6a71-4567-8668-0199da6ea8f4

📥 Commits

Reviewing files that changed from the base of the PR and between 36378b6 and 544f806.

📒 Files selected for processing (33)
  • agent-tools/index.mdx
  • agent-tools/local.mdx
  • agent-tools/partner-mcp.mdx
  • cli.mdx
  • development/overview.mdx
  • docs.json
  • index.mdx
  • ja/agent-tools/index.mdx
  • ja/agent-tools/local.mdx
  • ja/agent-tools/partner-mcp.mdx
  • ja/cli.mdx
  • ja/development/overview.mdx
  • ja/index.mdx
  • ja/mcp.mdx
  • ko/agent-tools/index.mdx
  • ko/agent-tools/local.mdx
  • ko/agent-tools/partner-mcp.mdx
  • ko/cli.mdx
  • ko/development/overview.mdx
  • ko/index.mdx
  • ko/mcp.mdx
  • mcp.mdx
  • snippets/comfy-cli/agent-skills.mdx
  • snippets/ja/comfy-cli/agent-skills.mdx
  • snippets/ko/comfy-cli/agent-skills.mdx
  • snippets/zh/comfy-cli/agent-skills.mdx
  • zh/agent-tools/index.mdx
  • zh/agent-tools/local.mdx
  • zh/agent-tools/partner-mcp.mdx
  • zh/cli.mdx
  • zh/development/overview.mdx
  • zh/index.mdx
  • zh/mcp.mdx

Comment thread agent-tools/local.mdx Outdated
</Warning>

[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) is Comfy's **first-party local MCP server** — the official way to drive a **local** ComfyUI install from AI agents (Claude Code, Claude Desktop, Cursor, and other MCP clients). It is a thin wrapper over [comfy-cli](https://github.com/Comfy-Org/comfy-cli): each tool shells out to the `comfy` command, so `comfy-cli` is the engine and there is no code shared with the [Comfy Cloud MCP](/agent-tools/cloud).
[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) is Comfy's **first-party local MCP server** — the official way to drive a **local** ComfyUI install from AI agents (Claude Code, Claude Desktop, Cursor, and other MCP clients). It is a thin wrapper over [comfy-cli](https://github.com/Comfy-Org/comfy-cli): each tool shells out to the `comfy` command, so `comfy-cli` is the engine and there is no code shared with the [Comfy Cloud MCP](/mcp).

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Remove em dashes and simplify sentence structures.

As per coding guidelines, English documentation must avoid em dashes (—) and prefer short, direct sentences over stacked clauses. These tricky little lines gave me quite a fright, so let's split them up and make them right!

  • agent-tools/local.mdx#L12-L12: replace the em dash with a period and split the stacked clauses into shorter sentences.
  • agent-tools/local.mdx#L153-L155: replace the em dashes with colons.
✨ Proposed fixes

agent-tools/local.mdx#L12-L12

-[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) is Comfy's **first-party local MCP server** — the official way to drive a **local** ComfyUI install from AI agents (Claude Code, Claude Desktop, Cursor, and other MCP clients). It is a thin wrapper over [comfy-cli](https://github.com/Comfy-Org/comfy-cli): each tool shells out to the `comfy` command, so `comfy-cli` is the engine and there is no code shared with the [Comfy Cloud MCP](/mcp).
+[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) is Comfy's **first-party local MCP server**. It is the official way to drive a **local** ComfyUI install from AI agents (Claude Code, Claude Desktop, Cursor, and other MCP clients). It is a thin wrapper over [comfy-cli](https://github.com/Comfy-Org/comfy-cli). Each tool shells out to the `comfy` command, making `comfy-cli` the engine. There is no code shared with the [Comfy Cloud MCP](/mcp).

agent-tools/local.mdx#L153-L155

-- [Comfy Cloud MCP](/mcp) — hosted MCP server, no local install or GPU needed
-- [Comfy Partner MCP](/agent-tools/partner-mcp) — local server for 30+ partner providers via the Comfy API
-- [Comfy CLI](/cli) — drive local ComfyUI and partner generation from the terminal
+- [Comfy Cloud MCP](/mcp): hosted MCP server, no local install or GPU needed
+- [Comfy Partner MCP](/agent-tools/partner-mcp): local server for 30+ partner providers via the Comfy API
+- [Comfy CLI](/cli): drive local ComfyUI and partner generation from the terminal
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) is Comfy's **first-party local MCP server**the official way to drive a **local** ComfyUI install from AI agents (Claude Code, Claude Desktop, Cursor, and other MCP clients). It is a thin wrapper over [comfy-cli](https://github.com/Comfy-Org/comfy-cli): each tool shells out to the `comfy` command, so `comfy-cli` is the engine and there is no code shared with the [Comfy Cloud MCP](/mcp).
[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) is Comfy's **first-party local MCP server**. It is the official way to drive a **local** ComfyUI install from AI agents (Claude Code, Claude Desktop, Cursor, and other MCP clients). It is a thin wrapper over [comfy-cli](https://github.com/Comfy-Org/comfy-cli). Each tool shells out to the `comfy` command, making `comfy-cli` the engine. There is no code shared with the [Comfy Cloud MCP](/mcp).
Suggested change
[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) is Comfy's **first-party local MCP server** — the official way to drive a **local** ComfyUI install from AI agents (Claude Code, Claude Desktop, Cursor, and other MCP clients). It is a thin wrapper over [comfy-cli](https://github.com/Comfy-Org/comfy-cli): each tool shells out to the `comfy` command, so `comfy-cli` is the engine and there is no code shared with the [Comfy Cloud MCP](/mcp).
- [Comfy Cloud MCP](/mcp): hosted MCP server, no local install or GPU needed
- [Comfy Partner MCP](/agent-tools/partner-mcp): local server for 30+ partner providers via the Comfy API
- [Comfy CLI](/cli): drive local ComfyUI and partner generation from the terminal
🧰 Tools
🪛 GitHub Check: Mintlify Validation (dripart) - vale-spellcheck

[warning] 12-12: agent-tools/local.mdx#L12
Did you really mean 'Comfy's'?

📍 Affects 1 file
  • agent-tools/local.mdx#L12-L12 (this comment)
  • agent-tools/local.mdx#L153-L155
🤖 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 `@agent-tools/local.mdx` at line 12, In agent-tools/local.mdx, simplify the
sentence at lines 12-12 by replacing the em dash with a period and splitting the
stacked clauses into shorter sentences. At lines 153-155, replace each em dash
with a colon; no other changes are needed.

Source: Coding guidelines

Comment thread agent-tools/partner-mcp.mdx Outdated
## Related

- [Comfy Cloud MCP](/agent-tools/cloud) — Hosted MCP server for Comfy Cloud workflow execution
- [Comfy Cloud MCP](/mcp) — Hosted MCP server for Comfy Cloud workflow execution

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Replace the em dash in this changed documentation line.

Line 134 uses an em dash. Please use a colon or a second sentence instead. Tiny dash, easy slash.

As per coding guidelines: In English documentation, avoid em dashes (—); use periods, commas, colons, parentheses, or a second sentence.

🤖 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 `@agent-tools/partner-mcp.mdx` at line 134, Update the Comfy Cloud MCP
documentation entry by replacing the em dash after the link with a colon or a
separate sentence, preserving the existing meaning and link.

Source: Coding guidelines

Comment thread ja/agent-tools/local.mdx Outdated
</Warning>

[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) は Comfy の **ファーストパーティのローカル MCP サーバー** — AI エージェント (Claude Code、Claude Desktop、Cursor、およびその他の MCP クライアント) から **ローカル**の ComfyUI インストールを操作する公式の方法です。これは [comfy-cli](https://github.com/Comfy-Org/comfy-cli) の薄いラッパーであり、各ツールは `comfy` コマンドをシェルアウトし、comfy-cli がエンジンとして機能します。[Comfy Cloud MCP](/ja/agent-tools/cloud) とのコード共有はありません。
[**comfy-local-mcp**](https://github.com/Comfy-Org/comfy-local-mcp) は Comfy の **ファーストパーティのローカル MCP サーバー** — AI エージェント (Claude Code、Claude Desktop、Cursor、およびその他の MCP クライアント) から **ローカル**の ComfyUI インストールを操作する公式の方法です。これは [comfy-cli](https://github.com/Comfy-Org/comfy-cli) の薄いラッパーであり、各ツールは `comfy` コマンドをシェルアウトし、comfy-cli がエンジンとして機能します。[Comfy Cloud MCP](/ja/mcp) とのコード共有はありません。

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Remove em dashes from the edited MDX prose.

These three changed lines use em dashes where the repository guideline requires commas, colons, parentheses, or separate sentences.

  • ja/agent-tools/local.mdx#L22-L22: replace the em dash after 「ローカル MCP サーバー」 with direct sentence punctuation.
  • ja/agent-tools/partner-mcp.mdx#L147-L147: replace the em dash after the link with a comma, colon, or second sentence.
  • zh/mcp.mdx#L496-L496: replace —— before the Comfy CLI link with direct punctuation.
📍 Affects 3 files
  • ja/agent-tools/local.mdx#L22-L22 (this comment)
  • ja/agent-tools/partner-mcp.mdx#L147-L147
  • zh/mcp.mdx#L496-L496
🤖 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 `@ja/agent-tools/local.mdx` at line 22, Remove em-dash punctuation from the
edited prose: in ja/agent-tools/local.mdx lines 22-22, replace the dash after
「ローカル MCP サーバー」 with direct sentence punctuation; in
ja/agent-tools/partner-mcp.mdx lines 147-147, replace the dash after the link
with a comma, colon, or separate sentence; and in zh/mcp.mdx lines 496-496,
replace `——` before the Comfy CLI link with direct punctuation.

Source: Coding guidelines

@comfyui-wiki
comfyui-wiki merged commit 7256555 into main Jul 14, 2026
13 of 14 checks passed
@github-actions
github-actions Bot deleted the docs/shorten-mcp-cli-urls branch July 14, 2026 03:48
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