MCP Connection Guide — Development skill for Claude Code

MCP Connection Guide

MCP Connection Guide adds a guided setup card to the WordPress Connectors screen. It helps an administrator connect Codex, Claude Code, or Claude Desktop to WordPress through the [WordPress MCP Adapter](https://github.com/WordPress/mcp-adapter).

The plugin is intentionally an onboarding layer. It does not install the MCP Adapter, register WordPress abilities, or store client credentials in Connector settings.

Status

This is an experimental prototype for WordPress 7.1. Its PHP registration uses the WordPress connector registry, while its custom interface currently relies on the experimental `@wordpress/connectors` exports `__experimentalRegisterConnector` and `__experimentalConnectorItem`. Those JavaScript APIs may change before becoming public.

Requirements

• WordPress 7.1 or newer.
• PHP 7.4 or newer.
• An available WP\MCP\Core\McpAdapter class, supplied either by the standalone MCP Adapter or by another plugin that bundles it.
• Application Passwords enabled for the current WordPress user.
• Node.js on the computer running Codex or Claude, because the generated configuration uses `@automattic/mcp-wordpress-remote`.

Installation

1. Download a release ZIP or clone this repository into wp-content/plugins/mcp-connection-guide.
2. Activate MCP Connection Guide in WordPress.
3. Open Settings → Connectors.

If the MCP Adapter class is unavailable, the guide links to the [official MCP Adapter releases](https://github.com/WordPress/mcp-adapter/releases/latest). Install or enable the adapter through your normal plugin deployment workflow, then reload the Connectors screen.

Usage

1. Find WordPress MCP on Settings → Connectors and select Set up.
2. Confirm that the MCP Adapter is available.
3. Choose Codex, Claude Code, or Claude Desktop.
4. Generate a dedicated WordPress Application Password.
5. Copy the generated command or JSON configuratio