Skip to content

TINYDOC-3545 - Add MCP live demo to the on-premises MCP documentation - #4299

Open
kemister85 wants to merge 3 commits into
tinymce/8from
hotfix/8/TINYDOC-3545
Open

TINYDOC-3545 - Add MCP live demo to the on-premises MCP documentation#4299
kemister85 wants to merge 3 commits into
tinymce/8from
hotfix/8/TINYDOC-3545

Conversation

@kemister85

@kemister85 kemister85 commented Aug 2, 2026

Copy link
Copy Markdown
Contributor

Ticket: TINYDOC-3545

Site: Staging branch

Changes:

  • Added a Demo section to modules/ROOT/pages/tinymceai-on-premises-mcp.adoc with the liveDemo::tinymceai-mcp[] macro, placed after the architecture diagram and before Prerequisites.
  • Added the live demo at modules/ROOT/examples/live-demos/tinymceai-mcp/ (index.html, index.js, example.js, style.css). The demo document uses placeholder spans that the model fills from an MCP-connected data source.
  • Added modules/ROOT/attachments/tinymceai-mcp-demo/content.css and loaded it with content_css. The live-demo extension does not serve per-demo assets, so the demo stylesheet is published as an attachment.
  • Included example.js so the JS tab shows a generic token endpoint rather than the demo key, and so the CodePen tab is suppressed.

The demo configuration is a 1:1 port of the demo linked from the ticket. Documented deviations: the selector and content_css values are adapted for the live-demo extension; font_css is omitted because the referenced file does not exist upstream.

Pre-checks:

  • Branch is correctly prefixed:
  • modules/ROOT/nav.adoc has been updated (if applicable). Not applicable: the page already has a nav entry and no new pages were added.
  • Files have been included where required (if applicable).
  • Build passes without console errors, warnings, or issues.

Review:

  • Documentation Team Lead has reviewed.

Adds a live demo to the MCP and web integrations page showing the editor
experience that MCP configuration enables. The AI service backing the demo
has an MCP server connected to a sample database of acquisition deals and
company records.

The demo uses a dedicated API key, which is required for MCP demos and is
scoped to them. The key is referenced through new antora.yml attributes and
applied with the liveDemo script_url_override attribute so no other demo
loads it. An example.js is included so the JS tab shows a generic token
endpoint and the CodePen tab is suppressed.

The demo stylesheet is published as an attachment and loaded with
content_css, as the live-demo extension does not serve per-demo assets.
@kemister85
kemister85 requested review from a team, TheSpyder, kimwoodfield, ltrouton, metricjs and noxuhax and removed request for a team August 2, 2026 23:35
@kemister85
kemister85 marked this pull request as ready for review August 2, 2026 23:35
@kemister85
kemister85 requested review from a team and soritaheng as code owners August 2, 2026 23:35
…e demo

The live demo sits inside the article column, which is reduced by the table
of contents column. On a 1440px display this left the editor content area at
341px against the 900px the demo stylesheet targets, because the AI Chat
sidebar occupies a fixed 440px.

Setting the -toc page role returns 252px to the article column, taking the
content area to 593px. This matches the other TinyMCE AI pages that host a
live demo, all of which already set this role.
Reverts the -toc page role, returning the page to the standard layout with
the table of contents column.
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