Connect your AI client to Userplane MCP (the workspace server at api.userplane.io/mcp). Authentication is handled automatically via OAuth 2.1 — your client will prompt you to sign in on first use. No API keys required.
Looking to search Userplane documentation from your AI tool instead? See Documentation
MCP. Server URL
https://api.userplane.io/mcp
You need a Userplane account and workspace membership to connect. If you don’t have an account,
ask your workspace admin for an invite.
Connect your AI client
Claude
Claude Code
Cursor
VS Code
ChatGPT
Add a custom connector
Select Add custom connector.
Enter server details
Enter a name (e.g., userplane) and the MCP server URL:https://api.userplane.io/mcp
Authorize
On first use, Claude opens a browser window for Userplane sign-in. Log in with your credentials and click Allow on the consent screen. Start using it
Open a new conversation, select the attachments button (the + icon), then select your Userplane connector. Add the server via CLI:claude mcp add --transport http userplane https://api.userplane.io/mcp
userplane server should appear in the list. On first tool call, Claude Code opens a browser window for Userplane sign-in.The Userplane Claude Code plugin installs both MCP servers
automatically alongside 14 framework skills and 4 slash commands. If you’re using Claude Code,
the plugin is the fastest setup path. Open the command palette
Press Cmd+Shift+P (or Ctrl+Shift+P on Windows/Linux).
Open MCP settings
Search for Open MCP settings and select it. This opens mcp.json.
Configure the server
Add Userplane to the mcpServers object:{
"mcpServers": {
"userplane": {
"url": "https://api.userplane.io/mcp"
}
}
}
Authorize
On first use, Cursor opens a browser window for sign-in. Log in and approve access.
Create the config file
Create a .vscode/mcp.json file in your project root.
Configure the server
Add Userplane as a server:{
"servers": {
"userplane": {
"type": "http",
"url": "https://api.userplane.io/mcp"
}
}
}
Authorize
On first tool call, VS Code opens a browser window for Userplane sign-in.
Open Settings
Open Settings in ChatGPT. Enable Developer Mode
Under Connectors, enable Developer mode. This is required to register custom MCP servers. Open Connectors
Return to Connectors and select Create. With Developer mode enabled, the custom connector form becomes available. Add the Userplane MCP server
Enter a name (e.g., userplane) and the MCP server URL:https://api.userplane.io/mcp
Authorize
On first use, ChatGPT opens a browser window for Userplane sign-in. Log in with your credentials and click Allow on the consent screen. Start using it
The Userplane connector appears under your enabled apps in ChatGPT. Start a new conversation and reference a recording URL or ask the agent to list your workspaces. Try it out
Verify your connection
Ask your agent to list your workspaces:List my Userplane workspaces.
Analyze a recording
Copy a recording URL from the Userplane dashboard and paste it into your AI client. The agent extracts the workspace and recording IDs from the URL and fetches the session data.Here's a recording from a customer reporting a checkout issue:
https://dash.userplane.io/{workspaceId}/recordings/{recordingId}
What's causing the problem?
Explore interactive viewers
Ask your agent to show a recording. In Claude and ChatGPT, this opens an interactive viewer with video playback, console logs, network requests, and user actions.Show me the full recording for {recordingId} in workspace {workspaceId}.
Interactive viewers render in Claude (desktop and web) and ChatGPT. Other clients display the same data as structured text. See MCP Apps for details. Create a recording link
Ask your agent to create a recording link for a customer issue.Create a recording link for domain {domainId} in workspace {workspaceId}. Reference it as {ticketId}.
Tips
Agents work best when you provide specific recording IDs or dashboard URLs. Copy the URL directly
from your browser when viewing a recording in the dashboard.
You can chain requests in a single conversation. Start with “Show me the recording” and follow up
with “Now focus on the network errors” or “What did the user do right before the error?”
Related articles
