This guide will go over the Hudu MCP (Model Context Protocol) Server that enables seamless interaction between AI-powered tools and a Hudu instance.
This integration unlocks a powerful new workflow: AI-assisted documentation management, content creation, and auditing, directly inside Hudu.
What This MCP Server Enables
The MCP server acts as a bridge between AI clients (such as Cursor) and Hudu’s API, exposing structured, reliable access to key resources.
Article Management
The MCP server provides full coverage for Hudu articles, including:
Read articles (bulk)
Articles can be retrieved via an Index operation, allowing Cursor to browse and reason over large sets of documentation.Read articles (single)
Individual articles can be fetched via Show, enabling targeted access to specific pieces of documentation.Create new articles
Cursor can generate and publish entirely new articles directly into Hudu.-
Edit existing articles
The server supports updates to:Article name
Article content
Draft status (draft vs. published)
This makes it possible to use AI for drafting, refining, and maintaining documentation without leaving your editor.
Activity Log Access
In addition to article management, the MCP server exposes Hudu activity logs:
Read activity logs (bulk) via Index
Read activity logs (single entry) via Show
This allows AI tools to inspect recent changes, understand historical context, and assist with audits or reviews.
Current Permissions & Limitations
The MCP server currently supports:
- Create articles
- Read articles
- Update articles
- Read Assets
The MCP server currently does not support:
- Deleting articles
- Editing audit logs
- Editing, creating, or deleting assets
Before You Begin
Before connecting any AI client, you must first enable MCP access inside Hudu.
You should also ensure your Hudu instance is accessible over SSL/HTTPS if you plan to connect to cloud-based AI services such as Claude or ChatGPT.
For most environments, your MCP endpoint will look similar to:
https://yourhuduinstance.com/mcp
Enable MCP Access in Hudu
Inside Hudu:
- Navigate to:
Admin → External Apps → Model Context Protocol (MCP)- MCP access is disabled by default.
- Click Enable Access to get started.
- Once enabled, Hudu will expose the MCP endpoint for external AI clients.
- When an AI client connects, users will authenticate through Hudu OAuth and approve permissions for the available tools.
Connecting AI Clients
Each AI platform has a slightly different setup process. Detailed setup instructions for each platform are provided in their own dedicated guides:
Most MCP-compatible editors or AI clients will follow a similar process:
- Add the MCP server URL
- Authenticate through Hudu OAuth
- Approve permissions
- Start using Hudu tools inside the AI client