Install IMG.LY CoDesign in any MCP client

CoDesign is a local stdio server, so any client that can start one can run it. In Claude Code, Codex, or another coding agent, the agent install guide does it from one prompt.

The command your client needs to run
npx -y @imgly/codesign-mcp@latest stdio

Four steps

Step 01

Check your client runs local servers

CoDesign runs on your own machine and talks over stdio. A client that only connects to remote MCP servers over HTTP cannot start it, and no amount of config will change that.

Step 02

Get Node 22 or newer

Run this in a terminal.

Check the installed Node version
node --version

If it prints nothing, or a version below v22, install Node with the line that matches your machine, then open a new terminal so the updated PATH takes effect. With no package manager to hand, the installer at nodejs.org does the same job.

macOS, with Homebrew
brew install node
Windows, with winget
winget install OpenJS.NodeJS.LTS
Linux, or anywhere nvm is already set up
nvm install --lts && nvm use --lts
Step 03

Register the server

If your client has a command for adding an MCP server, give it the command npx and the arguments below. If it reads a JSON config file instead, merge this block in, keeping any servers already under mcpServers. Keep @latest so npx re-resolves the package instead of reusing a stale cached copy, and keep stdio, which selects the transport.

For a client that reads a JSON config file
{
  "mcpServers": {
    "codesign": {
      "command": "npx",
      "args": ["-y", "@imgly/codesign-mcp@latest", "stdio"]
    }
  }
}
The same thing as a bare command, to test it by hand
npx -y @imgly/codesign-mcp@latest stdio
Step 04

Restart the client, then start the onboarding

A newly registered stdio server is not live in the session that registered it, so restart your client first. Then send the message below. It runs a short guided flow that explains what CoDesign does and produces one finished design. No account is needed. Signing in to a free IMG.LY account is optional and only adds AI image generation.

Send this once your client has restarted
start the CoDesign onboarding
Free Local MCP Server

Client not cooperating?

Ask in the Discord and someone will take a look. If your client is a coding agent that can run commands, hand it the install guide for agents and it can do the rest itself.