add the selfielab remote connector — your agent opens a browser window, you sign in to selfielab, and tools run on your account. no pasting sl_ api keys for the one-click path.
one-click install
paste the remote mcp url into claude custom connectors (or any store that supports remote mcp + oauth). the agent opens a window; you sign in and allow access.
Remote MCP URL (paste into Claude custom connectors / compatible stores):
https://selfielabstudio.com/api/mcp
OAuth discovery (automatic for MCP clients):
https://selfielabstudio.com/.well-known/oauth-authorization-server
After you add the connector, the agent opens a sign-in / allow-access window.
Approve once — the client receives tokens and can call canvas-parity tools.mcp url: https://selfielabstudio.com/api/mcp
oauth metadata: https://selfielabstudio.com/.well-known/oauth-authorization-server
tools
| tool | what it does |
|---|---|
| create_image | generate image from prompt + optional face ref |
| create_image_batch | 2–4 images in one request |
| edit_image | restyle existing image with instruction |
| remove_background | transparent PNG cutout (2 credits) |
| overlay_text | caption image or video |
| create_video | animate image with motion prompt |
| edit_video | generative video restyle |
| stitch_videos | merge 2–5 clips in order |
| trim_video | cut start/end seconds |
| mute_video | strip audio track |
| write_shot_prompt | vision → reusable shot prompt |
plus credits, characters, jobs, and image library tools after oauth.
claude
Claude (Connectors / custom MCP): 1. Add a custom connector with URL: https://selfielabstudio.com/api/mcp 2. Claude discovers OAuth at https://selfielabstudio.com/.well-known/oauth-authorization-server 3. A browser window opens → sign in to SelfieLab → Allow access 4. Tools appear (create_image, create_video, stitch, …) as your user Optional fallback without OAuth: CLI + SELFIELAB_API_KEY (see CLI docs).
codex
Codex / OpenAI-compatible agents: - Preferred: remote MCP URL https://selfielabstudio.com/api/mcp with OAuth (same flow as Claude) - Or: npm install -g selfielab + export SELFIELAB_API_KEY=sl_… and run commands with --json selfielab generate "studio headshot" --json
grok / custom agents
Grok / custom connectors: - Connector URL: https://selfielabstudio.com/api/mcp - Auth: OAuth 2.1 (authorization code + PKCE) via browser window - Metadata: https://selfielabstudio.com/.well-known/oauth-authorization-server - REST fallback: Authorization: Bearer sl_… on https://selfielabstudio.com/api/
cli fallback (optional)
for shell pipelines you can still use the published cli with a personal api key — not required for the oauth connector path.
npm install -g selfielab
# one-off without a global install:
npx selfielab tools --jsonexport SELFIELAB_API_KEY=sl_your_api_key
# optional — defaults to https://selfielabstudio.com
export SELFIELAB_BASE_URL=https://selfielabstudio.comAuthorization: Bearer sl_your_api_key
# or
X-API-Key: sl_your_api_key
# OAuth access tokens from the connector flow also work as:
# Authorization: Bearer <access_token>credits & costs
tool calls spend your account credits the same as the web app. check balance after connecting with get_credits or the cli.