Connecting Claude Code

Give Claude Code CLI access to Popmelt taste models for AI-powered design guidance in your terminal.

tl;dr Give Claude Code access to Popmelt by running claude mcp add popmelt https://mcp.popmelt.com. Authorize via OAuth, and start chatting.

Before you begin

Make sure you have..

  1. Claude Code installed - Get it from Anthropic's documentation
  2. A Popmelt account - Create yours at popmelt.com
  3. Terminal access on your system

Step 1: Add Popmelt Integration

Use the Claude MCP command to add Popmelt:

claude mcp add popmelt https://mcp.popmelt.com

Step 2: Authorize Popmelt

  1. Start a new Claude Code session
  2. When Claude connects to Popmelt, you'll see an OAuth prompt in your browser
  3. Sign in to Popmelt if needed
  4. Click "Grant" to authorize Claude Code's access
  5. Return to your terminal - you're connected!

🔒 Popmelt never reads or stores your code or conversations. Claude will ask for permission before using Popmelt tools.

Step 3: Start Chatting

Check that Popmelt is available:

/mcp

You should see "popmelt" in the list of MCP providers. Then test the connection: Connect to Popmelt and show my available taste models

Using Popmelt in Claude Code

  • Set your taste model: Use the Melt taste model for this project
  • Generate components: Create a pricing section with 3 tiers using my taste model
  • Sample and create: Use Popmelt to sample https://resend.com and create a model called "Resplendent"
  • Build complete pages:
- Hero section with headline and CTA
- 3 feature cards
- Pricing table
- Footer

Tips & Tricks

  • Use single commands for quick tasks: claude "Create a button using my Melt taste model"
  • Add shell aliases for common operations: alias pm-list="claude 'List available taste models'"
  • Request specific tokens to reduce response size: use { type: "tasteModel", name: "Melt", path: "/principles" }
  • Combine with file operations: claude "Update src/components/Button.tsx to use my taste model's styling"

Troubleshooting

Claude isn't using Popmelt

Solutions:

  • Explicitly mention Popmelt: "Use Popmelt to..."
  • Check that Popmelt shows in /mcp output
  • Start a new session

claude mcp add command fails

Solutions:

  • Verify you have internet connectivity
  • Check Claude Code version: claude --version
  • Try removing and re-adding: claude mcp remove popmelt && claude mcp add popmelt https://mcp.popmelt.com

OAuth authorization doesn't complete

Solutions:

  • Ensure you're logged into Popmelt in your default browser
  • Check for browser popup blockers
  • Try the authorization URL manually if it doesn't open automatically

Common Questions

Can I use Popmelt in non-interactive mode?

Yes. Claude Code works in both interactive and single-command modes:

# Single command
claude "Create a button using my Melt taste model"

# Interactive session
claude
> Connect to Popmelt
> Use the Melt taste model
> Create a hero section

How do I switch taste models mid-session?

Just ask: Use the "Zinc" taste model instead

Is Claude Code different from Claude Chat?

Yes and no! Claude Code is available as both a CLI tool and inside the Claude desktop app. These instructions are for the CLI. If you're using the desktop app, see the Claude Chat guide →

What next?

Better prototypes with less prompting

Start creating