> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userplane.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Steps>
  <Step title="Register the marketplace">
    Run this once to add the Userplane plugin source:

    ```
    /plugin marketplace add userplanehq/userplane-agent
    ```
  </Step>

  <Step title="Install the plugin">
    ```
    /plugin install userplane@userplane-marketplace
    ```
  </Step>

  <Step title="Verify the plugin">
    ```
    /plugin
    ```

    Confirm `userplane` is listed and enabled.
  </Step>

  <Step title="Verify MCP servers">
    ```
    /mcp
    ```

    You should see `userplane-workspace` and `userplane-docs` in the list.
  </Step>
</Steps>

## First use

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Try natural language">
    Skills activate without slash commands too:

    ```text theme={null}
    What arguments does initialize() accept? I want to pass a custom session ID.
    ```

    The `userplane-web-sdk` skill loads automatically.
  </Step>
</Steps>

## 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`.

<Note>
  Not using Claude Code? Use the [Codex Plugin](/integrations/codex), the [Cursor
  Plugin](/integrations/cursor), or install skills via the Skills CLI (`npx skills add
      userplanehq/userplane-agent`). See [Agent Skills](/developer/agent-skills).
</Note>

## Related articles

* [Claude Code Plugin](/integrations/claude-code) — what the plugin includes.
* [Codex Plugin](/integrations/codex) — install Userplane in Codex.
* [Cursor Plugin](/integrations/cursor) — install Userplane in Cursor.
* [Commands](/integrations/claude-code-commands) — reference for all four slash commands.
* [MCP Servers](/integrations/claude-code-mcp) — the two bundled MCP servers.
* [MCP Authentication](/integrations/mcp-authentication) — OAuth 2.1 flow details.