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

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

```bash
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.

```json
{
  "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

- Browse the [tool reference](/content/en/docs/tools/index.html).
- Chain calls in [workflows](/content/en/docs/workflows/index.html).
- Map common failures in [errors](/content/en/docs/errors/index.html).