# Configure DesignGen for this user

You are the setup agent for Claude. Complete every machine-owned step below. The user should only need to complete the browser-owned DesignGen sign-in and authorization screen.

## Completion criteria

- A Streamable HTTP MCP server named `designgen` points to `https://mcp.trydesigngen.com/mcp`.
- A self-contained DesignGen skill is installed at `~/.claude/skills/designgen/SKILL.md`.
- The DesignGen OAuth login has been opened for the user.
- After authorization, the connection is verified without starting paid generation.

## Safety boundaries

- Do not ask the user to paste an access token, bearer token, API key, cookie, or custom header.
- Do not make an approval or autonomy-policy choice for the user.
- Do not run image generation, edits, publishing, orders, or any other paid/write smoke test during setup.
- Modify only the `designgen` MCP entry and the DesignGen skill directory. Preserve all unrelated agent configuration.

## Agent-owned setup steps

1. Determine which Claude surface you are running in. If you have shell access you are Claude Code and can complete the machine-owned steps. If you are claude.ai or the desktop app, you cannot add connectors yourself — skip to the user-owned step and give the user the exact click path.
2. Claude Code only: check whether the server already exists with `claude mcp list`.
3. Claude Code only: if it is missing, run `claude mcp add --transport http --scope user designgen https://mcp.trydesigngen.com/mcp`. Use `--scope user` so DesignGen is available in every project.
4. Claude Code only: if a `designgen` entry exists with a different URL, record the current configuration in your progress note before replacing it. Do not touch any other MCP server.
5. Claude Code only: create `~/.claude/skills/designgen/` if needed and write the exact `SKILL.md` payload below. Update only the DesignGen skill and leave every other skill untouched.
6. Claude Code only: run `/mcp` (or `claude mcp list`) to trigger the OAuth flow. Pause and tell the user: **Sign in to DesignGen, review the requested scopes and approval policy, then approve access.**
7. claude.ai or desktop app: tell the user to open Settings, then Connectors, then Add custom connector, and paste `https://mcp.trydesigngen.com/mcp`. Then wait for them to confirm they finished authorizing.
8. If newly added tools are not visible in the current session, tell the user to start a new chat or restart Claude Code. Do not treat a stale tool list as a failed OAuth grant.
9. Once tools are visible, call `mcp_connection_status` and report the connected client, granted scopes, approval policy, and the active brand. Do not call a paid or write tool.

## DesignGen skill to install

Write the following content exactly to `~/.claude/skills/designgen/SKILL.md`:

```markdown
---
name: designgen
description: Use when the user wants to create, edit, inspect, mock up, or prepare merch artwork with DesignGen MCP, including logo-safe generation, print-ready preparation, background removal, vectorization, mockups, Creative Studio workflows, approvals, and production QA.
---

# DesignGen

Use the connected DesignGen MCP server as the action layer for apparel artwork, brand assets, mockups, listings, Creative Studio, and print-readiness.

## Start every task

1. Call `mcp_connection_status` before write or paid work.
2. Call `designgen_mcp_guide` for the relevant topic when permissions, approvals, print-readiness, or recovery behavior is unclear.
3. Reuse the user's existing DesignGen session, brand, files, and artifacts when possible.
4. Prefer the highest-level workflow tool that completes the user's goal.

## Workflow rules

- For carousels, start with `designgen_carousel` (operation `start`), present the returned approval, then follow its `nextCall` data through completion.
- For async image generation, save the returned `generationId` and call `designgen_generation` (operation `get`); do not submit a duplicate generation while the first is processing.
- For print preparation, use `designgen_print_prep` (operation `prepare`) and treat its result as a production-ready candidate until final production review is complete.
- Preserve logo geometry, readable words, brand colors, and separate reference-image roles unless the user explicitly requests a change.
- Use public quality tiers such as Standard, Ultra, and Ultra Max. Never expose internal provider names, raw model IDs, provider request IDs, or backend routing details.

## Approval and spend safety

- Respect the connected user's scopes and autonomy policy.
- Never approve an action on the user's behalf. Present the live approval and wait for the user's decision.
- Keep approval controls disabled until `designgen_approvals` (operation `get`) confirms a live pending approval.
- Do not start paid generation during connection verification.
- If a tool returns `paid_plan_required` or `insufficient_scope`, follow the structured recovery action instead of retrying.

## Completion report

Report the DesignGen tools used, session and artifact IDs or URLs, approval status, whether the result is preview-ready or still needs production review, and any limitation affecting print quality or logo fidelity.
```

## Success message

When complete, tell the user what was installed, whether OAuth succeeded, whether a restart or new session is needed, and the result of the read-only connection check. Never claim setup is complete before authorization succeeds.

Source guide: https://www.trydesigngen.com/agents/designgen/claude

---

# DesignGen Claude reference

Add DesignGen to claude.ai, the Claude desktop app, or Claude Code. All three connect to the same remote MCP server over OAuth.

## Which Claude are you using?
claude.ai and the Claude desktop app share one connector list, so adding DesignGen in either place enables it in both. Claude Code is configured separately, per machine.

- claude.ai (web) or Claude desktop app: add DesignGen as a custom connector in Settings.
- Claude Code (terminal, IDE extension, or desktop): add it with the claude mcp add command.
- Signing in is always done by you in a browser. No agent should ever ask you to paste a token.

## claude.ai and the Claude desktop app
Add DesignGen once as a custom connector, then authorize it in the browser window Claude opens.

- Open Settings, then Connectors, then Add custom connector.
- Paste the DesignGen connector URL below and confirm.
- Claude opens a DesignGen sign-in window. Review the requested scopes and approve.
- Start a new chat and ask Claude to call mcp_connection_status to confirm the connection.

DesignGen connector URL

```text
https://mcp.trydesigngen.com/mcp
```

## Claude Code
Add the server from any terminal. Use --scope user to make DesignGen available in every project rather than only the current one.

- Run /mcp inside Claude Code to start the OAuth flow if it does not open automatically.
- Approve the scopes in the browser window that opens.
- Ask Claude to call mcp_connection_status. It should report your account email and your active brand.

Add DesignGen for all of your projects

```bash
claude mcp add --transport http --scope user designgen https://mcp.trydesigngen.com/mcp
```

Then authorize, and confirm it is connected

```bash
claude mcp list
```

## Check that it is working
A healthy connection answers all three of these without you naming any tools.

- Ask "which DesignGen brand am I working in?" — Claude should report your active brand, not ask you for an ID.
- Ask "make me a summer tee design" — Claude should generate and show you the image inline.
- Ask "what have I generated recently?" — Claude should list prior generations.

## If Claude does not use DesignGen on its own
The server tells Claude what it is for at connection time, so this is usually a connection problem rather than a prompting problem.

- Confirm the connector is enabled for the current chat. In claude.ai, check the connector is toggled on.
- In Claude Code, run /mcp and confirm designgen is listed as connected rather than failed.
- If the connection expired, reconnect from Settings. Expired grants fail quietly.
- Ask Claude to call designgen_mcp_guide for workflow guidance before giving up on a complex task.