Skip to main content

Quick Start

Connect to Lovelace via MCP in 5 minutes

This guide walks you through connecting to the Lovelace MCP server and making your first tool call.

Prerequisites

Step 1: Get Your API Key

  1. Go to the API Keys page in your developer dashboard
  2. Click Create API Key
  3. Copy your key — you'll need it in the next step

Step 2: Configure Your Client

Add the Lovelace MCP server to your client's configuration.

Claude Desktop

Open your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the Lovelace server:

json
{
  "mcpServers": {
    "lovelace": {
      "type": "streamable-http",
      "url": "https://mcp.uselovelace.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

bash
claude mcp add lovelace --transport streamable-http \
  --url https://mcp.uselovelace.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Other Clients

See Client Setup for Cursor, Windsurf, and generic client configuration.

Step 3: Verify Connection

After restarting your client, verify the connection by asking it to list your workspaces:

List my Lovelace workspaces

Your client should call the lovelace_list_workspaces tool and display your workspaces.

Step 4: Try More Tools

Spawn an agent:

Spawn a Lovelace agent to analyze the performance of my API endpoints

Search knowledge:

Search my Lovelace knowledge base for authentication documentation

Check agent status:

What's the status of my running Lovelace agents?

What's Next