Skip to main content
The plugin auto-loads both Userplane MCP servers. No manual configuration needed — they register when you install the plugin and authenticate via OAuth on first use.

Bundled servers

ServerURLAuthenticationPurpose
userplane-workspacehttps://api.userplane.io/mcpOAuth 2.1Recordings, links, projects, domains, viewers
userplane-docshttps://docs.userplane.io/mcpNone (public)Userplane documentation search

Workspace MCP

The workspace server gives the debug-agent access to recording data — console logs, network requests, user actions — for root cause analysis. It’s also available directly in conversation for ad-hoc queries.

Available tools

Recording Tools

List recordings, fetch session data, open interactive viewers

Link Tools

Create, list, and update recording links

Domain Tools

List and inspect verified domains

Workspace Tools

Profiles, workspaces, and projects

Interactive viewers

In AI clients that support MCP Apps, the workspace server renders rich viewers:
  • Recording Viewer — video playback with synchronized console, network, and action tabs
  • Resource Viewers — focused viewers for console logs, network requests, and user actions

Authentication

On the first tool call, Claude Code opens a browser window for Userplane sign-in. You authorize with your workspace account, and tokens are stored locally. See MCP Authentication for details on the OAuth 2.1 flow, permissions, and token management.
If authentication fails or tokens expire, run /mcp to view server status and re-authenticate.

Documentation MCP

The documentation server lets your agent search Userplane docs inline. It’s public — no authentication required. Useful when integrating the SDK and you need answers from the docs without leaving the conversation. See Documentation MCP for setup details, rate limits, and comparison with web search.

Verifying the servers

After installing the plugin, run:
/mcp
You should see both userplane-workspace and userplane-docs in the server list.