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

# Connect to Claude Desktop

> Set up Lever in Claude Desktop

# Connect to Claude Desktop

Add Lever to Claude Desktop to manage ad campaigns through conversation.

## Setup (OAuth — recommended)

1. Open Claude Desktop **Settings → Connectors**
2. Click **Add custom connector**
3. Enter this URL: `https://api.leverhq.app/mcp`
4. Claude Desktop will open a browser window — log in with your Lever account and click **Allow**
5. Done. Start a new conversation and try it out.

No API key, no JSON config file, no restart needed.

## Verify the Connection

Start a new conversation and ask:

> "What ad accounts do I have connected to Lever?"

Claude will call the `list_connections` tool and show your connected accounts.

## Alternative: API Key

If your version of Claude Desktop doesn't support custom connectors, you can use an API key instead.

Open your Claude Desktop config file:

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

Add Lever:

```json theme={null}
{
  "mcpServers": {
    "lever": {
      "url": "https://api.leverhq.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

Replace `YOUR_API_KEY` with the key from your [Lever dashboard](https://leverhq.app).

Restart Claude Desktop to pick up the changes.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Claude doesn't see the Lever tools">
    Make sure you added the connector in Settings → Connectors (not the config file). If using the config file method, verify the JSON is valid and restart Claude Desktop.
  </Accordion>

  <Accordion title="OAuth login doesn't appear">
    Check that you're signed up at [leverhq.app](https://leverhq.app) and have connected at least one ad platform. The OAuth window should open automatically in your default browser.
  </Accordion>

  <Accordion title="Authentication error">
    Try removing and re-adding the connector. If using an API key, verify it's correct or generate a new one in the [Lever dashboard](https://leverhq.app).
  </Accordion>
</AccordionGroup>