Fix broken links: renamed auth and Slack anchors, translated anchors

[mintlify]

Summary

Fixes stale anchor links in English, es, fr and zh. Readers were landing at the top of the target page instead of the right section. The two known defects from the closed English-only attempt are now fixed in every language. I also fixed the other genuine breakages that mint broken-links --check-anchors found.

Changes

• ai/model-context-protocol (en/es/fr/zh): #restrict-pages-to-specific-user-groups now points to #control-access-with-groups.
• migration-services/go-live-checklist (en/es/fr/zh): #add-the-agent-to-slack now points to #connect-your-slack-workspace. The link text now matches the heading in each language.
• changelog (en/es/fr/zh): /ai/skillmd#discovery now points to #skills-discovery-endpoints.
• changelog (en/es/fr/zh): the relative link ai/model-context-protocol#search-filtering-parameters now points to /ai/model-context-protocol#search-parameters, locale-prefixed in translations.
• changelog (en/es/fr/zh): the relative link organize/settings#api-configurations now points to /organize/settings-api, locale-prefixed in translations.
• Icon snippets (en/es/fr/zh): #param-icons now points to /organize/settings-appearance#icons. Translated copies also used the old /organize/settings page.
• Translated headings missing their English anchor now have <div id> wrappers (es/fr/zh): api-playground/asyncapi-setup (examples-with-nested-groups), deploy/gitlab-self-hosted (network-requirements), the gitlab-automation-setup snippet (gitlab-setup) and components/icons (custom-image-icons, linked from the translated offline export page).
• changelog and organize/settings-reference (es/fr/zh): nine links to #split-configuration-with-%24ref now point to #split-configuration-with-ref, the id the translated settings pages use. Renaming those div ids to the %24ref form didn't resolve with --check-anchors, so the links changed instead.
• api-playground/overview (fr/zh): the translated "All supported languages" accordion now has id="all-supported-languages".

Notes for reviewers

• mint broken-links passes. mint validate could not run in the sandbox because it needs internet access.
• I left a few --check-anchors findings unchanged because I couldn't confirm they're actually broken. They target headings that contain badges, code or punctuation: settings-reference#name, settings-structure#navigation, settings-api#api-params, settings-reference#navigation-global-languages, settings-appearance#theme, settings-reference#thumbnails-background, seo#sitemaps-and-robotstxt-files, /ai/llmstxt#llms-fulltxt and /guides/geo#allow-ai-agents-in-robotstxt. The checker's slugs may not match what the site renders for these headings.
• es/fr/zh/customize/custom-scripts links to a #data-attributes section that doesn't exist in any language. The English page doesn't have that sentence, so the translation has drifted. I'd leave it for the next translation sync rather than guess at a target.

---

Note

Low Risk
Documentation-only link and anchor fixes with no runtime, auth, or application code changes.

Overview
Repairs stale and broken in-doc links across English, Spanish, French, and Chinese so deep links land on the correct sections instead of the page top.

Anchor and path updates include MCP auth (#control-access-with-groups), Slack setup (#connect-your-slack-workspace), agent-skills (#skills-discovery-endpoints), MCP search (#search-parameters), API settings (/organize/settings-api), icon config (settings-appearance#icons), and $ref docs (#split-configuration-with-ref). Changelog entries get corrected relative URLs and locale-prefixed paths where translations were wrong.

Missing fragment IDs on translated headings are added via <div id="…"> wrappers (e.g. AsyncAPI nested groups, GitLab network requirements, custom image icons) and id="all-supported-languages" on accordions in fr/zh, matching English anchor behavior for mint broken-links --check-anchors.

^{Reviewed by Cursor Bugbot for commit 523e7d2. 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	Oct 6, 2026, 10:12 PM