Claude AI MCP Server Setup Guide

This guide walks through connecting Claude AI to the Hudu MCP (Model Context Protocol) Server.

Once connected, Claude AI can interact directly with your Hudu instance to:

• Read documentation
• Create articles
• Update articles and set article expirations
• Archive and unarchive articles
• Create and manage article folders, and create articles in them
• Create and edit assets, and move assets to another layout
• Archive and unarchive assets
• Browse, create, and edit companies
• Archive and unarchive companies
• Create, update, and run processes, including from global process templates
• Review activity logs
• Manage labels and label types
• Assist with documentation workflows

Requirements

Before starting:

• MCP access must already be enabled in Hudu.
• MCP must be turned on for your security group, if your Admin restricts it by group.
• Your Hudu instance should be accessible over HTTPS/SSL.
• You must have a Claude AI paid plan that supports connectors/custom MCP servers.

Your MCP endpoint will typically look like:

https://yourhuduinstance.com/mcp

Enable MCP in Hudu First

Inside Hudu:

• Navigate to Admin → AI.
• Turn on the switch in the Hudu MCP (Model Context Protocol) section if it isn't already on.
• Select Copy Server URL to copy your MCP endpoint URL.

Setup in Claude AI

Step 1: Open Claude AI Settings

• Sign in to Claude AI
• Click your organization or profile menu
• Open Settings

Step 2: Access Custom Connectors

• In the admin/settings area, locate the Custom Connectors section
• Click Add Connector

Step 3: Configure the Hudu MCP Connector

When the connector window opens, enter the following information:

Connector Name

Choose a descriptive name such as:

Hudu MCP

Server URL

Enter your Hudu MCP endpoint:

https://yourhudu.com/mcp

Replace yourhudu.com with your actual Hudu URL.

Step 4: Save the Connector

• Click Save or Add Connector
• Claude AI will attempt to connect to the MCP server
• If successful, the Hudu connector will appear in your available integrations

OAuth Authorization

When connecting to the Hudu MCP server for the first time, Hudu will display an OAuth authorization screen asking the user to approve the connection.

The authorization request includes the required permissions (scopes), including:

• Read access
• Write access

Users must approve the requested scopes before the MCP connection can be established successfully.

Verify the Connection

Claude should now be able to interact with supported Hudu documentation and workflow features through the MCP server.

Example prompts:

• “Read the documentation for Client ABC”
• “Create a new article for VPN setup instructions”
• “Update the firewall documentation article with the new IP ranges”
• “Review recent activity logs in Hudu”
• “Update the phone number on the Client ABC company record”
• “Help organize and improve our documentation workflow”