Strapi MCP server for content management by pwizla · Pull Request #3194 · strapi/documentation

pwizla · 2026-05-20T16:41:44Z

This PR adds documentation for Strapi's built-in MCP server and reorganizes the AI docs section.

New feature page for the Strapi MCP server at cms/features/strapi-mcp-server.md
Extracted Docs MCP server content from for-developers.md into its own page at cms/ai/docs-mcp-server.md
Restructured AI pages for content managers and developers with MCP server cards
Removed adminTokens feature flag references
Fixed sentence case and terminology consistency across touched pages

Direct preview link 👉 here

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Admin tokens are no longer behind a future flag. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vercel · 2026-05-20T16:41:50Z

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

Project	Deployment	Actions	Updated (UTC)
documentation	Ready	Preview, Comment	May 21, 2026 4:17pm

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

nclsndr

Thank you for leading the way @pwizla!

nclsndr · 2026-05-21T12:35:45Z

+- **Components**: Component fields are passed as untyped (`any`) in tool schemas. The AI client can read and write component data, but the schema does not describe the component's internal structure.
+- **Dynamic zones**: Dynamic zone fields are passed as untyped arrays in tool schemas.
+- **Relations**: Relation fields accept document IDs (e.g., `"z7v8zma53x01r6oceimv922b"`) as input. The advanced `connect`/`disconnect` relation syntax is not yet supported in MCP tool schemas.
+- **Nested population parameters**: The `list` and `get` tools do not support nested population parameters for relations.
+- **Media upload**: Media fields accept existing media asset references but the MCP server cannot upload new files. Use Strapi's media library or upload API to add files first, then reference them in MCP tool calls.
+- **Custom fields**: Custom fields registered via plugins are mapped to their underlying Strapi type. If the custom field registry is not populated when MCP tools are registered, the custom field falls back to an `unknown` type.


This might/should change before release

Noted, Nico, thanks!
If it's updated while I'm off, feel free to create suggestions in GH comments and commit them 😊

Co-authored-by: Nico André <nicolas.andre@strapi.io>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

pwizla · 2026-05-21T16:19:41Z

+| "Create an article in French with the title 'Bonjour le monde'." | Creates a draft article with `locale` set to `fr` |


+#### Internationalization (i18n)


@nclsndr Added this part to try to handle this QA issue
WDYT?

pwizla and others added 14 commits May 20, 2026 12:37

Add MCP server feature page and reorganize AI section

cf06ab5

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Use small cards for MCP server references

a5ccd57

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Use standard cards with description for MCP server references

c3dd434

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Clarify Docs MCP server reference in tips section

6e74b40

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Rewrite MCP server page following feature template

08dce3d

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add MCP server and Docs MCP server to sidebar

8d93df4

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Remove adminTokens feature flag references

ac5fcf3

Admin tokens are no longer behind a future flag. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

WIP

9577b80

Add Tldr to Docs MCP server page

832296a

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Improve Docs MCP server page

bcec8e2

Add Windsurf configuration to both MCP server pages

0358c31

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Move tips

21d4c81

Fix Claude Desktop config to use mcp-remote

8a72f95

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add note about host & port

4c679da

github-actions Bot added pr: new content PRs for new product features or new documentation sections source: repo PRs/issues not targeting a specific documentation but rather affecting the whole repo internal PRs created by the Strapi core team labels May 20, 2026

pwizla added 2 commits May 20, 2026 18:43

Update sidebar

4e9226c

Update LLM files

6c206b8

vercel Bot had a problem deploying to Preview May 20, 2026 16:45 Failure

pwizla and others added 2 commits May 20, 2026 18:46

Remove superpowers files and add to gitignore

b14f383

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Remove superpowers files from tracking

bdd2e62

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vercel Bot had a problem deploying to Preview May 20, 2026 16:48 Failure

pwizla changed the title ~~Add MCP server feature page and reorganize AI section~~ Strapi MCP server for content management May 20, 2026

Fix broken link to strapi-mcp-server page

64fb1fe

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

pwizla self-assigned this May 20, 2026

pwizla added this to the 7.0.0-beta.1 milestone May 20, 2026

