外掛說明
MCP Manager connects your WordPress site to any MCP-compatible AI client — Claude, ChatGPT, Cursor, VS Code, GitHub Copilot, Gemini, and more — so those clients can safely read, edit, and act on your site.
Every headline section below links to the full documentation at acrossai.co/doc-category/mcp-manager — the docs are the source of truth and get updated first. Source and issues live at github.com/acrossai-co/acrossai-mcp-manager.
Key Features
- Multiple MCP servers per site — create, enable, disable, and configure independently. Docs
- Multi-client connection guides — copy-paste-ready configs for Claude Desktop, VS Code + Copilot, GitHub Copilot, ChatGPT, Cursor, Gemini CLI, and custom clients. Docs
- CLI browser-approval flow — let terminal users connect with one command; approval happens in a browser tab. Docs
- WP-CLI (STDIO) transport — local clients can connect through a WP-CLI subprocess with no network credential transmission. Docs
- Application Passwords under the hood — WordPress-native credentials, one-click generation, and revocation from the user profile page. Docs
- Per-server tool and ability curation — pick exactly which WordPress abilities each MCP server exposes as callable tools. Docs
- Per-server access control — gate every MCP request by user, role, capability, or your own policy provider. Docs
- Frontend embeds — shortcode + block to show your users how to connect their AI clients from your own site. Docs
How It Works
- Install and activate the plugin (step-by-step)
- Open AcrossAI MCP in your WordPress admin
- Pick your AI client tab (Claude, VS Code, ChatGPT, Cursor, Gemini, GitHub Copilot, or Custom)
- Generate a new Application Password with one click
- Copy the ready-made JSON config and paste it into your client
- Restart your client — it now sees your site’s abilities
Longer walkthrough with screenshots: Getting started connect your first AI client.
Connection Types
MCP Manager ships with three connection styles out of the box, plus one optional paid add-on:
- MCP Client (npx bridge) — the default. Paste a JSON config into Claude Desktop, VS Code, Cursor, etc. Uses
@automattic/mcp-wordpress-remote@latestwith a WordPress Application Password. Docs - CLI Connections (browser approval) — one command in the terminal, one click in the browser, zero password copying. Docs
- WP-CLI (STDIO) — local subprocess, no network credential transmission. Best for CI or local dev boxes. Docs
- AI Connectors (paid add-on) — one-click Claude, ChatGPT, and Grok hosted-OAuth connectors. Requires the separate AcrossAI AI Connectors plugin (14-day money-back). Docs
Requirements
- WordPress 7.0 or higher
- PHP 8.1 or higher
- WordPress Application Passwords support (built-in since WP 5.6)
Support
- Docs hub — acrossai.co/doc-category/mcp-manager
- Troubleshooting & FAQ — acrossai.co/docs/mcp-faq-troubleshooting
- Source code + issue tracker — github.com/acrossai-co/acrossai-mcp-manager
Support & Contribution
For issues, feature requests, or contributions, visit the plugin repository.
Questions? Check the FAQ section or look for documentation in the plugin settings page.
Development
This plugin follows WordPress coding standards and best practices:
– PHP 7.4+ compatible
– Full object-oriented architecture
– Secure nonce verification
– Proper capability checks
– Sanitized input validation
– Escaped output
License
This plugin is licensed under the GPL-2.0-or-later license. See LICENSE file for details.
Credits
MCP Manager is built with:
– WordPress native APIs
– Automattic’s MCP WordPress Remote package
– WordPress Application Passwords system
Developed with ❤️ for the WordPress community.
螢幕擷圖
安裝方式
- Upload the plugin directory to
/wp-content/plugins/ - Activate the plugin through the ‘Plugins’ menu in WordPress
- Navigate to Settings MCP Manager to configure
Or:
- Go to Admin Plugins Add New
- Search for “MCP Manager”
- Click “Install Now” then “Activate”
常見問題集
Full FAQ + troubleshooting lives at acrossai.co/docs/mcp-faq-troubleshooting. Quick answers below.
-
Are my credentials secure?
-
Yes. MCP Manager uses WordPress’s native Application Passwords — each one is generated by WordPress, tied to your user, revocable from the profile page, and never stored in this plugin’s own tables. Full detail: Application passwords & security.
-
Can I connect multiple AI clients to the same site?
-
Yes — generate a separate password (or CLI approval) per client. You can also run multiple MCP servers on the same site with different tool/ability sets and per-server access rules. See MCP servers.
-
Which AI clients are supported?
-
Claude Desktop, ChatGPT, Cursor, VS Code (with Copilot), GitHub Copilot, Gemini CLI, and any custom MCP-compatible client. Adding a new client is a filter callback. See Connecting an AI client.
-
Does it work on multisite?
-
Yes — each site in the network configures independently.
-
Do I need the paid AI Connectors add-on?
-
Only if you want the one-click hosted-OAuth flow for Claude, ChatGPT, or Grok. All other connection styles (MCP Client, CLI, WP-CLI STDIO) are free and shipped with this plugin. See AI Connectors add-on.
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
0.2.7
- Docs — Fixes for the WordPress.org plugin import. Trimmed the
Tags:header from 8 tags to 5 (mcp, ai, claude, chatgpt, cursor) — WordPress.org silently drops any tag past the fifth; the surplus (copilot,vscode,gemini) never showed up in the plugin listing anyway. Condensed the changelog for versions prior to0.2.0into a single “Earlier versions” pointer to the GitHub Releases page so the full changelog stays under WordPress.org’s 5,000-word cap (previously ~8,258 words the older entries were truncated on import and never rendered on the plugin page). Same information, still discoverable — just hosted on GitHub instead of duplicated inREADME.txt. - Internal:
ACROSSAI_MCP_MANAGER_VERSIONconstant +Stable tagbumped to0.2.7matching the plugin header.
0.2.6
- Refactor —
ConnectionMethodRegistry::get_ai_connectors()now sources its DTOs from a new WordPress filteracrossai_mcp_manager_discovery_ai_connectorsinstead of calling the companion plugin’sConnectorProfileRegistryclass directly. The paid companion (acrossai-pro0.8.0+) hooks the new filter and returns the same DTO shape from its own registry — Discovery’sai_connectorcategory behaves identically for end users. Removes a hardcoded FQN string (\AcrossAI_AI_Connectors\Includes\Connectors\ConnectorProfileRegistry) from the free plugin so future companion renames / restructures don’t silently break Discovery. Fail-safe unchanged: with no companion active, the filter returns an empty array and theai_connectorcategory is omitted from Discovery — no fatal, no warning. - Internal:
ACROSSAI_MCP_MANAGER_VERSIONconstant +Stable tagbumped to0.2.6matching the plugin header.
0.2.5
- ⚠️ Security — Behavior change — MCP endpoints default to administrators only when no Access Control rule is set (Feature 042). Previously, an MCP server with no rule configured in its Access Control tab was fail-open at the tool-call layer — any authenticated user could reach the server’s
/wp-json/{namespace}/{route}endpoint. Starting with 0.2.5, a new runtime filter (mcp_adapter_default_transport_permission_user_capability, hooked by the new\AcrossAI_MCP_Manager\Includes\AccessControl\TransportPermissionDefaultsingleton) hard-blocks non-admins at the RESTpermission_callbackstage whenever the wpb-access-control dropdown reads “No user access added by admin”. Together with the existing F015mcp_adapter_pre_tool_callgate, this ships a two-filter, per-server permission stack (defense-in-depth): filter 1 hard-stops non-admin traffic on rules-less servers; filter 2 does precise per-rule enforcement on rule-configured servers. Neither filter has any hardcoded server slug or “default server special case” — both resolve the current server independently per request (filter 1 via URL routeMCPServerQuerylookup; filter 2 via$server->get_server_id()). Adding a server via Add New Server applies both filters automatically. Zero DB writes — the runtime filter approach replaced an earlier DB-row-seeding attempt (dropped via force-push on PR #71) that conflicted with the vendor UI’s admin state model. Ships with a static info banner on the Access Control tab describing the default policy + how to broaden access via the vendor dropdown (Anyone / Authenticated users / role / user / capability). 26 PHPUnit tests across 2 files attests/phpunit/Includes/AccessControl/(TransportPermissionDefaultTest+TransportPermissionRoleMatrixTest) cover every filter-callback branch in isolation plus 6 user roles × 4 rule shapes × ≥4 servers per test end-to-end (including a 5×4 truth-table matrix proving per-server independence).- Operator action if you were relying on the fail-open default: open each MCP server’s Access Control tab, set the “Who can access” dropdown to the intended rule (e.g.
WordPress role → EditororAnyonefor the previous behavior), and Save. Rules-less servers are now admin-only until you configure them.
- Operator action if you were relying on the fail-open default: open each MCP server’s Access Control tab, set the “Who can access” dropdown to the intended rule (e.g.
- UX — Cache-exclusion warning surfaces in the shared Notices submenu when the CLI (npm/npx) connection flow is enabled (Feature 041). When Settings MCP Allow CLI connections via npm / npx (
acrossai_mcp_npm_login_enabled) is ON, a persistent warning card now appears in the AcrossAI Notices submenu (and in the WP-native dismissible summary) instructing operators to exclude the CLI auth URL (https://<site>/acrossai-mcp-manager/) from page caching. The URL carries per-request nonces + single-use auth codes; caching plugins that treat it as static content silently break the login flow. The existing inline banner in the settings section is preserved — this feature adds a second, higher-visibility surface that co-admins and future visitors see even if they never open the specific settings section. Notice idacrossai_mcp_manager_cli_auth_cache_exclusion, sourceMCP Manager, gated on the option value. UsesFrontendAuth::get_base_url()for the URL — any future change to the CLI landing route propagates automatically. - Internal:
ACROSSAI_MCP_MANAGER_VERSIONconstant +Stable tagbumped to0.2.5matching the plugin header.
0.2.4
- Dependencies — bump
wpboilerplate/wpb-access-control2.0.03.1.0. Two vendor changes surface in the per-server Access Control tab (?tab=access-control): (1) new “Any logged-in user” option in the Who can access dropdown — backed by the newTYPE_AUTHENTICATEDsentinel inAccessControlManager(returnstrueiff$user_id > 0), and (2) the existing “Everyone (no restriction)” option is relabelled “Public (no login required)” — pure UI relabel, same underlying behavior (TYPE_EVERYONEunchanged, existing rules unaffected). v3.0.0 also removed the built-inBuddyBossProfileTypeProvider+MemberPressMembershipProvider(moved to a separateacrossai/user-access-proadd-on); this plugin never wired them into the Who can access dropdown, so removal has no visible effect here. Docblock atincludes/Main.phprefreshed to drop the stale BuddyBoss/MemberPress reference. No data migration required. - Internal:
ACROSSAI_MCP_MANAGER_VERSIONconstant +Stable tagbumped to0.2.4matching the plugin header.
0.2.3
- UX — In-context nudges to install the AcrossAI Abilities Manager add-on. When the sibling
acrossai-abilities-managerplugin is not active, the server-edit Abilities and Tools tabs (?tab=abilities/?tab=tools) now surface a small WordPress-nativenotice-infoblock above the picker with a link to the shared Add-ons page (admin.php?page=acrossai-addons). Without the add-on both pickers only list the three core abilities WordPress ships by default (core/get-environment-info,core/get-site-info,core/get-user-info); the add-on registers a rich library of built-in abilities that populate both surfaces. Detection is a plainis_plugin_active()check — same message + same link covers both “not installed” and “installed-but-off” states. Placed after the existing “Server is disabled” warning and before thewp_get_abilities()capability check, so the nudge is visible even when the abilities API itself is missing. - UI — AcrossAI brand logo on the AI Connectors placeholder tab. Replaces the hand-rolled interconnected-nodes SVG on the AI Connectors placeholder promo (
?tab=ai-connectorswhen theacrossai-ai-connectorscompanion is missing / inactive) with the same brand SVG the vendor uses on the shared Add-ons page (https://acrossai.co/wp-content/uploads/2026/07/acrossai-logo-2.svg). NewLOGO_URLclass constant onAIConnectorsPromoTab; icon markup swapped from an inline<svg>inside a gradient tile to a plain<img alt="AcrossAI">tag; deleted the privaterender_network_svg()method (dead code). CSS: dropped.acai-aic-promo__icon(gradient background + colored SVG) in favor of.acai-aic-promo__logo(height: 48px; max-width: 180px; object-fit: contain) so the brand mark sits cleanly without a decorative background box. - Refactor — Renamed the “MCP Tracker” tab to “Logs”. The per-server tab formerly reached at
?tab=mcp-trackeris now?tab=mcp-log, and the tab-bar label reads Logs instead of MCP Tracker. Priority slot 80 preserved so the tab-bar ordering is unchanged. Class nameMcpTrackerTabkept (internal identifier) along with the body copy that identifies the third-party MCP Tracker plugin on WordPress.org (WPVMCPT) product name — those aren’t the tab label, they’re a specific product reference. Deep links to the old?tab=mcp-trackerfall through to Registry’s “first surviving tab” default (Overview) rather than 404. Test fixture updated: five'mcp-tracker'occurrences inRegistryTest.phpmigrated to'mcp-log'. - Docs — Rewrote
README.txtas a lean docs-hub pointer. The plugin’s WordPress.org readme now defers to acrossai.co/doc-category/mcp-manager as the source of truth for every feature description — copy lives in one place instead of drifting between two. Description condensed to a two-line multi-client pitch; Key Features reshaped to reflect the current feature set (multiple servers per site, per-server tool/ability curation, per-server access control, frontend embeds, CLI + WP-CLI STDIO transports) with each bullet linking to its docs page; How It Works trimmed to the 6-step get-started path; new Connection Types section calls out the four supported paths (MCP Client, CLI Connections, WP-CLI STDIO, and the paid AI Connectors add-on); Requirements bumped to WordPress 7.0+ / PHP 8.1+ (matches the plugin header — old readme had drifted to 5.9 / 7.4); FAQ trimmed from 7 questions to 5 with a new “Do I need the paid AI Connectors add-on?” entry; new Support section links to docs hub, FAQ page, and GitHub issue tracker. Header tags expanded (chatgpt,cursor,geminiadded). Deleted the stale post-F040 Experimental Direct Claude Connectors section, the CLI-flow deep dive, and the Provider Configuration Paths list — those live in the docs now. - Internal:
ACROSSAI_MCP_MANAGER_VERSIONconstant +Stable tagbumped to0.2.3matching the plugin header.
0.2.2
- Notices — migrated persistent-condition banners to the cross-plugin
acrossai_noticesfilter. The “MCP adapter package missing” and “wpb-access-control library missing” warnings no longer render as inlineadmin_noticesbanners on every screen. They’re pushed into the shared collection introduced inacrossai-co/main-menu0.0.30, which surfaces them in two consolidated places: (1) a Notices submenu under the AcrossAI parent menu (with a count bubble; the page also stays reachable when the count is zero and renders an “All clear” empty state per the 0.0.31 fix) and (2) a single WP-native dismissible summary on every other admin page. Dismissal is now fingerprint-based (per-user meta_acrossai_notices_summary_fp) — adding, resolving, or renaming a notice re-shows the summary automatically. Deletions:Notices::render_missing_adapter_notice,Notices::handle_adapter_notice_dismissal,ADAPTER_DISMISS_META_KEY,ADAPTER_DISMISS_NONCE_ACTION,AcrossAI_MCP_Access_Control::maybe_show_library_notice, and the US4 dismiss-persistence handler insrc/js/backend.js— all obsoleted by the shared summary. Additions:Notices::register_shared_notices()returns records with idsacrossai_mcp_manager_adapter_missing(typeerror) andacrossai_mcp_manager_wpb_access_control_missing(typewarning), both scoped withsource: 'MCP Manager'. One-shot action-result flashes (?notice=<slug>) stay on the standardadmin_noticeshook — page-scoped transient messages don’t fit the shared collection model. - UI — Redesigned the AI Connectors placeholder tab as a centered sales card. When the
acrossai-ai-connectorscompanion add-on is not installed or not active, the AI Connectors tab on the server-edit page (?page=acrossai_mcp_manager&action=edit&server=<id>&tab=ai-connectors) now renders a vertically-centered polished card sourced from https://acrossai.co/ai-connectors/ — headline (“Connect WordPress to Claude, ChatGPT & Grok in one click”), supported-client pills (Claude · ChatGPT · Grok), four benefit bullets, a purple CTA (“Install add-on” / “Activate add-on” depending on companion state), a “Learn more” link, and a 14-day money-back trust line. State resolution unchanged — Registry’s last-wins dedup at priority 35 still swaps the placeholder out for the companion’s realAIConnectorsTabthe moment the add-on activates. - Dependencies: bump
acrossai-co/main-menu0.0.290.0.31. 0.0.30 shipped the sharedacrossai_noticesfilter + Notices submenu +SummaryNoticeEmitter. 0.0.31 fixed a “Sorry, you are not allowed to access this page.” error on direct visits toadmin.php?page=acrossai-noticeswhen the notice count was zero (page callback is now always wired; empty-state sidebar row is hidden via inline<style>onadmin_headrather thanremove_submenu_page(), which had desynced$_registered_pages). - Internal:
ACROSSAI_MCP_MANAGER_VERSIONconstant +Stable tagbumped to0.2.2matching the plugin header (backfills theStable tagdrift that persisted since 0.2.0).
0.2.1
- Security — Defended REST + AJAX response paths against full-page cache poisoning. Full-page caches (LiteSpeed Cache, WP Rocket, W3 Total Cache, WP Super Cache, host-level FastCGI cache) don’t honor arbitrary
Cache-Control: no-storeheaders when making caching decisions — they gate onDONOTCACHEPAGE(WordPress-community convention) and their admin exclusion list. Companion fix toacrossai-ai-connectors0.5.3 PR #13 (DEC-OAUTH-DONOTCACHEPAGE-PATTERN). Newincludes/Utilities/CacheHeaders.php— port of the utility fromacrossai-ai-connectors— applies a three-pronged defense (constant + headers + WP filter) on every per-session and per-server response emission surface:GET /servers/{id}/abilities,GET /servers/{id}/tools,GET /auth/status,GET /servers,POST /auth/start,POST /auth/exchange,POST /generate-app-password, and thewp_ajax_acrossai_mcp_dismiss_adapter_noticeAJAX endpoint. Prevents cross-server data leaks (per-server ability/tool rosters bleeding into other sessions) and stale-response classes (cached{approved:false}served after the flip totrue). Also fixes plugin-header vsACROSSAI_MCP_MANAGER_VERSIONconstant drift — B5 bug pattern (constant lagged at 0.1.9 while header sat at 0.2.0). Both now aligned at 0.2.1.
0.2.0
- Dependencies: bump
acrossai-co/main-menu0.0.270.0.29. Picks up the shared main-menu package’s latest baseline for the 0.2.0 release cycle. - Feature 040 — Migrated the AI Connectors + OAuth stack to the companion plugin
acrossai-ai-connectors(v0.5.0+). MCP Manager now ships only the free-tiertab=npmandtab=clientsconnection paths; the OAuth click-to-connect flow (Claude Web, ChatGPT connectors, Grok) plus the AI Connectors admin tab now live in the paidacrossai-ai-connectorsadd-on. Token / client / auth_code storage is unchanged — same table names (wp_acrossai_mcp_oauth_clients,_tokens,_auth_codes,wp_acrossai_mcp_connector_approved_users), same BerlinDBdb_version_keys, no data migration. REST namespace kept asacrossai-mcp-manager/v1for RFC 8414 discovery compatibility. Existing Claude/ChatGPT/Grok OAuth connections continue to authenticate transparently when the add-on is installed — zero re-authorization required. Free users updating without the add-on are undisturbed (mcp-manager remains standalone-activatable; the AI Connectors tab simply doesn’t appear). Deletions: entireincludes/OAuth/,includes/Connectors/,includes/Database/{OAuthClients,OAuthTokens,OAuthAuthCodes,ConnectorApprovedUsers}/,admin/Partials/ServerTabs/AIConnectorsTab.php,templates/oauth/consent.php,src/js/ai-connectors.js,src/scss/ai-connectors.scss, allbuild/js/ai-connectors.*artifacts, and all associated PHPUnit tests. Modifications:Activator.php,Deactivator.php(retains unconditional cron-clear as belt-and-suspenders per FR-004),Main.php(drops all OAuth REST route + infra wiring + 4 OAuth-table bootstrap/reconcile calls),admin/Main.php(dropsmaybe_enqueue_ai_connectors_app()),admin/Partials/ServerTabs/Registry.php(drops built-inAIConnectorsTabentry — companion re-registers via existingacrossai_mcp_manager_server_tabsfilter at priority 35),uninstall.php(drops OAuth DROP TABLE lines + cron-clear + narrows theacrossai_mcp_%option sweep to excludeacrossai_mcp_connector_%),webpack.config.js(dropsjs/ai-connectorsentry), andpublic/Discovery/ConnectionMethodRegistry.php(FR-019: swapsConnectorProfileRegistryFQN to the companion namespace and guards withclass_exists()so the discovery API returns an emptyai_connectorcategory when the add-on is absent). Coordination invariant: the companion at v0.5.0+ has been audited across 44 checks (23 structural readiness + 21 wiring counterparts) and is deployable — the migration is atomic via the companion’sclass_exists( '\AcrossAI_MCP_Manager\Includes\OAuth\AuthorizationController' )self-disable probe. No compat shim, noRequires Plugins:header, no admin notice — per clarifications Q4/Q5/Q6, this feature adds ZERO new code (pure deletions + header version bump). Durable lesson captured: when a subsystem gets its own plugin, prefer code-only migration (identical table names, identical version keys, byte-identical BerlinDB Table subclass declarations) over data-migration.
Earlier versions
- For changelog entries prior to 0.2.0 (versions 0.1.9 0.0.1), see the full release history on GitHub: https://github.com/acrossai-co/acrossai-mcp-manager/releases










