Securely Connect your Joomla sites to AI Agents using MCP Server

Overview

JoomAI is the MCP Server for Joomla, which allows you to connect your Joomla site to AI Agents such as ChatGPT, Claude, and other MCP-compatible clients, so users can read information about the site and perform actions on it using natural language, for example, checking site and environment details, viewing their account, and creating or updating posts, and much more.

Configuration Steps

Step 1: Install the JoomAI: MCP Server Plugin

• Download the zip file for the miniOrange JoomAI: MCP Server and AI Chatbot plugin from the link here.
• Login into your Joomla site’s administrator console.
• From Menu, click on System, then under Install section click on Extensions.
• Upload the downloaded zip file to install the JoomAI: MCP Server plugin.
• Now, go to the components -> MCP AI Server -> Configuration tab.

Step 2: Configure Joomla MCP Server

• In the Access Control section, enable the Turn on the connection toggle button.

• Now, copy the MCP Server URL from the section below. This URL will be used to connect to the AI Agent. Then, click on the Save configuration button.

Step 3: Connect Joomla MCP Server with AI Agent

• Go to your AI Agent Dashboard. For this guide, we will be using ChatGPT. Navigate to the Plugins page within ChatGPT, then click on the Add button.

• In the New Plugin window, enter a Name for your plugin (e.g., Joomla MCP Server), then paste your MCP server URL under Connection. Check the "I understand and want to continue" box, and click Create.

• A prompt will appear asking to Add Joomla MCP Server to ChatGPT. Click Sign in with Joomla MCP Server to authenticate.

• On the Sign in to ChatGPT screen, enter your Joomla site username and password, then click Continue.

• On the Authorize access screen, click Allow access to let ChatGPT connect to your Joomla! site and use its MCP tools.

• Once authorized, you'll be redirected back to ChatGPT, and the Joomla MCP Server plugin will show as connected, with your site's URL and connection details listed under Information. Your Joomla MCP Server is now ready to use in ChatGPT.
• You can now interact with your Joomla site directly through ChatGPT. For example, type a prompt like "List all the articles in my Joomla site", and ChatGPT will use the MCP tools to fetch and display the results, in this case, showing your published articles along with their category, author, hits, and creation date.

Step 4: Available Connector Tools

• Here is the list of connector tools made available by the Joomla MCP Server. You can enable or disable them based on your use case.
• Articles & Content
  • fetch_article — Retrieves a Joomla article by ID, alias, or search term (published articles only).
  • search_articles — Searches and filters articles by status, category, author, featured flag, or text.
• Extensions & Plugins
  • list_extensions — Lists installed extensions with optional filters by type or name.
  • get_plugin — Retrieves a plugin's details and version by extension ID or element/folder.
• Media
  • search_media — Searches the media library by file name or extension type.
  • get_media_file_info — Returns a media file's size, type/MIME, and upload/modified date.
• Languages
  • list_languages — Lists all installed and active site languages.
• Banners
  • get_banner_stats — Displays banner click and impression statistics.

Step 5: Setup Frontend Chatbot

• Go to the Frontend Chatbot tab. Toggle Enable frontend chatbot to Yes, then enter your Chat LLM API key, Chat model (e.g., gpt-4o-mini), and a Welcome message for visitors. Click Save chatbot settings, then click Sync site content for chatbot so the chatbot can answer using your latest published articles.

You have successfully configured JoomAI Extension. If you have any other queries, please drop us an email on joomlasupport@xecurify.com.

Related Articles

• JoomAI: MCP Server & AI Chatbot
• Joomla AI Assistant for Product Support