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
• Review activity logs
• Assist with documentation workflows

Requirements

Before you begin, make sure you have:

• Cursor installed
• Access to your Hudu instance
• Your Hudu MCP endpoint URL

Your MCP endpoint will typically look like:

https://yourhuduinstance.com/mcp

Enable MCP in Hudu First

Inside Hudu:

• Navigate to:
  • Admin → External Apps → Model Context Protocol (MCP)
• Enable MCP access if it is not already enabled.
• Confirm 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": {
    "my-server": {
      "url": "https://your-server.com/mcp"
    }
  }
}

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

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

Important Note About Transport Type

Cursor defaults to a non-SSE transport type.

Step 4: Sign In

After saving the configuration:

1. Cursor will prompt you to sign in
2. Authenticate with your Hudu instance if prompted
3. 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”
• “Review recent Hudu activity logs”
• “Help improve our documentation workflow”

/mcp