Skip to main content

Client Setup

Connect your MCP client to the Lovelace public gateway

Pick your tool below — every config points to the same endpoint.

  • Endpoint: https://mcp.uselovelace.com/mcp
  • Transport: Streamable HTTP
  • Auth: MCP 401 challenge + Protected Resource Metadata discovery (most clients handle this automatically)
bash
bash
claude mcp add lovelace --transport streamable-http \
  --url https://mcp.uselovelace.com/mcp

Claude Code handles OAuth automatically on first use. Verify with claude mcp list.

Local Server

For local Lovelace workflows, run the local MCP server instead of the public gateway:

bash
bash
claude mcp add lovelace-local --transport stdio \
  -- lovelace mcp serve

See Local Server for details.

Troubleshooting

Connection errors

  • Confirm the endpoint is https://mcp.uselovelace.com/mcp
  • Confirm your client supports Streamable HTTP MCP servers
  • Restart the client after changing configuration

Authentication errors

  • Confirm the client supports MCP authorization discovery for remote HTTP servers
  • Confirm the client is using the MCP Gateway endpoint as the protected resource/audience
  • Confirm the granted token has the required scopes

Tools missing

  • Verify the connection with "List my Lovelace workspaces"
  • Recheck JSON syntax in your client configuration