Perses Onboard

First-time Perses setup and Claude Code integration pipeline.

Overview

This is a 4-phase onboarding pipeline for new Perses users, guiding them from zero to a working Perses setup with Claude Code MCP integration. Scope: server discovery/deployment, MCP connection, initial project setup, and end-to-end validation. Out of scope: dashboard creation (use perses-dashboard-create), complex auth (use perses-deploy), and plugin development (use perses-plugin-create).

Instructions

Phase 1: DISCOVER

Goal: Find or deploy a Perses server.

Step 1: Check for existing Perses (because we should reuse running instances before deploying)

# Check if percli is installed
which percli 2>/dev/null