Skip to main content

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 — claude_desktop_config.json

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

Claude Code — .mcp.json (project root)

{
  "mcpServers": {
    "waxell": {
      "type": "url",
      "url": "https://mcp-gateway.waxell.dev/mcp/"
    }
  }
}
Config file location
~/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