Connecting Cursor

tl;dr Give Cursor access to Popmelt with one-click install. Authorize via OAuth, and start chatting.

Before you begin

Make sure you have..

1. Cursor IDE installed - Download from cursor.sh
2. A Popmelt account - Create yours at popmelt.com

Step 1: Add Popmelt to Cursor

Instant

Visit popmelt.com/app/connect, find Cursor in the list, and click to install. This will configure everything automatically.

Manual

Add Popmelt to your Cursor MCP config file:

• Global (available in all projects): ~/.cursor/mcp.json
• Project-specific: .cursor/mcp.json in your project root

{
  "mcpServers": {
    "popmelt": {
      "url": "https://mcp.popmelt.com"
    }
  }
}

Step 2: Authorize Popmelt

1. Restart Cursor to load the new configuration
2. When Cursor connects to Popmelt, you'll see an OAuth prompt
3. Sign in to Popmelt if needed
4. Click "Grant" to authorize Cursor's access
5. You're connected!

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

Step 3: Start Chatting

Ask Cursor's AI assistant: Connect to Popmelt and show me my available taste models

You should see a response with your account details and available taste models.

Using Popmelt in Cursor

• 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://linear.app and create a model called "Linearithm"
• Build complete pages:

- Hero section with headline and CTA
- 3 feature cards
- Pricing table
- Footer

Tips & Tricks

• Use Composer mode for multi-file edits - Popmelt taste models help ensure consistent styling across all generated files
• Reference existing code: Update the Button component to match my Popmelt taste model's styling
• Ask Cursor to explain your taste model: What colors are available in my taste model?
• Export in any format: Export this as a Next.js component with TypeScript and Tailwind

Troubleshooting

Cursor isn't using Popmelt

Solutions:

• Explicitly mention Popmelt: "Use Popmelt to..."
• Check that the connector shows as connected in settings
• Start a new conversation

Cursor doesn't recognize the Popmelt integration

Solutions:

• Verify your mcp.json syntax is correct
• Restart Cursor completely
• Check that you're using a recent version of Cursor with MCP support

OAuth prompt doesn't appear

Solutions:

• Clear your Cursor MCP cache
• Try removing and re-adding the Popmelt configuration
• Ensure you're logged into Popmelt in a browser

Common Questions

Does Cursor support OAuth?

Yes. Cursor supports OAuth for MCP servers, which is the recommended authentication method for Popmelt.

Can I use multiple taste models in one project?

Yes. Switch between taste models by asking Cursor to use a different one. Each conversation can use a different taste model.

How do I update my taste model?

For private taste models, use the create tool with patches. Public taste models are updated by Popmelt automatically.

What next?

• Build Landing Pages - See how to design web pages with Popmelt
• Create taste models - See how to make your own custom taste models
• Sampling websites - See how to capture existing website styles