Connecting WordPress

Overview

Connecting WordPress enables powerful content automation and management:

• Content editing via MCP commands
• Automated blogging with the AI blogger
• SEO optimization tools
• Performance monitoring
• Content scheduling

This guide covers installing the MCP plugin and configuring the connection.

Prerequisites

Before you begin, ensure you have:

• WordPress site (self-hosted, version 5.0+)
• Admin credentials for the WordPress dashboard
• FTP or file manager access (for manual plugin installation)
• af-gemini-connect account with integration permissions

Step-by-Step Connection

1. Install the MCP Plugin

There are two installation methods:

A. Automatic Installation (Recommended)

1. In af-gemini-connect, go to Admin → Integrations
2. Select WordPress tab
3. Click Install Plugin Automatically
4. Enter your WordPress site URL and admin credentials
5. The plugin will be installed and activated automatically

B. Manual Installation

1. Download the MCP WordPress plugin from the GitHub releases page
2. In your WordPress dashboard, go to Plugins → Add New
3. Click Upload Plugin
4. Upload the downloaded ZIP file
5. Activate the plugin

2. Configure the MCP Plugin

1. In WordPress, go to Settings → MCP Configuration
2. Enter your af-gemini-connect API key (found in your account settings)
3. Configure the following options:
   • Enable Content Editing: Allow AI to edit posts/pages
   • Enable Blogging: Enable automated blog post creation
   • SEO Tools: Enable AI-powered SEO suggestions
   • Performance Monitoring: Enable site speed monitoring
4. Click Save Settings

3. Connect in af-gemini-connect

1. In af-gemini-connect, go to Admin → Integrations
2. Select WordPress tab
3. Click Connect WordPress Site
4. Enter your WordPress site URL
5. Click Connect

4. Authorize the Connection

1. You'll be redirected to your WordPress login screen
2. Log in with admin credentials
3. Approve the connection permissions
4. You'll be redirected back to af-gemini-connect

Connection Health Monitoring

Once connected, monitor your WordPress integration in the Integrations dashboard:

• Connection Status: Connected/Disconnected
• Last Sync: When content was last synchronized
• Plugin Version: Ensure you're running the latest version
• Error Logs: Any plugin errors or connection issues

Rotating Credentials Without Reconnecting

If a site's stored WordPress username or application password needs to change — the password was reset, or a client rotated it on their end — you don't need to remove the connection and set it up again.

On the client's Websites tab, find the site's card and click Update Credentials (it only shows once the site already has a WordPress connection). Enter the new username and/or application password and save; leave either field blank to keep its current value.

Troubleshooting

"Plugin not found" error during automatic installation

• Verify your WordPress URL is correct
• Ensure your site is publicly accessible
• Check that the site is running WordPress 5.0 or higher
• Try manual installation instead

Authentication failures

• Verify your WordPress admin credentials
• Ensure the MCP plugin is activated
• Check that your af-gemini-connect API key is valid

Content not syncing

• Verify the plugin is activated and configured
• Check your API key permissions
• Ensure the connection is active in af-gemini-connect

Plugin conflicts

• Deactivate other plugins temporarily to identify conflicts
• Ensure you're using the latest plugin version
• Check PHP version compatibility (requires PHP 7.4+)

A plugin update added a feature that isn't showing up on the site

• Some plugin releases add new configuration fields (for example, a tracking ID used by a new capture feature). These fields only reach the site the next time its update settings are pushed.
• If a site was updated but a new feature still isn't active, ask your AI assistant to re-push the plugin's update configuration for that site. This uses the wordpress_reconfigure_plugin_updates MCP tool. It's flagged as a destructive action, so it will ask for confirmation before running.
• See the MCP Tool Reference for details.

Best Practices

1. Keep the plugin updated to ensure compatibility and security
2. Use a staging site for testing before connecting production sites
3. Set up proper user roles to control AI access levels
4. Monitor plugin performance to avoid slowing down your site
5. Regular backups before major updates or configuration changes

Next Steps

After connecting WordPress, you can:

• Set up automated content calendars
• Configure AI blogging workflows
• Implement SEO optimization routines
• Set up performance monitoring alerts
• Integrate with Google Search Console

FAQ

Q: Can I connect multiple WordPress sites?
A: Yes, you can connect unlimited WordPress sites from a single af-gemini-connect account.

Q: Does the plugin work with multisite networks?
A: Yes, but each site needs to be connected individually.

Q: Is content edited by the AI automatically published?
A: No, all AI edits require manual approval before publication.

Q: What happens if I disconnect a site?
A: Disconnecting will stop all synchronization and AI editing capabilities.

Q: Can I use the plugin with WordPress.com?
A: No, the plugin requires a self-hosted WordPress.org installation.