Cowboy MCP - Free MCP Server with Undo for Claude & ChatGPT
| 开发者 | februality |
|---|---|
| 更新时间 | 2026年10月21日 12:40 |
| 捐献地址: | 去捐款 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- 💬 Do everything by chat - create and edit posts and pages, run your WooCommerce shop, manage users and menus, tidy the media library, change settings, and fix errors when they crop up.
- ↩️ Undo any change - a per-change undo journal and one-click database checkpoints let you roll back a single edit or the entire site.
- 🔄 Updates plugins & themes safely - backup first, health check after, one-command undo if anything breaks.
- 🛡️ Secure by default - safe mode confirms before anything destructive, you can preview any change before it runs, every key can be scoped to read-only, and every action is written to an audit log.
- 🆓 Free and open source - every tool included, with deep WooCommerce, Gutenberg, ACF, Elementor, Beaver Builder, SiteOrigin, Wordfence and SEO support. No Pro tier, no credits, no usage meter.
- 🔒 Your data stays yours - self-hosted, no accounts, no relay, no phone-home. Your agent connects to your site; nothing leaves your server.
- 🔌 One-click sign-in - Claude, ChatGPT, Gemini, Grok, Perplexity, Muse, Cursor, VS Code, Claude Code, Codex, n8n, OpenClaw, Hermes Agent and any MCP client connect through your browser; no API key to paste. About two minutes, on a live site or a local one.
"More access than any other MCP offers, easy to use, LOVE the change journal and the checkpoints - safe if you break something, without having to run back ups on the host or yet another plugin." - a WordPress.org reviewerAsk in plain language - "publish these three drafts," "why is the checkout page 500-ing," "bump every Summer Sale price 20%," "clear the cache and re-check site health" - and your agent gets it done. Most WordPress AI plugins let an assistant write blog posts; Cowboy MCP lets your agent actually run the site, including WP-CLI, files, the database, error logs and diagnostics. Try it without installing: click Live Preview above for a throwaway WordPress Playground site with Cowboy MCP active. What is a WordPress MCP server? MCP (Model Context Protocol) is the open standard AI assistants use to work with other software. A WordPress MCP server gives Claude, ChatGPT or any MCP-capable agent a set of typed, permission-checked actions on your site - publish a post, update a product, fix an error - instead of you copy-pasting between a chat window and wp-admin. Cowboy MCP is that server, installed like any other plugin. What you can do with it
- Manage content by chat - draft, edit, schedule, and publish posts and pages; upload media; sort categories and tags; build navigation menus.
- Edit pages block by block - your agent reads any page as a Gutenberg block tree and makes surgical edits: update a heading, move a section, swap a pattern. On block themes it can edit Site Editor templates and global styles too - all undoable.
- Run the back office - add and edit users, change roles, and tidy the media library: find every image missing alt text and fix it in one go. Deleted media is recoverable, and the site can never be left without an administrator.
- Run your store - update WooCommerce products, prices, orders, refunds, coupons and inventory in bulk; pull sales reports.
- Fix things that break - read error logs, test emails and HTTP requests, inspect hooks and REST routes, check transients and rewrite rules, and repair database tables. No SSH required.
- Do the developer stuff - run WP-CLI commands, edit files in
wp-content, and take site snapshots before big changes. - Vibe code your site - describe the theme tweak or feature you want; your agent writes the code, checks the error log and fixes what it broke - with undo and checkpoints behind it.
- Keep SEO tidy - read, write and audit Yoast SEO, Rank Math, All in One SEO or SEOPress meta across the site with one vocabulary.
- Roll back a post - list a post's revisions, see a git-style diff of what changed, and restore any revision (the restore itself is undoable).
- Run your events - create and edit The Events Calendar events, venues and organizers; with Events Calendar Pro, manage recurring series and cancel single dates.
- Plug into the WordPress Abilities API - every tool is also a
cowboy-mcp/*ability (with safe mode, the audit log and undo still in front), and abilities other plugins register become tools for your agent. - Works on any host - shared hosting, managed WordPress, a VPS or a local dev site; nothing to install beyond the plugin, no WordPress.com account or Jetpack plan.
cowboy_discover and cowboy_run) and finds the rest on demand, so a big toolset never crowds its context.
- Content - posts, pages and custom post types (5) · taxonomies (4) · comments (4) · media (4) · menus (6) · options (1) · revisions: list, diff and restore (3)
- Gutenberg MCP - block tree read/edit with path addressing, block types, patterns, Site Editor templates and template parts, global styles, navigations (15; 8 on classic themes)
- Site administration - users and roles (5) · plugins (6) · themes (5) · files in wp-content (4) · database health and repair (5) · WP-CLI, site info and search-replace (3) · site health (1)
- Diagnostics - error log, HTTP and email tests, hooks, transients, REST routes, thumbnails, rewrite rules, snapshot, Connection Doctor (10)
- Safety - list changes, undo a change, create/list/restore/delete database checkpoints (6) · batch execution and audit-log retrieval (2)
- WooCommerce MCP - products and variations, orders and refunds, customers, coupons, tax and shipping settings, reports (40)
- Wordfence - scans, blocks, firewall, live traffic, activity, settings (17)
- ACF MCP - field groups, fields, values, repeaters (9)
- Elementor MCP - templates, page content, global styles, widgets (7)
- Beaver Builder - builder pages, layouts, modules, global settings (7)
- SiteOrigin Page Builder - layouts, row and widget edits, prebuilt layouts, widgets, settings, Widgets Bundle activation (12)
- Events - The Events Calendar events, venues, organizers (11) plus Events Calendar Pro recurrence and occurrences (2)
- SEO MCP - Yoast SEO, Rank Math, All in One SEO and SEOPress meta read/write/audit (4)
- Cache - WP Rocket, LiteSpeed Cache, W3 Total Cache (4)
- Forms - WPForms, Gravity Forms, Contact Form 7 (1)
--header.
Connect Claude to WordPress (claude.ai and Claude Desktop)
No terminal: click Add to Claude on the Connections tab and approve the sign-in on your own site. Needs a public HTTPS site.
Connect ChatGPT to WordPress
ChatGPT connects with the same one-click sign-in from a Business, Enterprise or Edu workspace on the web (Pro: read-only); it needs a public HTTPS site.
- Click Open ChatGPT on the Connections tab (it copies your connection link).
- In ChatGPT, go to Plugins → Add → Add custom MCP server, paste the link as the Server URL, keep OAuth and click Create as a plugin.
- Approve the sign-in on your site, install the plugin, then pick it from the + menu in a chat.
"type": "streamableHttp"; Zed takes url and headers under context_servers.
Connect Codex CLI
codex mcp add your-site --url https://yoursite.com/wp-json/cowboy-mcp/v1/endpoint
Codex opens your browser to sign in; headless, add --bearer-token-env-var COWBOY_MCP_API_KEY and export your key.
Connect Gemini CLI
gemini mcp add -s user -t http your-site https://yoursite.com/wp-json/cowboy-mcp/v1/endpoint
Start gemini and run /mcp auth your-site to sign in; headless, use an API key with --header.
Opencode and other MCP clients
Cowboy MCP is a standard Streamable HTTP MCP server (JSON-RPC 2.0): point Opencode, LibreChat or your own agent at /wp-json/cowboy-mcp/v1/endpoint. Opencode signs in with OAuth; others send an Authorization: Bearer header.
Local development sites
Local, Studio, MAMP, DevKinsta, wp-env, Docker: terminal and IDE tools sign in on this computer with no public URL, and Claude Desktop uses the mcp-remote bridge. Cloud apps such as claude.ai and ChatGPT need a public HTTPS address.
Secure by design: built for live sites
- Safe mode (on by default) - destructive tools refuse to run until the agent confirms.
- Dry run - every non-read-only tool can report what would change without touching anything.
- Per-change undo journal - before-state snapshots; roll back one edit from the Activity tab or by asking your agent (seven days by default).
- Database checkpoints - one-click database snapshots, taken automatically before plugin and theme updates and mutating WP-CLI commands (tables only, not uploads or code).
- Safe plugin and theme updates - file backup and database checkpoint first, then a health check that restores the previous version if the site breaks.
- Audit log - every tool call, error and authentication event on the Logs tab; pruned after 30 days.
- AI agent permissions - each API key and OAuth connection can be full access, read-only, or a custom list of tools.
- Hashed keys, rate limits, origin checks - keys are shown once and stored as one-way hashes, requests are rate-limited per key, and unknown browser origins are rejected.
- Guardrails you cannot talk your way past - a denylist of sensitive options, dangerous SQL and WP-CLI commands, SSRF protection, file writes confined to
wp-content, and last-administrator protection. Power mode lifts some for rare jobs; only a human can switch it on in wp-admin. - Connection Doctor - a one-click self-test that names what blocks a connection (HTTPS, REST, OAuth, Cloudflare, firewalls, caching), with a report to paste into a support topic.
- Nothing in the middle. Cowboy MCP runs on your server, on any host: no account, no relay, no credits, no quota.
- Every tool is free. Cowboy MCP ships plugins, themes, database and WooCommerce tools GPL-licensed, with no paid tier.
- Typed tools with undo, not a PHP shell. Tools that execute arbitrary PHP are built for development copies. Cowboy MCP gives the agent typed tools wrapped in safe mode, dry run, undo and checkpoints, so it can be trusted on the site that pays the bills (compared with Novamira).
- A full safety net, not just an undo button. A per-change journal with conflict detection, whole-database checkpoints, automatic restore of broken updates, dry run, safe mode and an always-on audit log.
- A complete server today, wired into the official pieces. The Abilities API and the official MCP adapter are a framework; Cowboy MCP is the turnkey server and bridges both ways on WordPress 6.9+. Needs WordPress 6.2+, no Composer, Node.js or build step.
安装:
- Install and activate Cowboy MCP from the Plugins screen.
- Go to Settings > Cowboy MCP, open the Connections tab, pick your app and click its button or copy its command; you then sign in through your browser.
- Connect your agent and start giving it instructions.
--header "Authorization: Bearer YOUR_API_KEY" to the first line instead of running the second.
Claude desktop / web (no terminal): click Add to Claude on the Connections tab (Claude opens with your site already filled in; browser sign-in is switched on for you) and approve with one click. (Requires a public HTTPS site; on a local site use the mcp-remote bridge shown on the Connections tab.)
Every other client: the Connections tab shows a ready-to-copy setup for each, and cowboymcp.com has step-by-step guides.屏幕截图:
常见问题:
What is a WordPress MCP server?
A plugin that lets AI assistants act on your site through the Model Context Protocol (MCP), the open standard Claude, ChatGPT, Cursor and other agents use to call external tools. Cowboy MCP turns your WordPress site into one of those tools, so your agent can publish, edit, update and fix things directly instead of telling you what to click.
How do I connect ChatGPT to my WordPress site?
Click Open ChatGPT on the ChatGPT panel of the Connections tab in Cowboy MCP; it copies your connection link. In ChatGPT on the web, go to Plugins, click Add > Add custom MCP server, paste the link as the Server URL, keep OAuth, acknowledge the risk warning and click Create as a plugin. Approve the sign-in on your site as an administrator, install the plugin, then pick it from the + menu in a chat (or type @ and its name). It needs a Business, Enterprise or Edu workspace (Pro: read-only) and a public HTTPS site.
How do I connect Claude to my WordPress site?
For the Claude desktop and web apps, click Add to Claude on the Connections tab and approve the one-click sign-in - no terminal needed. For Claude Code, run the two lines shown ready to copy on the Connections tab and sign in in your browser - no key to copy, and no switch to flip: Claude Code and Codex identify themselves with a Client ID Metadata Document (the current MCP standard). For headless or CI use, generate an API key there instead.
Is it free?
Yes. Every tool, every integration and every safety feature is in this free plugin, licensed GPL-2.0. There is no Pro tier, no credit system and no usage cap beyond the per-key rate limit you set yourself.
Is it secure? Can the AI break my site?
It is built so a mistake can be reversed. Keys are hashed and shown once, requests are rate-limited, destructive actions need confirmation, changes can be previewed with a dry run, and every action is written to an audit log. Content, options, users, media deletions, menus, terms, comments, WooCommerce objects, SEO meta, revisions, events, Gutenberg and Site Editor edits, Beaver Builder and SiteOrigin layouts, search-replace runs and plugin or theme installs, updates and deletions are journaled and can be undone individually or as a batch - seven days by default - and database checkpoints roll every site table back to an earlier moment. Things with no inverse - a sent email, a cache flush, an arbitrary WP-CLI command, an outbound HTTP request - are recorded as not undoable rather than pretended otherwise; take a checkpoint first when you ask for those.
Can I limit what an AI agent is allowed to do?
Yes. Every API key and every OAuth connection carries a scope: full access, read-only, or a custom list of allowed tools, chosen when the key is created or the connection is approved. Safe mode adds confirmation for destructive tools on top, and the most powerful operations stay locked behind Power mode, which only an administrator can enable in wp-admin.
Do I need to be a developer?
No. Publishing content and running your store work through plain conversation. The developer tools (WP-CLI, files, database) are there when you want them, and gated behind safe mode until you say go.
Which AI agents and assistants work with it?
Any MCP-compatible client over Streamable HTTP - including Claude Code, the Claude desktop and web apps, ChatGPT, Perplexity, Grok, the Gemini app, Meta Muse and Muse Code, Cursor, VS Code with GitHub Copilot, Windsurf, Cline, Zed, Codex CLI, Gemini CLI, Opencode, n8n, OpenClaw and Hermes Agent.
Does it work with WooCommerce?
Yes. When WooCommerce is active, 40 store tools light up: products and variations, orders and refunds, coupons, customers, stock, shipping zones, tax rates, payment gateways, and sales reports - so your agent can run the store, not just describe it.
Does it work with The Events Calendar?
Yes. When The Events Calendar is active, your agent can create and edit events, venues and organizers, and trash or delete events (venues and organizers are removed with the standard delete-post tool). With Events Calendar Pro it can also manage recurring events - edit a whole series or cancel a single date. Editing one occurrence on its own stays in wp-admin. Changes are undoable, and permanent deletes take a database checkpoint first.
Does it work on a local development site (Local, Studio, MAMP, DevKinsta)?
Yes. Terminal tools like Claude Code, Cursor, Codex and Gemini CLI run on the same computer as your local site, so they sign in with OAuth in your browser - no public URL needed. An API key works too, for headless use. Claude Desktop connects through a small local bridge (mcp-remote); the Connections tab detects local sites and shows the ready-to-copy config. Only the cloud-side apps - claude.ai and ChatGPT - require a public HTTPS address, because they connect from the vendor's servers; a tunnel works for temporary testing, but be aware it exposes your whole dev site while it runs.
My host or Jetpack already offers MCP. Do I need this?
Hosting-level MCP servers mostly manage the hosting account - sites, DNS, backups - and WordPress.com's MCP reaches a self-hosted site only through a paid Jetpack plan. Cowboy MCP works inside the site itself, on any host, for free: content, WooCommerce, users, plugins, diagnostics, with undo and an audit log. They can run side by side.
Should I wait for the official MCP Adapter?
You don't need to. The Abilities API (WordPress 6.9+) and the official MCP Adapter are a framework: plugins register abilities, and the adapter exposes whatever was registered. Cowboy MCP is a complete, turnkey MCP server with its own toolset, safety layer, undo, audit log, scoping, OAuth connector and Connection Doctor, and it runs on WordPress 6.2 or later without Composer or Node.js. On 6.9+ it registers its tools as abilities, so the adapter can use them too - you can run both side by side.
How does it compare with Novamira?
Novamira is built for development and staging copies and gives the agent a PHP shell. Cowboy MCP is built for live sites: typed tools, safe mode, undo, database checkpoints and an audit log, all free, installed from WordPress.org. See the full Cowboy MCP vs Novamira comparison.
Can I vibe code my WordPress site?
Yes - that is what it is built for. Your agent can write and edit theme and plugin code in wp-content, run WP-CLI, and read the error log to fix what it broke. Every PHP file is syntax-checked before it lands, and mu-plugins (which WordPress recovery mode cannot pause) stays off-limits unless an administrator turns on Power mode - so a cut-off or broken payload cannot take the site down. Take a database checkpoint first (or let auto-checkpoint do it), and every change lands in the undo journal - so vibe coding a live site does not have to be a leap of faith.
Does it send my data anywhere?
No telemetry and no phone-home - your data stays on your server. The only outbound connections are to WordPress.org, when your agent installs or updates plugins and themes, plus any HTTP requests you explicitly ask your agent to make. There is no hosted relay and no account with us; your AI client connects to your site directly.
Does it work with the WordPress Abilities API?
Yes, both ways, on WordPress 6.9 or newer. Every allowed tool is registered as a cowboy-mcp/* ability, so wp ability run, the core Abilities REST endpoint, the official MCP Adapter and the AI plugin's Abilities Explorer all reach it - and every call still goes through safe mode, dry run, the audit log and the undo journal. Callers need an administrator account; wp_cli and wp_write_file are only exposed while Power mode is on. In the other direction, abilities registered by other plugins appear as tools for your agent; they run their own permission checks and are not undoable. Both directions have a switch under Settings. Request formats and examples: Cowboy MCP 1.6.4 release notes.
Does it work on multisite?
Cowboy MCP is built for single sites and is not network-aware. On a multisite network, activate it on each site you want an agent to manage (not network-wide) and generate keys on that site; its plugin tools do recognise network-activated plugins when activating or deactivating.
Connection problems: 401/404, "registration is closed", a refused redirect host, or a connector that stopped after a staging sync
Start with the Connection Doctor on the Connections tab. It tests HTTPS, the REST API, OAuth discovery and common host blockers (Cloudflare bot rules, ModSecurity-style firewalls, LiteSpeed caching of /wp-json/), names the exact problem and gives you a fix. The most common cases:
- "Registration is closed" - new AI apps can register only while "New connections" is on: on the Connections tab pick the app ("Connect another app" if the list is not shown), click "Enable for 30 minutes", then add the connector.
- Connector stopped after a staging sync or database restore - click "Enable for 30 minutes", then Reconnect in the AI app and approve again. Nothing needs removing.
- "Not an allowed redirect host" - the connector only returns approvals to known AI apps and localhost; add another OAuth client's host (for example a self-hosted n8n) under Settings > Browser sign-in > Additional allowed hosts.
- Connected, but "no tools" - the agent sees two gateway tools and discovers the rest on demand; ask it to "discover tools for WooCommerce". If even those are missing, check the key's scope.
更新日志:
- New: connect Meta Muse and Muse Code from the Connections tab. Setup is one message pasted into the chat: the app configures itself and signs in. Sites behind Cloudflare are shown the firewall rule Muse needs.
- New: OpenClaw and Hermes Agent panels under "Automation & developers". Both connect with one pasted message. Terminal commands, config files and an API-key setup are available.
- New: n8n connects with OAuth2: it registers itself and your site asks for approval, with no secret to copy. The API-key setup remains available.
- Improved: every connection panel shows the exact link or message to paste, each with a Copy button that turns on browser sign-in and opens pairing for 30 minutes; the "Open " buttons only open the app. Each panel is one short numbered list ending with a read-only test prompt.
- Improved: the Connection Doctor detects Cloudflare's Browser Integrity Check blocking the MCP endpoint and shows the rule to add.
- Changed: ChatGPT and Claude setup steps match the current apps. ChatGPT: open Plugins, click Add, choose Add custom MCP server, and the site appears in the chat's + menu, no Developer mode needed. Custom MCP servers are available on Business, Enterprise and Edu workspaces, read-only on Pro. Claude's Add custom connector dialog detects the sign-in settings itself, and its recommended "Use Claude's published identity" option is supported.
- Fix: ChatGPT shows file contents, posts, patterns and templates again. Results with a
contentfield arrived as an empty{}; the affected tools now also return structured output. Thanks to @kuzey2004 for the report and testing. - Fix:
wp_list_directorywithrecursive: trueno longer fails with an exception. - Fix: a terminal app that signs in again from a different local port (as Muse Code does) is no longer refused.