Skip to main content

Connecting your assistant

Connecting is a one‑time OAuth approval. Your MCP client runs the whole exchange for you — you only log in and click Approve. You never copy a code or paste a callback URL.

Before you start: you need a Limelight account that is a member of a brand (the same account you use for the dashboard), and that brand must be on a plan that includes MCP — Premium, Enterprise, or Managed. On the Signal or self‑serve plan the connection is refused; upgrade to enable it.

The endpoint is the same everywhere:

https://mcp.limelighthq.com/mcp

Method A — Native connector (click‑only, recommended)​

Add Limelight as a custom connector in your Claude client.

  1. Open the Claude Desktop app (or Claude.ai) → Settings → Connectors → Add custom connector.
  2. Paste the URL: 
    https://mcp.limelighthq.com/mcp
  3. Save, then click Connect and approve the OAuth prompt: log in to Limelight → Approve.

That's it — the Limelight tools appear in a new chat.

note

Remote custom connectors are a paid‑plan feature (Claude Pro, Max, Team, or Enterprise). If you don't see the Connectors menu, use Method B below.

Method B — Command line (any plan)​

If your client can't add a remote connector directly, bridge to it from the command line. Both options below run the same OAuth flow — a browser opens once for you to log in and approve.

Claude Code​

claude mcp add --transport http limelight https://mcp.limelighthq.com/mcp

Then start a session and run /mcp → select limelight → Authenticate. A browser opens; log in and Approve. The Limelight tools are then available.

Claude Desktop via mcp-remote​

Add this to your Claude Desktop MCP config (Settings → Developer → Edit Config), then restart the app:

{
  "mcpServers": {
    "limelight": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.limelighthq.com/mcp"]
    }
  }
}

On first use a browser opens for the same login‑and‑approve step.

What you'll see​

  1. A browser opens to the Limelight sign‑in.
  2. You log in (if you aren't already) and land on a short consent screen naming the brand you're connecting.
  3. You click Approve, and the client is connected. No codes, no copy‑paste.

Approval is per connection and can be undone at any time by removing the connector in your Claude client.

Troubleshooting​

  • "This needs a brand account." Your Limelight user isn't a member of any brand, so there is nothing to connect and nothing is shared. Sign in with a brand account, or ask a teammate to invite you to theirs, and start again.
  • No "Connectors" menu. Remote connectors need a paid Claude plan — use Method B.
  • A tool returns "Unauthorized" or "Forbidden." Your Limelight role may not include that data. Ask a brand admin to check your role, or use a tool your role can reach.