Configure your IDE

Add the uxmagic-mcp server to your IDE's MCP settings and replace YOUR_API_KEY with your uxm_-prefixed key. The bridge installs automatically via npx — no global install required.

Cursor

Settings → Features → MCP Servers → Add new global MCP server, then paste:

{
  "mcpServers": {
    "uxmagic-mcp": {
      "command": "npx",
      "args": ["-y", "uxmagic-mcp"],
      "env": { "UXMAGIC_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Windsurf

Add to ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "uxmagic-mcp": {
      "command": "npx",
      "args": ["-y", "uxmagic-mcp"],
      "env": { "UXMAGIC_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Antigravity

Edit the MCP config (Agent panel → "..." → Manage MCP Servers → View raw config). File location:

• macOS/Linux: ~/.gemini/antigravity/mcp_config.json
• Windows: C:\Users\<USERNAME>\.gemini\antigravity\mcp_config.json

{
  "mcpServers": {
    "uxmagic-mcp": {
      "command": "npx",
      "args": ["-y", "uxmagic-mcp"],
      "env": { "UXMAGIC_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Restart Antigravity after changing the config.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "uxmagic-mcp": {
      "command": "npx",
      "args": ["-y", "uxmagic-mcp"],
      "env": { "UXMAGIC_API_KEY": "YOUR_API_KEY_HERE" }
    }
  }
}

VS Code

VS Code prompts for your key instead of storing it inline. Open Preferences: Open User Settings (JSON) and add:

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "Uxmagic API Key",
        "password": true
      }
    ],
    "servers": {
      "uxmagic": {
        "command": "npx",
        "args": ["-y", "uxmagic-mcp"],
        "env": { "UXMAGIC_API_KEY": "${input:apiKey}" }
      }
    }
  }
}

You can also commit this (minus the wrapping mcp key) to .vscode/mcp.json to share with your team.

Connect directly (no bridge)

If your client supports remote MCP servers, skip the package entirely:

• URL: https://api.uxmagic.ai/api/mcp (Streamable HTTP)
• Header: X-API-Key: uxm_YOUR_API_KEY

Windows note

If npx gives you trouble on Windows, try:

cmd /c "set UXMAGIC_API_KEY=uxm_YOUR_API_KEY && npx -y uxmagic-mcp"