Skip to main content

​
Overview

The Userpilot MCP server connects AI assistants to your Userpilot account. Once connected, you can ask questions in plain language, such as “How did my signup funnel perform last month?”, and the assistant reads the answer directly from your Userpilot data. You can also ask it to create things for you, such as segments, reports, dashboards, and survey drafts. MCP (Model Context Protocol) is an open standard that AI tools use to talk to other products. Userpilot hosts the server for you: you connect from the AI tool you already use and sign in with your regular Userpilot login. There is nothing to install or configure inside Userpilot.

​
Use Cases

  • Ask analytics questions: “What’s the completion rate of my onboarding funnel this quarter?” or “Show retention for users who used the export feature.”
  • Explore users and companies: “Which companies were most active this week?” or “Summarize this user’s recent activity.”
  • Build as you think: “Create a segment of users who completed onboarding but never opened reports” or “Build a dashboard for my activation metrics.”
  • Draft surveys: “Draft a short survey asking users why they canceled.” You review and publish it in Userpilot.
  • Look things up while you work: “What audience does the ‘New user tour’ flow target?” or “List the events we track on the checkout page.”

​
What you need

  • A Userpilot account. The MCP server is available on all plans, and your plan’s feature limits apply the same way they do in the app.
  • An AI tool that supports remote MCP servers (sometimes called custom connectors), for example Claude or Claude Code.
The server address is:

​
Connect your AI tool

Custom connectors are available on paid Claude plans. On Team and Enterprise plans, a Claude admin adds the connector once for the organization; every member then connects it with their own Userpilot login.
1

Add the connector (admin)

Open the account menu (your name, bottom left) and go to Organization settings → Connectors (under “Libraries & Access”). Click + Add → Custom → Web.In the Add custom connector dialog, name it “Userpilot” and paste the server address above into Remote MCP server URL. Leave the Advanced settings fields empty — Userpilot registers automatically. Keep Individual sign-in switched on, then click Add.On a personal account, add the same connector under Settings → Connectors instead.
2

Sign in to Userpilot

Click Connect on the Userpilot connector. Your browser opens the Userpilot sign-in. Log in as you always do (SSO included). On team plans, each member does this once with their own login.
3

Choose permissions

Userpilot shows a permission screen. Tick the access you want to grant and approve.
Claude can now use Userpilot in your chats. You can toggle it per conversation from the tools menu.

​
Choose what the assistant can access

When you connect, Userpilot shows a permission screen. You decide what the assistant can see and change: A few things to know:
  • You can change your mind later. To grant a permission you skipped, connect again from your AI tool: the permission screen appears and remembers what you approved before.
  • Write permissions need the read permission. The screen enforces this automatically.
  • Changes are real. Segments, reports, and dashboards the assistant creates or updates take effect immediately, just as if you made the change in the app.

​
What the assistant can and can’t do

With the permissions you grant, the assistant can:
  • Run and read analytics: funnels, trends, retention, paths, saved reports, and dashboards.
  • Look up your product setup: flows, surveys, events, pages, features, segments, and more.
  • Read user and company lists and profiles.
  • Create and update segments, reports, dashboards, and survey drafts.
  • Go beyond the basics: when a question needs it, the assistant can search hundreds of additional read-only operations.
It can never:
  • Build or publish in-app content such as flows and banners (content building stays in the Userpilot builder).
  • Delete anything.
  • Access team management, billing, account settings, or other administration areas.
  • Do anything your own Userpilot role doesn’t allow.

​
Working with multiple apps

If your account has more than one app, the assistant can list the ones you have access to and ask which one to use. It remembers your choice for the connection, and you can tell it to switch at any time.

​
Security and privacy

  • Your login, your permissions. The connection runs under your own Userpilot user. The assistant can only see and change what your role allows, in the apps you have access to.
  • You control the scope. The permission screen decides what is reachable; everything outside it is refused by Userpilot’s servers, not by the assistant’s judgment.
  • No destructive access. Delete operations and administration areas are not available through the connection at all.
  • Built-in limits. Rate limits automatically contain runaway or abusive usage.
  • Disconnect anytime. Remove the connector in your AI tool to stop new access. Without the “keep active” permission, access also expires on its own shortly after each sign-in.
Data the assistant reads through this connection is processed by your AI provider (for example, Anthropic for Claude) under that provider’s terms. Review your organization’s AI policies before connecting tools to customer data.

​
FAQs

Any tool that supports remote MCP servers with OAuth sign-in. Claude and Claude Code are documented step by step above; for other tools, use the server address and follow the tool’s own instructions for adding an MCP server or custom connector.
You skipped that permission when connecting. Connect again from your AI tool. The permission screen appears with your earlier choices remembered; tick the missing one.
Your access to that app changed. Ask the assistant to list your workspaces and pick one you can access.
Only within the write permissions you granted, and never beyond them: segments, reports, dashboards, and survey drafts. It cannot delete anything, publish content, or touch account settings. If you grant no write permissions, the connection is read-only.
Anyone with a Userpilot login. On Claude Team and Enterprise plans, a Claude admin adds the connector once for the organization; each member then connects and signs in as themselves, and their connection mirrors their own role and app access.
Your AI tool keeps its own copy of the tool list. In Claude, open the Userpilot connector’s settings and use Refresh tools; disconnecting and reconnecting alone does not refresh the list.
Remove the connector in your AI tool. If you need a connection revoked on the Userpilot side (for example, for a teammate who left), contact support.
For any questions or concerns please reach out to support@userpilot.com