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
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
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