Install
1
Register the marketplace
Run this once to add the Userplane plugin source:
2
Install the plugin
3
Verify the plugin
userplane is listed and enabled.4
Verify MCP servers
userplane-workspace and userplane-docs in the list.First use
1
Authenticate
On the first tool call that hits the workspace MCP server, Claude Code opens a browser window for
Userplane sign-in. Log in and approve the OAuth consent screen. Tokens are stored locally.
2
Try a command
Open a project with a The agent detects your framework, loads the matching skill, and writes the integration.
package.json and run:3
Try natural language
Skills activate without slash commands too:The
userplane-web-sdk skill loads automatically.Verification checklist
Troubleshooting
Plugin not found after install The marketplace may not be registered. Re-run/plugin marketplace add userplanehq/userplane-agent, then install again.
MCP authentication failed
Your OAuth token may have expired. Run /mcp to view server status and re-authenticate.
Skills not activating
Verify the plugin is enabled with /plugin. If it shows as disabled, run /plugin enable userplane.
Not using Claude Code? Use the Codex Plugin, the Cursor
Plugin, or install skills via the Skills CLI (
npx skills add userplanehq/userplane-agent). See Agent Skills.Related articles
- Claude Code Plugin — what the plugin includes.
- Codex Plugin — install Userplane in Codex.
- Cursor Plugin — install Userplane in Cursor.
- Commands — reference for all four slash commands.
- MCP Servers — the two bundled MCP servers.
- MCP Authentication — OAuth 2.1 flow details.