[docs] Adding MCP playground guide#3826
Conversation
github-actions
Bot
added
the
[Type] Documentation
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Adds a new documentation guide describing how to use WordPress Playground with AI assistants via the MCP server, and wires it into the docs navigation, along with localized versions of the guide.
Changes:
- Added a new “AI assistants + MCP” guide in the main docs.
- Added localized versions of the guide (ES, plus additional locales in this PR).
- Linked the guide in the Guides sidebar.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| packages/docs/site/sidebars.js | Adds the new MCP guide to the Guides sidebar list. |
| packages/docs/site/docs/main/guides/ai-assistants-mcp.md | Introduces the new English MCP usage guide. |
| packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/main/guides/ai-assistants-mcp.md | Adds the Spanish translation of the new guide. |
| packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/main/guides/ai-assistants-mcp.md | Adds a French translation of the new guide. |
| packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/ai-assistants-mcp.md | Adds a pt-BR translation of the new guide. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
akirk
left a comment
akirk
left a comment
There was a problem hiding this comment.
Good start but I had some suggestions!
|
|
||
| # Use WordPress Playground with AI assistants through MCP | ||
|
|
||
| The WordPress Playground MCP server lets an AI assistant connect to a real Playground site running in your browser. After the connection is open, you can ask the assistant to navigate WordPress, inspect pages, reproduce issues, take screenshots, and explain what it finds. |
There was a problem hiding this comment.
"take screenshots" I think this would need the Playwright or DevTools MCP?
|
|
||
| WordPress Playground has two complementary products: the Playground website and the Playground CLI. The website is the browser experience at [playground.wordpress.net](https://playground.wordpress.net/). The CLI is the local automation environment for terminal, scripting, and CI workflows. | ||
|
|
||
| The choice depends on what you want the AI assistant to control. |
There was a problem hiding this comment.
One thing we talked about was that with the MCP the agent can make authenticated requests whereas in the CLI it would need to use curl and thus make unauthenticated requests.
The other thing is to control the displayed page in the browser using the redirect tool.
Co-authored-by: Alex Kirk <akirk@users.noreply.github.com>
This pull request adds a new guide explaining how to use WordPress Playground with AI assistants through the MCP server, and provides a full Spanish translation of the guide. The documentation covers use cases, setup instructions, and the differences between Playground MCP and CLI, making it easier for users to understand and leverage AI-powered interactions with Playground sites.
New documentation:
main/guides/ai-assistants-mcp.mdwith a comprehensive guide on using WordPress Playground with AI assistants via MCP, including use cases, setup steps, and feature overview.Localization:
i18n/es/docusaurus-plugin-content-docs/current/main/guides/ai-assistants-mcp.md, ensuring accessibility for Spanish-speaking users.