Prerequisites

  • A WM Studio account (OAuth signs you in via Supabase).
  • An MCP client — Claude.ai, Claude Code, Cursor, or the MCP Inspector.
  • The hosted MCP URL: https://mcp-director.fly.dev/mcp/.

Connect Claude

  1. Open Claude.ai → Settings → Connectors → Add custom connector.
  2. Paste https://mcp-director.fly.dev/mcp/ into the URL field.
  3. Click Connect and complete the OAuth sign-in (Supabase IdP).
  4. You stay signed in for 90 days; tokens refresh transparently every hour.

Connect Cursor / Claude Code

Drop this into your MCP config — same hosted URL, OAuth handles auth on first call.

mcp.json

{
  "mcpServers": {
    "wmstudio": {
      "url": "https://mcp-director.fly.dev/mcp/",
      "auth": "oauth"
    }
  }
}

Local development (contributors only)

End users do not need this section. It only applies if you are contributing to the MCP server itself. To run the server locally with Redis for OAuth state and job tracking:

uvicornhealthdev JWT

python3 -m venv .venv && source .venv/bin/activate
pip install -e '.[dev]'
cp .env.example .env
docker compose up redis -d
PYTHONPATH=. uvicorn src.server:root_app --reload --host 0.0.0.0 --port 8080

Your first tool call

The fastest path: a single studio_generate_image call. It returns a hosted image URL on the WM Studio CDN that you can pipe into any other tool.

{
  "name": "studio_generate_image",
  "arguments": {
    "prompt": "minimalist product photo of a black ceramic mug, soft daylight",
    "model": "fal-ai/flux-2-pro",
    "aspect_ratio": "4:3"
  }
}

Want to refine? Feed the returned URL into studio_upscale_image for 2×/4× detail, or into studio_camera_angles for a 9-shot exploration.

Next steps