Agent-assisted setup

Connect DesignGen to Codex

Hand the setup to your agent, complete the secure DesignGen sign-in, and start using print-ready and Creative Studio workflows.

The copied brief contains the MCP command, a self-contained DesignGen skill, OAuth handoff instructions, and a read-only verification checklist. It never includes a token or authorizes paid work.

Secure handoff

Let your agent configure everything it safely can.

Paste the copied Markdown into Codex. It will inspect existing configuration, add DesignGen MCP, install the workflow skill where supported, and open OAuth. Your account and approval choices stay with you.

  1. 01

    Copy the setup

    One button copies the complete agent-readable brief.

  2. 02

    Agent configures

    Codex adds MCP and installs the DesignGen skill where supported.

  3. 03

    You authorize

    Sign in, review scopes and policy, then approve access.

Your agent handles

  • Checks existing MCP configuration before changing it.
  • Adds the production Streamable HTTP endpoint.
  • Installs the self-contained DesignGen workflow skill.
  • Verifies OAuth and connection status without spending credits.

Only you handle

  • Signing in to your DesignGen account.
  • Reviewing the scopes requested by Codex.
  • Choosing the approval policy you are comfortable with.
  • Approving or denying the OAuth connection.

Fastest setup: hand this page to your agent

Use Copy setup for your agent at the top of this page. The copied Markdown tells Codex how to install the self-contained DesignGen skill, add the production MCP server, verify its configuration, and open the OAuth sign-in.

  • The agent handles the MCP configuration and installs the DesignGen workflow skill.
  • You handle only the browser-owned steps: sign in, review scopes and approval policy, and approve access.
  • The setup brief forbids pasted tokens, headers, paid test calls, and approval decisions made on your behalf.

Before you start

DesignGen uses browser-based OAuth. You do not need to create or paste a bearer token, API key, or custom header into Codex.

  • Use the production endpoint: https://mcp.trydesigngen.com/mcp
  • Sign in with the DesignGen account whose brands, files, credits, and Creative Studio sessions you want the agent to use.
  • A paid DesignGen plan is required for MCP access. Codex will open the DesignGen authorization page during setup.

Add the MCP server in Codex

Create a Streamable HTTP server from Codex settings.

  • Open Codex settings and select MCP servers.
  • Click Add server, then choose Streamable HTTP.
  • Name the server DesignGen.
  • Enter https://mcp.trydesigngen.com/mcp as the server URL.
  • Leave bearer token and custom headers empty, then save the server.

Authenticate DesignGen

After saving the server, complete the OAuth flow in the browser window Codex opens.

  • Click Authenticate in Codex.
  • Sign in to DesignGen if the authorization page asks you to sign in.
  • Review the requested permissions and confirm they match the work you want the agent to perform.
  • Choose an approval policy, click Approve, and return to Codex.
  • Restart or refresh MCP servers if Codex asks you to do so after authorization.

Choose an approval policy

Approve Every Write is the recommended starting policy for most users. It lets the agent inspect context while keeping write and spend actions behind approval.

  • Approve Every Write: recommended for everyday use and first-time connections.
  • Budgeted Autonomy: use for a clearly bounded workflow when you are comfortable approving its tools, run limit, and credit budget once.
  • Fully Autonomous: advanced mode that permits allowed write actions without per-action approval. Enable it only when you understand the impact.

Verify the connection

Start with a read-only connection check before requesting generation or other write actions.

  • In Codex, ask: Use DesignGen MCP to check connection status.
  • The agent should call mcp_connection_status and report the connected client, approval policy, and granted scopes.
  • For carousel approvals, do not approve a card that still says it is waiting for workflow data. Regenerate the approval or refresh the MCP connection.

Troubleshoot setup

Most connection failures identify the recovery action in a structured error.

  • paid_plan_required: open the billing link, upgrade, and retry authorization.
  • insufficient_scope: reconnect DesignGen and approve the scopes requested for the blocked tool.
  • approval_not_found or a disconnected approval card: regenerate the workflow approval. If tools are missing, refresh or restart the Codex MCP server first.
  • Processing generation: call designgen_generation (operation "get") with the existing generationId instead of rerunning designgen_generate (operation "image").