Skip to content

Add MCP server schema dialect and SDK v2 compatibility section - #3453

Draft
pwizla wants to merge 1 commit into
mainfrom
cms/mcp-sdk-v2-schema-compat
Draft

Add MCP server schema dialect and SDK v2 compatibility section#3453
pwizla wants to merge 1 commit into
mainfrom
cms/mcp-sdk-v2-schema-compat

Conversation

@pwizla

@pwizla pwizla commented Sep 9, 2026

Copy link
Copy Markdown
Collaborator

This PR adds a "Compatibility and schema changes" section to the MCP server page covering the SDK v2 upgrade shipped in strapi/strapi#27505. The new section explains that tool schemas are now serialized as JSON Schema 2020-12 (instead of draft-07), lists the formatting differences that strict clients will observe (prefixItems for tuples, $defs for recursive schemas), and notes that clients previously affected by the silent tool-drop bug described in strapi/strapi#27395 no longer need a workaround. It also documents that handler context and capability result types are now Strapi-owned, keeping them stable across future SDK updates.

Documents #27505

Direct preview link 👉 here

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@pwizla pwizla added flag: merge pending release Waiting for the related product PR to be merged before merging this documentation PR auto-doc-healing Automatically generated documentation PR labels Sep 9, 2026
@pwizla pwizla self-assigned this Sep 9, 2026
@strapi-cla

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@vercel

vercel Bot commented Sep 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
documentation Ready Ready Preview Sep 9, 2026 1:52am UTC

Request Review

@pwizla

pwizla commented Sep 9, 2026

Copy link
Copy Markdown
Collaborator Author

Hey @nclsndr the docs self-healing caught your changes and created this PR. Do you think we need this level of detail in the official Strapi MCP docs?
I also saw a long description and migration guide in the corresponding strapi/strapi PR; if this is considering a breaking change for the MCP, shouldn't we document this on docs.strapi.io too? 🤔

@pwizla pwizla removed the flag: merge pending release Waiting for the related product PR to be merged before merging this documentation PR label Sep 9, 2026
@pwizla pwizla added this to the 7.2.0 milestone Sep 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto-doc-healing Automatically generated documentation PR internal PRs created by the Strapi core team pr: chore source: CMS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants