MCP on Studio

Agent instruction files tell agents how to work with a Studio site, but they do not give agents direct access to it. For that, Studio also exposes an MCP (Model Context Protocol) server that agents connect to in order to create, start, stop, and interact with your local WordPress sites.

To connect an agent, go to Settings → MCP in Studio and copy the JSON configuration shown there. Add it to your agent’s MCP settings. For example, for Claude Code or Codex you can also run the connection command directly from the terminal:

{
  "wordpress-studio": {
    "command": "studio",
    "args": ["mcp"]
  }
}

Common configuration file locations are:

• Claude Desktop
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
• Cursor:
  • Project: .cursor/mcp.json
  • Global ~/.cursor/mcp.json

See the full setup guides for Claude Code, Claude Desktop, Codex, Cursor, Windsurf, VS Code.

Once connected, the agent can use Studio tools such as creating sites, running WP-CLI commands, and taking screenshots, in addition to reading the instruction files and skills already present in the site directory.