MCP Gateway Setup

Connect Cowork, Claude Desktop, Claude Code, or any MCP client to your Waxell workspace — one URL fans out to every installed catalog upstream and the full Waxell platform

Your MCP Server URL

Add this to your MCP client to get started

https://mcp-gateway.waxell.dev/mcp

Add the MCP Server URL

Add the Waxell MCP server URL to your client's configuration. No API key needed — authentication is handled via OAuth.

Claude Desktop, ChatGPT, Perplexity — no file to edit

Open Settings → Connectors.
Click Add custom connector.
Name it Waxell and paste the server URL above.
Click Connect, sign in, and choose the agent it acts as.

On Team/Enterprise plans Add custom connector is greyed out for members — an organization owner adds it once for everyone.

Claude Code — .mcp.json (project root)

{
  "mcpServers": {
    "waxell": {
      "type": "url",
      "url": "https://mcp-gateway.waxell.dev/mcp"
    }
  }
}

Config file location — Claude Code and other file-based clients

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

~/.config/Claude/claude_desktop_config.json

Restart Your Client

After saving the config file, restart Claude Desktop (or reload Claude Code). The MCP client will detect the new server and initiate the connection.

Sign In When Prompted

Your browser will open with the Waxell login page. Sign in with your email and password (and MFA code, if you have two-factor authentication enabled). Once authenticated, the connection is established automatically.

A secure API key is generated for your connection and will appear on the MCP Connections page.

Connection Issues

Login Issues

Two-Factor Authentication (MFA)

Token & Refresh Issues

Configuration Issues