WordPress Editor Plugin for Claudaborative Editing

[pento]

Overview

Create a WordPress plugin that adds UI to the Gutenberg editor, allowing users to trigger MCP actions (review, proofread, edit, translate, etc.) directly from within WordPress — without switching to the Claude Code terminal.

Architecture

The MCP server becomes a Claude Code Channel, pushing WordPress commands into Claude's context via channel notifications. WordPress acts as the message broker between the browser and the MCP server.

Three connection layers:

1. Authentication (wp_connect / auto-connect) — existing
2. Command Listener (SSE primary, REST polling fallback) — new, runs independently of sync loop
3. Post Editing (wp_open_post / Yjs sync) — existing, triggered by commands

Key design decisions:

• Commands scoped to the authenticated WordPress user (single user per Claude Code instance)
• One post at a time (consistent with current MCP design)
• Custom post type (wpce_command) for command storage (no custom DB tables — WordPress.com compatible)
• Plugin lives in wordpress-plugin/ subdirectory of this repo
• Bundled plugin zip in npm package for easy installation before wordpress.org listing

Phases

Phase 1: Foundation

• WordPress plugin scaffold #29 WordPress plugin scaffold
• Command REST API endpoints #30 Command REST API endpoints
• MCP channel capability and command listener #31 MCP channel capability and command listener

Phase 2: Editor UI

• AI Actions sidebar panel #32 AI Actions sidebar panel
• Block editor command palette integration #33 Block editor command palette integration (early idea — needs exploration)
• Pre-publish checks via Claude #34 Pre-publish checks via Claude (early idea — needs exploration)
• Parameterized actions UI #35 Parameterized actions UI
• Command progress and notifications #36 Command progress and notifications

Phase 3: Note Enhancements

• MCP note identification via comment meta #37 MCP note identification via comment meta
• Actionable notes #38 Actionable notes

Phase 4: Installation and Compatibility

• Plugin installation and version compatibility #39 Plugin installation and version compatibility
• Graceful degradation and edge cases #40 Graceful degradation and edge cases

Phase 5: Polish

• CI and build integration #41 CI and build integration
• Documentation #42 Documentation
• wordpress.org plugin submission #43 wordpress.org plugin submission