Skip to content

TINYDOC-3571 - Add the Build with AI page for the agent skill and documentation MCP server - #4301

Draft
kemister85 wants to merge 7 commits into
tinymce/8from
hotfix/8/TINYDOC-3568
Draft

TINYDOC-3571 - Add the Build with AI page for the agent skill and documentation MCP server#4301
kemister85 wants to merge 7 commits into
tinymce/8from
hotfix/8/TINYDOC-3568

Conversation

@kemister85

@kemister85 kemister85 commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Ticket: TINYDOC-3571

Related: TINYDOC-3572 (the tinymce/skills repository this page documents), TINYDOC-3568 / docs-antora-ui#44 (the Ask AI widget half)

Site: Staging branch

Changes:

  • Added modules/ROOT/pages/ai-coding-agents.adoc — a new Getting started page covering both halves of agent support: the official TinyMCE agent skill (npx skills add tinymce/skills) and the documentation access surfaces.
  • Skill sections: what the skill does, supported agents, and alternative install paths (Claude Code plugin marketplace, manual copy).
  • Documentation access sections: the hosted Kapa MCP server (https://tinymcedocs.mcp.kapa.ai) with per-agent configuration for Claude Code, Cursor, Codex, Visual Studio Code and OpenCode; the markdown form of every page; and the llms.txt / llms-full.txt files.
  • Added a nav entry under Getting started, after Upgrading TinyMCE, and a third cell in the Getting started index table.

This is the documentation half of the AI widget MCP work. The other half is docs-antora-ui#44, which enables the Use MCP menu in the Ask AI widget; the page's "Install from the documentation site" section describes that menu and goes live when the UI bundle redeploys.

Important

Do not merge before tinymce/skills is public (TINYDOC-3572). The page documents npx skills add tinymce/skills and /plugin marketplace add tinymce/skills. Both git-clone the repository, so while it is private they fail for anyone outside the org. The repository, its manifests, and the release tags are ready; only the visibility switch is outstanding.

Notes for review:

  • Every command on the page has been run end to end against the live repository — npx skills add tinymce/skills installs the skill, and the MCP endpoint responds.
  • Verified against production: .md pages are served for every documented major version (/5/, /6/, /7/, /latest/), so the page documents version-segmented markdown rather than scoping it to latest.
  • Verified the MCP endpoint is OAuth-protected via Kapa's public authorization server. The page does not name specific SSO providers, since that could not be confirmed.
  • The Accept: text/markdown header is not supported by our docs site, so only the index.md URL form is documented.
  • The IMPORTANT admonition about configuration files not being interchangeable comes from a real failure during testing: claude mcp add writes .mcp.json, which VS Code does not read, and the result is valid JSON with no error and no tools.
  • Version scoping of the MCP server itself is not addressed, matching the open question in docs-antora-ui#44.

Pre-checks:

  • Branch is correctly prefixed:

  • Feature: feature/<version>/DOC-XXXX (e.g., feature/8.0.0/DOC-1234)

  • Hotfix: hotfix/<version>/DOC-XXXX (e.g., hotfix/8.0.0/DOC-1234)

  • EPIC: release/<ver> (e.g., release/8.0.0 for major releases)

  • modules/ROOT/nav.adoc has been updated (if applicable).

  • Files have been included where required (if applicable).

  • Files removed have been deleted, not just excluded from the build (if applicable).

  • Files added for New product features include a release note entry.

  • Major or minor version changes have updated the supported-versions.adoc table.

  • Build passes without console errors, warnings, or issues.


Review:

  • Documentation Team Lead has reviewed.

@kemister85
kemister85 requested review from a team, TheSpyder, kimwoodfield, metricjs, noxuhax and shanmen-tiny and removed request for a team August 4, 2026 06:32
@kemister85
kemister85 marked this pull request as ready for review August 4, 2026 06:32
@kemister85
kemister85 requested review from a team and soritaheng as code owners August 4, 2026 06:32
@kemister85 kemister85 changed the title TINYDOC-3568 - Add AI coding agents page for the documentation MCP server TINYDOC-3571 - Add the Build with AI page for the agent skill and documentation MCP server Aug 4, 2026
@kemister85
kemister85 marked this pull request as draft August 4, 2026 06:58
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