Getting Started

Set up UserDispatch in under two minutes. One command installs the feedback widget, configures MCP for your AI agent, and connects everything.

Prerequisites

Node.js 18 or later
A web application (any framework)
An AI coding agent (Claude Code, Cursor, Windsurf, or Claude Desktop) — optional but recommended

One-command install

The fastest way to get started. Run this in your project directory:

npx userdispatch init

The CLI walks you through six steps:

Authenticate

Opens your browser to sign in with Google. Copies a ud_ token back to the terminal.

Create organization & app

Sets up your org (if new) and creates an app with an API key.

Install widget

Detects your framework (Next.js, Vite, Nuxt, SvelteKit, etc.) and injects the widget script tag into your layout file. Also installs the @userdispatch/sdk package.

Configure MCP

Detects your AI coding agent and writes the MCP server configuration so your agent can manage submissions.

Verify

Confirms the API key works and submissions can be created.

Summary

Shows what was created and modified, plus next steps.

The CLI only modifies your layout file, MCP config, and .gitignore. Tokens stay local. Full security details →

Manual setup (alternative)

If you prefer to set things up yourself:

Create an account

Create an organization

Follow the onboarding flow to name your org and set a slug.

Create an app

Go to Apps in the sidebar and create a new app. The app name should match the project you're collecting feedback for (e.g. “My SaaS App”, “Mobile App”) so you can organize feedback per project in the dashboard. Copy the API key.

Add the widget script

Add this tag to your HTML, replacing the API key with yours:

HTML

<script
  src="https://userdispatch.com/widget.js"
  data-api-key="pk_your-api-key"
  defer
></script>

This adds a floating feedback button as an overlay in the bottom-right corner of your app. Users can click it to submit feedback, bug reports, or questions. You can customize its position, label, and which fields are shown — see the Widget docs for all configuration options.

Configure MCP (optional)

See the MCP Server docs for setup instructions.

Your first submission

Start your dev server — this reloads your app with the widget injected so you can test the full feedback flow end-to-end
Click the Feedback button in the bottom-right corner
Submit a test feedback entry
Open your dashboard — your submission appears in the inbox. You'll also receive an email notification for every new submission. You can manage notification preferences in Profile → Notifications in your dashboard

Connect your AI agent

If you ran npx userdispatch init, your MCP server is already configured. Restart your coding agent, then try:

“Show me my users' feedback submissions”

“Triage my inbox and draft replies for any bug reports”

“Generate a weekly digest of all feedback from the last 7 days”

Next steps

Dashboard — Submissions, apps, team members, notification settings
Widget — Configuration options, framework guides, JavaScript API
MCP Server — Agent setup, tools, resources, prompts, workflows
API Reference — REST endpoints, authentication, rate limits
CLI Reference — Flags, non-interactive mode, troubleshooting