Update from code changes: admin MCP page-level editor links

[mintlify]

Summary

The admin MCP save and create_node tools now return an editorUrl that opens the page that changed. Before this, the only link came from checkout, and it opened the branch on the first navigation page. save leaves out the link when it merges immediately. It links to the branch when only configuration changed. create_node returns a link for new public pages.

Triggered by https://github.com/mintlify/server/pull/8593

Changes

• ai/mintlify-mcp.mdx: covers the new editorUrl behavior in the review and save workflow steps, the create_node tool description, and the "Open the editor URL" best practice.
• Mirrored the same changes in es, fr, and zh.
• Updated the Mintlify skill file so agents use the page-level link instead of the checkout link.

---

Note

Low Risk
Documentation and agent-skill text only; no runtime or API behavior changes in this repo.

Overview
Documents page-level editorUrl responses from the admin MCP create_node and save tools (aligned with server PR #8593), and clarifies that checkout still returns a branch-level preview link.

The English Admin MCP guide (ai/mintlify-mcp.mdx) now explains when each link appears: create_node opens the new page directly; save includes a link to the first created or updated page when a PR is opened or updated (config-only changes open the branch; immediate merges omit the link). Best-practice guidance tells readers—and the Mintlify agent skill—to prefer page-level URLs from create_node / save over the checkout link.

The same wording is mirrored in es, fr, and zh locales, and agent-context/context/skills/mintlify/SKILL.md is updated so coding agents follow the new link behavior.

^{Reviewed by Cursor Bugbot for commit 2ce1c34. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated
mintlify	🟢 Ready	View Preview	Sep 25, 2026, 6:21 PM