pwizla added the flag: merge pending release Pending Strapi Release label May 20, 2026

pwizla removed this from the 7.0.0-beta.1 milestone May 20, 2026

pwizla added 3 commits May 21, 2026 11:32

Fix ambiguous double it in locale filtering paragraph

9c389a0

Clarify ambiguous the field in custom fields limitation

287b7d4

Rename gerund headings to noun form for parallel structure

f524810

vercel Bot deployed to Preview May 21, 2026 09:33 View deployment

pwizla added 8 commits May 21, 2026 11:37

Link Docs MCP server intro to Ask AI button for reader context

ef5e126

Replace informal Flips with Changes in prompt examples table

7fe9249

Link FAQ Docs MCP server to dedicated page instead of anchor

bac7b73

Standardize AI assistant to AI client for consistent terminology

118cf30

Fix Admin Tokens heading and title to sentence case

634d97b

Capitalize Admin tokens consistently in admin-tokens page

139395a

Fix FAQ heading to sentence case

01f1df2

Standardize AI assistant to AI client in for-content-managers

926b06f

vercel Bot deployed to Preview May 21, 2026 09:43 View deployment

vercel Bot deployed to Preview May 21, 2026 09:44 View deployment

pwizla requested a review from nclsndr May 21, 2026 10:20

nclsndr reviewed May 21, 2026

View reviewed changes

pwizla and others added 4 commits May 21, 2026 17:53

Update docusaurus/docs/cms/features/strapi-mcp-server.md

3e2dde0

Co-authored-by: Nico André <nicolas.andre@strapi.io>

Update docusaurus/docs/cms/features/strapi-mcp-server.md

420cd0e

Co-authored-by: Nico André <nicolas.andre@strapi.io>

Update docusaurus/docs/cms/features/strapi-mcp-server.md

2d25207

Co-authored-by: Nico André <nicolas.andre@strapi.io>

Update docusaurus/docs/cms/features/strapi-mcp-server.md

4fc2e89

Co-authored-by: Nico André <nicolas.andre@strapi.io>

vercel Bot deployed to Preview May 21, 2026 15:56 View deployment

pwizla and others added 3 commits May 21, 2026 17:56

Update docusaurus/docs/cms/features/strapi-mcp-server.md

1f83663

Co-authored-by: Nico André <nicolas.andre@strapi.io>

Update docusaurus/docs/cms/features/strapi-mcp-server.md

3a09e74

Co-authored-by: Nico André <nicolas.andre@strapi.io>

Update docusaurus/docs/cms/features/strapi-mcp-server.md

7119045

Co-authored-by: Nico André <nicolas.andre@strapi.io>

vercel Bot deployed to Preview May 21, 2026 15:59 View deployment

Update docusaurus/docs/cms/features/strapi-mcp-server.md

a975260

Co-authored-by: Nico André <nicolas.andre@strapi.io>

vercel Bot deployed to Preview May 21, 2026 16:01 View deployment

Add i18n usage section and locale prompt example

a19b5ae

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vercel Bot deployed to Preview May 21, 2026 16:17 View deployment

pwizla commented May 21, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Strapi MCP server for content management#3194

Strapi MCP server for content management#3194
pwizla wants to merge 50 commits into
mainfrom
cms/mcp-server

pwizla commented May 20, 2026 •

edited

Loading

Uh oh!

vercel Bot commented May 20, 2026 •

edited

Loading

Uh oh!

nclsndr left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nclsndr May 21, 2026

Uh oh!

pwizla May 21, 2026

Uh oh!

pwizla May 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		\| "Create an article in French with the title 'Bonjour le monde'." \| Creates a draft article with `locale` set to `fr` \|


		#### Internationalization (i18n)

Conversation

pwizla commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel Bot commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nclsndr left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nclsndr May 21, 2026

Choose a reason for hiding this comment

Uh oh!

pwizla May 21, 2026

Choose a reason for hiding this comment

Uh oh!

pwizla May 21, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

pwizla commented May 20, 2026 •

edited

Loading

vercel Bot commented May 20, 2026 •

edited

Loading