XenForo AI Connect — Installation & Setup Guide

Overview

Goldnat AI Connect for XenForo (add-on: chgold/AIConnect) turns your forum into a Servio Protocol tool server. The Free add-on ships 5 read tools — search threads, get a full thread, search posts, get a post, and identify the current user. The Pro add-on (chgold/AIConnectPro) adds 5 write tools — create threads, reply, edit posts, send conversations, and list forums.

What you get:

• 5 free tools — searchThreads, getThread, searchPosts, getPost, getCurrentUser
• Built-in translation — translation.translate + translation.getSupportedLanguages (XenForo-exclusive bonus)
• Pro upgrade — getForumList, createThread, replyToThread, editPost, sendConversation
• Future editions: xenforo-engagement-pro and xenforo-moderation-pro (Reactions, Reports, Ban)

Prerequisites

• XenForo 2.2.0 or higher
• PHP 7.2 or higher (8.1+ recommended)
• MySQL/MariaDB 5.7+
• Friendly URLs enabled (Options → Basic board information)
• HTTPS recommended
• “Manage add-ons” admin permission

Installation

1. Download the latest add-on ZIP from the official XenForo Resource Manager (or from your personal area at goldnat.ai).
2. Extract to src/addons/chgold/AIConnect/.
3. Admin → Add-ons → Install/upgrade an add-on — select chgold/AIConnect → Install.
4. Add-ons → chgold/AIConnect — verify status is “Active”.
5. Options → AI Connect → Verify manifest — clicking “Test” should return ✅.

Connecting to an AI Agent

1. Members → Your account → AI Connect Tokens (or /account/webmcp-tokens).
2. Generate Prompt — a ready-to-paste BBCode/Markdown block appears.
3. Copy and paste into your agent:
   • Claude Desktop: via the Goldnat MCP extension
   • goldnat.ai: add https://your-forum.example/ to your vault
   • ChatGPT / Gemini: connect directly to /api/aiconnect-manifest
4. OAuth PKCE runs in the browser → approve.

First Test

• “Who am I on the forum?” → xenforo.getCurrentUser
• “Search threads about AI” → xenforo.searchThreads with search=AI
• “What does post #3738 say?” → xenforo.getPost with post_id=3738

With Pro:

• “Create a new thread in the ‘General’ forum” → xenforo_pro.createThread
• “Reply to this post with the following message” → xenforo_pro.replyToThread

Reconnecting

Tokens valid for 30 days. Automatic refresh every hour. Manual reconnect:

1. Your account → AI Connect Tokens → Revoke the old token.
2. Generate Prompt again → paste into your agent.

Token Management

Like the other plugins: /account/webmcp-tokens page with 6 filters (Active / Renewable / Unused / Inactive / Revoked / All), bulk revoke, and last_used_ip + last_used_ua display.

Uninstalling the Add-on

1. Revoke all tokens

• Your account → AI Connect Tokens → Revoke All — kills every active agent session.

2. Disable the add-on

• Admin → Add-ons → chgold/AIConnect → Disable.
• The add-on stops working, but DB tables remain intact.

3. Uninstall the add-on

• Admin → Add-ons → chgold/AIConnect → Uninstall.
• XenForo prompts you to confirm removal of DB tables → confirm.

4. Remove the files

rm -rf src/addons/chgold/AIConnect/
# Also for Pro:
rm -rf src/addons/chgold/AIConnectPro/

5. Rebuild caches

php cmd.php xf-rebuild:caches

Common Troubleshooting

Error	Cause	Fix
Manifest not found	Friendly URLs disabled	Options → Basic → Enable Friendly URLs
Add-on files are missing	Files not extracted properly	Run xf-rebuild:addon via CLI
Route not registered	Rebuild missing	php cmd.php xf-addon:build-release chgold/AIConnect
Bearer token invalid	Prefix mismatch	Ensure the URL in the token matches the URL in the prompt

Support

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

Video Tutorial (Coming Soon)

3-4 minute walkthrough: (A) Goldnat AI Connect on the Servio Protocol, (B) installing the add-on in XenForo admin, (C) connecting to an AI agent, (D) 3 typical forum queries.