Authentication setup
Set up AI Connector with the .mcpb desktop bundle, OAuth for web clients, or WordPress Application Passwords.
Updated
Axtolab AI Connector supports multiple ways to let an AI client talk to your WordPress site. Use the method your client supports.
Which method should I use?
| Situation | Recommended method |
|---|---|
| Claude Desktop / compatible local MCP client | Download the .mcpb extension from the AI Connector setup page and paste a connection token |
| Web client with custom connector support (Claude Web, ChatGPT) | OAuth |
| Bespoke client only supporting username/password-style auth | WordPress Application Passwords |
Start from AI Connector in wp-admin. The plugin screen is the source of truth for the exact connection details for your site.
Guided connector setup
Some desktop clients can use a connector bundle or guided setup file.
- In WordPress admin, open AI Connector.
- Open the connection/authentication area.
- Choose the guided desktop/client setup option if it is shown.
- Follow the on-screen download or copy instructions.
- Open your AI client and add the connector.
- Return to the AI client and run a read-only test: “List my five most recent posts.”
If your client does not show the connector immediately, restart the client and check its connector/MCP settings.
OAuth setup
OAuth is the best option when your AI client supports it. The client receives a scoped token instead of your WordPress password, and you can revoke the connection later.
- In WordPress admin, open AI Connector.
- Choose Add connection, Authorize, or the equivalent OAuth option.
- Select a narrow permission preset for the first connection.
- Copy the connector URL or authorization details if your client asks for them.
- Complete the authorization prompt.
- Test with a read-only request.
Use HTTPS on production sites. OAuth flows may fail on live HTTP sites.
Application Passwords fallback
Application Passwords are a WordPress fallback for clients that do not support OAuth or guided connector setup.
- In WordPress admin, go to Users → Profile.
- Scroll to Application Passwords.
- Create a new password named for the AI client.
- Copy the generated password immediately.
- Add your WordPress site URL, username, and generated password to the client.
Application Passwords are convenient, but less precise than connector-scoped authorization. Rotate them periodically and delete any you no longer use.
Managing connections
Use AI Connector in wp-admin to review and remove connections.
Recommended habits:
- Create separate connections for separate clients or people.
- Use a narrow permission preset for each connection.
- Revoke old test connections.
- Re-test with read-only requests after changing permissions.
First verification prompt
After any setup method, ask your AI client:
List the five most recent posts on my WordPress site, including title and status.
If that works, the connection is live. If it fails, check Troubleshooting.
Question about this page?
This form tags your question with the product, docs page, and category so support can triage it quickly.