Cursor MCP Server setup guide

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

Once connected, Cursor 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 you begin, make sure you have:

• Cursor installed
• Access to your Hudu instance
• Your Hudu MCP endpoint URL
• MCP turned on for your security group, if your Admin restricts it by group

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 Cursor

Step 1. Open MCP Settings in Cursor

• Open Cursor
• Press:

Cmd + Shift + P

(on macOS)

or

Ctrl + Shift + P

(on Windows/Linux)

• This opens the Command Palette
• Search for:

View: Open MCP Settings

• Select the option to open the MCP configuration

Step 2. Install or Enable MCP Servers

• In the MCP settings view, locate the Tools section
• Find:

Install MCP Server

• MCP servers can be toggled on or off from this section

Step 3. Add the Hudu MCP Server

• Click:

Add New MCP Server

• Cursor will open the MCP configuration JSON file
• Add a new child entry under mcpServers

Example configuration:

{
  "mcpServers": {
    "hudu": {
      "url": "https://yourhudu.com/mcp"
    }
  }
}

Replace https://yourhudu.com with your actual Hudu URL.

You can also rename "hudu" to any name you prefer.

Step 4. Sign In

After saving the configuration:

• Cursor will prompt you to sign in
• Authenticate with your Hudu instance if prompted
• Once authenticated, the MCP server will become available in Cursor

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.

Example Prompts

Once connected, Cursor can assist with Hudu workflows using prompts like:

• “Read the documentation for Client ABC”
• “Create a new onboarding article”
• “Update the backup documentation for this client”
• “Archive the outdated printer setup article”
• “Update the address for Client ABC”
• “Review recent Hudu activity logs”
• “Help improve our documentation workflow”

Troubleshooting

MCP Server Does Not Connect

• Verify the MCP URL is correct
• Confirm the endpoint includes:

/mcp

• Ensure your Hudu instance is accessible externally
• Verify SSL certificates are valid

Authentication Problems

• Confirm your Hudu login credentials are correct
• Re-authenticate if the session expires
• If you see "MCP is not enabled for your group," an Admin has turned off MCP for one of your security groups. Ask an Admin to check the Access tab for each of your groups.