Skip to main content
The plugin installs all 14 skills, 4 slash commands, 4 subagents, and both MCP servers in one step.

​
Install

1

Register the marketplace

Run this once to add the Userplane plugin source:
/plugin marketplace add userplanehq/userplane-agent
2

Install the plugin

/plugin install userplane@userplane-marketplace
3

Verify the plugin

/plugin
Confirm userplane is listed and enabled.
4

Verify MCP servers

/mcp
You should see 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 package.json and run:
/userplane:integrate
The agent detects your framework, loads the matching skill, and writes the integration.
3

Try natural language

Skills activate without slash commands too:
What arguments does initialize() accept? I want to pass a custom session ID.
The userplane-web-sdk skill loads automatically.

​
Verification checklist

CheckExpected result
/pluginuserplane listed and enabled
/mcpuserplane-workspace and userplane-docs listed
/userplane:integrateDetects framework or prompts for one
”List my Userplane workspaces”Returns workspace list (confirms MCP auth)

​
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? Install skills via the Skills CLI (npx skills add userplanehq/userplane-agent) for Cursor, Windsurf, and other agents. See Agent Skills.