MCP Setup

Connect your AI assistant to UserHero in two steps: get an API key, then configure your client.

Step 1: Get Your API Key

Go to UserHero Dashboard → Account Settings → API Keys
Click "Create API Key"
Select the scopes you need (see API Key Scopes below)
Copy the secret key — it's only shown once!

Store your API key securely. Anyone with access can read and modify your feedback data based on the scopes granted.

Step 2: Configure Your Client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "userhero": {
      "url": "https://mcp.userhero.co/sse",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to user settings (~/.vscode/settings.json):

{
  "mcp": {
    "servers": {
      "userhero": {
        "url": "https://mcp.userhero.co/sse",
        "headers": {
          "Authorization": "Bearer sk_live_your_key_here"
        }
      }
    }
  }
}

Cursor

Add to Cursor MCP settings:

{
  "mcpServers": {
    "userhero": {
      "url": "https://mcp.userhero.co/sse",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

Windsurf

Add to Windsurf MCP settings:

{
  "mcpServers": {
    "userhero": {
      "serverUrl": "https://mcp.userhero.co/sse",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

API Key Scopes

Choose the minimum scopes needed for your use case:

Scope	Description
`workspaces:read`	List and view workspaces
`projects:read`	List and view projects
`projects:write`	Create, update, delete projects
`widgets:read`	List and view widgets
`widgets:write`	Create, update, delete widgets
`feedback:read`	List and view feedback
`feedback:write`	Update feedback status, add notes
`feedback:delete`	Delete feedback items
`integrations:read`	List integrations
`integrations:write`	Create and delete integrations
`automations:read`	List and view automations
`automations:write`	Create, update, delete, and run automations

Even with all scopes enabled, you can only access resources in workspaces where you're a member. Your workspace role (owner/admin/member/viewer) determines what actions you can perform.

Verify Connection

After configuring, test the connection by asking your AI assistant:

"List my UserHero workspaces"

You should see a list of workspaces you have access to.

Troubleshooting

"Authentication failed"

Verify your API key is correct and hasn't been revoked
Check the key has the required scopes
Ensure the Authorization header format is Bearer sk_live_...

"Permission denied"

Your workspace role may not allow the requested action
Check RBAC permissions for your role

"Rate limit exceeded"

Wait a minute before retrying
The limit is 100 requests per minute per API key

MCP Setup

On this page