Getting started | AI Connector docs

This guide walks you through installing Axtolab AI Connector, connecting your first AI agent, and running your first command — start to finish in about five minutes.

By the end you’ll have an AI agent (Claude Desktop, ChatGPT, Cursor, or another MCP client) able to read and write your WordPress site through a structured, OAuth-authenticated interface.

What you need before starting

A WordPress site running version 6.5 or later
Admin access to that site
An MCP-compatible AI client installed locally — Claude Desktop is the easiest place to start
About five minutes of attention

Step 1 — Install the plugin

The fastest path is the WordPress.org plugin directory.

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

Once activated, you’ll see a new AI Connector menu item in the WordPress sidebar. Open it.

If you’d rather install manually or you’re running a development environment, see the Installation guide.

Step 2 — Connect your AI agent

The AI Connector page in WP admin shows a Connections tab. Click Add Connection.

You’ll see three connection methods:

OAuth 2.1 (recommended for Claude, ChatGPT, Cursor) — modern token-based auth with revocable scope
Device Auth — for headless agents and CLI clients
Application Passwords — fallback for clients that don’t support OAuth yet

For most users, OAuth 2.1 is the right choice. The full walkthrough — including which agent uses which method — is in the OAuth setup guide.

For a Claude Desktop quickstart:

Click Connect Claude Desktop on the AI Connector page.
Approve the OAuth request that opens in your browser.
Claude Desktop will receive the connection automatically. You should see “Axtolab AI Connector” appear in Claude’s MCP server list.

Step 3 — Run your first command

Open Claude Desktop. Start a new conversation and type:

Show me the five most recent posts on my WordPress site.

Claude should respond with a list of your most recent posts, pulled live from the connector. If you see an error or no response, jump to Troubleshooting.

Try a few more:

Draft a 300-word blog post about [topic] and save it as a draft.

Update the title of post ID 42 to “New Title”.

List all products in my WooCommerce store with stock under 5.

Drafts get created in your WP admin where you’d expect them. Edits show up immediately. Nothing publishes without explicit approval.

What the connector can do

The connector ships with a set of MCP tools covering the most common WordPress workflows:

Posts and pages — read, draft, edit, schedule, publish, delete
Media — upload, set featured image, edit alt text
Comments — list, moderate, reply
Taxonomies — categories, tags, custom taxonomies
Yoast SEO — title, meta description, focus keyword
WooCommerce — basic product reads (full WC capability is in the WooCommerce add-on)

The full reference is in Supported tools.

Where to go next

Multiple agents? Read the OAuth setup guide to understand per-agent connections.
Production site? Review Security best practices before connecting agents to a live site.
Want more capability? Check the add-on modules — image generation, billing protection, per-agent permissions, multisite, WooCommerce.
Stuck? Troubleshooting covers common issues.