English Français العربية

dev.wpagent/wpagent-mcp

السجل الرسمي التجارة الإلكترونية

Manage WordPress & WooCommerce from any MCP client — 58 tools over a signed REST API.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package wpagent-mcp
Claude Code 
claude mcp add wpagent-mcp -e 'WP_SITE_URL=<WP_SITE_URL>' -e 'WP_API_KEY_ID=<WP_API_KEY_ID>' -e 'WP_API_SECRET=<your wp_api_secret>' -e 'WP_SITE_LABEL=<WP_SITE_LABEL>' -- npx -y wpagent-mcp@1.1.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "wpagent-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "wpagent-mcp@1.1.4"
            ],
            "env": {
                "WP_SITE_URL": "<WP_SITE_URL>",
                "WP_API_KEY_ID": "<WP_API_KEY_ID>",
                "WP_API_SECRET": "<your wp_api_secret>",
                "WP_SITE_LABEL": "<WP_SITE_LABEL>"
            }
        }
    }
}

متغيرات البيئة

  • WP_SITE_URL إلزامي Base URL of your WordPress site, no trailing slash
  • WP_API_KEY_ID إلزامي API key id shown by the WpAgent plugin
  • WP_API_SECRET إلزامي سري API key secret, displayed once at generation
  • WP_SITE_LABEL Friendly name for the site; defaults to the hostname

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. wpagent-mcp
  2. Install
  3. What it can do
  4. What it will not do
  5. Safety
  6. Related
  7. Licence

wpagent-mcp

An MCP server that lets Claude — or any MCP-compatible client — actually operate a WordPress site: plugins, content, themes, menus, media, users, WooCommerce, Elementor and WP-CLI.

It talks to your site through the free WpAgent bridge plugin over a REST API where every request is signed with HMAC-SHA256. No site credentials are involved, and no data passes through a third-party service: the connection is client → your WordPress, directly.

Install

Nothing to install ahead of time — the config below fetches it on demand.

  1. Install the WpAgent plugin on your WordPress site and activate it.
  2. In the WordPress admin, open WpAgent and generate an API key. Choose the permissions you want the assistant to have; a read-only key is a sound way to start.
  3. Add the server to your MCP client. For Claude Desktop, in claude_desktop_config.json:
{
  "mcpServers": {
    "wpagent": {
      "command": "npx",
      "args": ["-y", "wpagent-mcp"],
      "env": {
        "WP_SITE_URL": "https://your-site.com",
        "WP_API_KEY_ID": "wpaia_xxxxxxxxxxxx",
        "WP_API_SECRET": "the secret shown once when you generated the key"
      }
    }
  }
}

For Claude Code:

claude mcp add wpagent \
  --env WP_SITE_URL=https://your-site.com \
  --env WP_API_KEY_ID=wpaia_xxxxxxxxxxxx \
  --env WP_API_SECRET=... \
  -- npx -y wpagent-mcp
Environment variables
VariableRequiredWhat it is
WP_SITE_URLyesYour site's base URL, no trailing slash
WP_API_KEY_IDyesThe key id shown in the plugin
WP_API_SECRETyesThe secret, displayed once at generation
WP_SITE_LABELnoA friendly name; defaults to the hostname

What it can do

AreaExamples
Pluginslist, search wordpress.org, install, activate, deactivate, update, delete
Contentposts, pages, products, any custom post type, with meta and featured images
Themeslist, search, install, activate, theme mods, custom CSS, logo, colours
WooCommercesettings, orders, coupons, shipping zones, payment gateways, tax rates, stats
Structuremenus, widgets, sidebars, taxonomies, terms, redirections
Mediabrowse, upload, delete
Users & commentslist, create, update, moderate
Auditbest-practices check over security, SEO, performance, with auto-fixes
WP-CLIallowlisted commands, off unless enabled in wp-config.php

What it will not do

The API has no path to arbitrary PHP, no path to your database, and no path to wp-config.php. WP-CLI execution is disabled unless the site owner adds define('WPAIA_ENABLE_WPCLI', true); on the server, and even then only allowlisted commands run — db, eval, eval-file, shell, server, config and package are always refused.

Safety

  • Every request is signed with HMAC-SHA256 and carries a timestamp; requests older than five minutes are rejected.
  • Permissions are per key and checked on every route, so a read-only key stays read-only.
  • Every call is written to an audit log you can read in the WordPress admin.
  • Revoking a key in WordPress takes effect immediately.

Ask the assistant to confirm before destructive actions, and keep a current backup — it can delete content when you tell it to.

  • WpAgent — hosted dashboard built on the same bridge, with a free read-only tier
  • The bridge plugin is GPL-2.0-or-later; this server is MIT.

Licence

MIT © KipDev

الأسئلة الشائعة

ما هو dev.wpagent/wpagent-mcp؟

Manage WordPress & WooCommerce from any MCP client — 58 tools over a signed REST API.

كيف أثبّت dev.wpagent/wpagent-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add wpagent-mcp -e 'WP_SITE_URL=<WP_SITE_URL>' -e 'WP_API_KEY_ID=<WP_API_KEY_ID>' -e 'WP_API_SECRET=<your wp_api_secret>' -e 'WP_SITE_LABEL=<WP_SITE_LABEL>' -- npx -y wpagent-mcp@1.1.4. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج dev.wpagent/wpagent-mcp إلى مفتاح API؟

نعم. يتطلب WP_SITE_URL, WP_API_KEY_ID, WP_API_SECRET، وتضبطها في إعداداته.

هل dev.wpagent/wpagent-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون dev.wpagent/wpagent-mcp؟

ينشره THE-KIPDEV. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.