WordPress AI Connect — Installation & Setup Guide

Overview

Goldnat AI Connect for WordPress turns your WordPress site into a Servio Protocol tool server for AI agents. You install a plugin, generate a token, and paste the prompt into your AI agent (Claude / ChatGPT / goldnat.ai / any MCP client). From that moment the agent can search posts, read pages, and identify the current user — all under the permissions of the user who generated the token.

What you get:

• 5 free tools — Read-only basics: getCurrentUser, searchPosts, getPost, searchPages, getPage
• Pro upgrade — 6 more tools for content management (create/edit/delete + media upload)
• Additional Pro extensions — Elementor (9 tools) and WooCommerce (17 tools)

Prerequisites

• WordPress 6.0 or higher
• PHP 7.4 or higher (8.1+ recommended)
• Permalinks set to “Post name” format or equivalent
• HTTPS recommended (required for goldnat.ai integration)
• Administrator role on the site

Installation

1. In WordPress admin, go to Plugins → Add New and search for “Goldnat AI Connect” in the official WordPress.org plugin directory. (Alternatively, download the plugin from your personal area at goldnat.ai and upload it via Plugins → Add New → Upload Plugin.)
2. Click Install Now on the plugin.
3. After installation → click Activate.
4. A new menu item AI Connect appears in the admin sidebar.

Connecting to an AI Agent

1. Go to AI Connect → My Tokens.
2. Click Generate Prompt — a ready-to-paste text block appears for your AI client of choice:
   • Claude Desktop — via the Goldnat MCP extension
   • ChatGPT / Gemini / Grok — direct connection to the manifest URL
   • goldnat.ai — add the site to your vault
3. Copy the prompt and paste it into your agent.
4. The agent performs OAuth 2.0 + PKCE automatically — you’ll get a consent screen in your browser.
5. Approve → the agent is connected.

First Test

Ask your AI agent one of these three prompts:

• “Who am I on this site?” → Should call wordpress.getCurrentUser.
• “Search for the 5 most recent posts on the site.” → Should call wordpress.searchPosts with limit=5.
• “What’s in the About page?” → Should call wordpress.searchPages and then wordpress.getPage.

If all three requests work → the plugin is connected correctly.

Reconnecting (when the token expires)

Access tokens are valid for 1 hour, refresh tokens for 30 days. If you see a “Token expired” error:

1. Go to AI Connect → My Tokens.
2. Click Revoke on the old token.
3. Click Generate Prompt again.
4. Paste the new prompt into your agent.

Tip: Most agents refresh the token automatically every hour, so you typically only reconnect manually once every 30 days.

Token Management

Column	Meaning
Prefix	First 16 characters (identification only)
Created	Creation timestamp
Last used	Most recent request timestamp
IP	IP address of the agent
User Agent	Client identifier (Claude, ChatGPT, etc.)
Actions	Revoke — immediate cancellation

Filters: Active / Renewable / Unused / Inactive / Revoked / All. Bulk revoke available for inactive tokens (30+ days).

Uninstalling the Plugin

1. Revoke all tokens first (recommended)

• AI Connect → My Tokens → Revoke All. Kills every active agent session immediately.

2. Deactivate the plugin

• Plugins → Installed Plugins → find Goldnat AI Connect → click Deactivate.
• The plugin stops working, but DB tables and options remain.

3. Delete the plugin (optional)

• After deactivation → click Delete. WordPress removes the plugin files.

4. Clean the DB (only for a fresh reinstall)

DROP TABLE IF EXISTS wp_aiconnect_tokens;
DROP TABLE IF EXISTS wp_aiconnect_audit;
DELETE FROM wp_options WHERE option_name LIKE 'aiconnect_%';

Warning: Deletes token history, audit logs, and settings permanently. Take a full DB backup first.

Common Troubleshooting

Error	Likely cause	Fix
Manifest not found (404)	Permalinks not configured	Settings → Permalinks → Save
Token expired and non-refreshable	Token permanently expired	Reconnect (see above)
Rate limit exceeded	Too many requests in a short window (default 50/minute)	Wait a minute, or raise the limit in the plugin settings
Bearer token required	Agent isn’t sending the token	Regenerate the prompt in full

Support

Need help? Contact us and we’ll get back to you.

Video Tutorial (Coming Soon)

A 3-4 minute video will appear here covering: (A) What is Goldnat AI Connect on the Servio Protocol, (B) installing the plugin, (C) connecting to Claude Desktop, (D) live usage — 3 typical requests.