Installation | AI Connector docs

There are three ways to install Axtolab AI Connector. Pick whichever matches how you usually manage WordPress plugins.

Option 1 — WordPress.org directory (recommended)

This is the standard install path and the one we recommend for almost everyone. Plugin updates flow automatically through your normal WP plugin update workflow.

In your WP admin, go to Plugins → Add New.
Search for “Axtolab AI Connector”.
Click Install Now, then Activate.

That’s it. The plugin appears under AI Connector in the WP admin sidebar.

Option 2 — Manual zip upload

Use this when:

Your host blocks direct plugin installs
You need to test a specific version
You’re installing on a staging environment that can’t reach WP.org

Download the latest release from github.com/Axtolab/wordpress-mcp-server/releases — pick the wp-mcp-gateway-*.zip asset.
In WP admin, go to Plugins → Add New → Upload Plugin.
Select the downloaded zip, click Install Now, then Activate.

Option 3 — WP-CLI

For automated provisioning, dev environments, and devops pipelines:

wp plugin install wp-mcp-gateway --activate

To install a specific version:

wp plugin install https://downloads.wordpress.org/plugin/wp-mcp-gateway.1.0.0.zip --activate

The technical slug is wp-mcp-gateway (kept stable for backward compatibility with existing installs). The user-facing brand is “Axtolab AI Connector”.

System requirements

Requirement	Minimum	Recommended
WordPress	6.5	6.7 or later
PHP	7.4	8.1 or later
Memory limit	128 MB	256 MB
HTTPS	Optional in dev	Required in production for OAuth

OAuth 2.1 requires HTTPS in production. Local dev environments can use HTTP, but plan for HTTPS before going live — it’s a hard requirement of the OAuth spec, not an Axtolab choice.

Updating

The plugin uses WordPress’s built-in update mechanism. When a new version ships, you’ll see the standard update notice on the Plugins page.

For zero-downtime production updates:

Test the new version on a staging site first
Disable any AI agents from making changes during the upgrade window
Update via Plugins → Update
Re-enable connections; existing OAuth tokens remain valid across updates

We follow semantic versioning. Patch versions (1.2.x → 1.2.y) are always backwards-compatible. Minor versions (1.2 → 1.3) may add new tools but won’t break existing ones. Major versions (1.x → 2.x) signal breaking changes — we publish a migration guide before shipping any major.

Uninstalling

Deactivating the plugin pauses all AI connections without losing any configuration. If you reactivate, your connections, identities, and audit logs are preserved.

Deleting the plugin (Plugins → Deactivate → Delete) wipes:

All OAuth client registrations and tokens
Audit log entries
Per-agent identity records
Plugin settings

Database tables and uploaded media stay intact — only AI Connector’s own data is removed.

Where to go next

Getting started — connect your first AI agent
OAuth setup — detailed walkthrough for each AI client
Troubleshooting — common install issues and fixes