Skip to content
The Docs Report
Tuesday, November 17, 2026NewsletterRSS

Redocly Deprecates the reunite and mcp.docs Config Names

Redocly's Nov. 4 Framework 0.140.0 renames reunite to platform, moves mcp.docs options up to mcp, and patches dompurify and its MCP server.

2 min read

RedoclyMCPConfig

Product photo of a white padlock on a cherry red, orange and hot pink gradient

Redocly’s Framework 0.140.0 deprecates two config names in redocly.yaml: reunite becomes platform, and the options under mcp.docs move up to mcp. The old names still work but print warnings in the build log, according to the Redocly changelog entry dated Nov. 4.

Old config names keep building but now warn

The reunite option and the access.rbac.reunite scope are renamed platform and access.rbac.platform. The mcp.docs object is deprecated, and options such as name and ignore now sit directly under mcp. Projects using the old names still build with a warning. A platform entry dated Oct. 31 added the platform option and the access.rbac.platform scope.

Security patches cover the MCP server and dompurify

Redocly updated dompurify to 3.4.17, which closes three advisories, and @modelcontextprotocol/server to 2.3.1, which closes three more. It also bumped minimatch to 11.0.3 and zod to 4.6.6, each tied to one advisory. A separate fix addresses a request that could use excessive memory in the Docs MCP server.

The Docs MCP server also changed behavior. When mcp.name is unset, server names now derive from the domain so they stay unique. Sessions last 30 days instead of 24 hours when refresh tokens are issued.

Markdown alerts, prompt actions and code samples

Markdown pages now render GitHub-style alerts (> [!NOTE], > [!TIP], > [!IMPORTANT], > [!WARNING] and > [!CAUTION]) as admonitions. In the prompt tag, Open in Claude and Open in ChatGPT now launch the desktop apps instead of web chats, and Open in Claude starts a Claude Code session. Copy prompt is now the main button.

A new options attribute on openapi-code-sample overrides the API’s openapi settings for one sample. Setting codeSamples.skipOptionalParameters to true drops optional headers, query parameters and cookies. C# samples now send numbers, booleans and nulls with the right types. Markdoc moves to Redocly’s fork, @redocly/markdoc, and tags importing from @markdoc/markdoc keep working. The release lists about 50 fixes, including accessibility work on the sidebar, tabs and search.

Key takeaways

  • Framework 0.140.0, dated Nov. 4, deprecates reunite in favor of platform.
  • Options under mcp.docs move to mcp; old names warn but still build.
  • Docs MCP sessions now last 30 days when refresh tokens are issued.
  • Dependency patches cover dompurify, the MCP server package, minimatch and zod.

The take

We think a deprecation warning is a deadline with the date left off. Rename the old keys now. Search redocly.yaml for reunite and mcp.docs, change both and rebuild.

The session change matters for access control. A 30-day session means a stolen token stays useful longer. If your docs MCP server sits behind sign-in, check that 30 days fits your access policy.