Getting Started

Install and verify the Userplane plugin in Claude Code

The plugin installs all 18 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

Check	Expected result
/plugin	userplane listed and enabled
/mcp	userplane-workspace and userplane-docs listed
/userplane:integrate	Detects 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? 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.