Connect Claude or ChatGPT to your workspace

You can connect an AI assistant such as Claude, Claude Code or ChatGPT to your Composerie workspace. While you chat, the assistant can then look up your products and orders, build designs, finish product drafts and follow up on orders that need attention. This guide shows how to connect each one, what the assistant can and cannot do, and how to disconnect it.

The connection runs through Composerie’s MCP server. MCP (Model Context Protocol) is an open standard that AI assistants use to work with other apps. You add one web address to your assistant, sign in to Composerie and choose a workspace. There is no API key, client ID or secret to copy: Composerie recognizes Claude and ChatGPT by itself.

This is not the same as connecting an AI provider, which adds image effects to your products. Here, an assistant works in your workspace on your behalf.

Before you start

The server address is:

https://app.composerie.com/api/mcp

Composerie also shows it as MCP server URL in the AI app connections list, with a Copy URL button. The last section of this guide shows where to find that list.

AI app connections are switched on per workspace. If a workspace does not show up when you connect, or the screen says you have no available workspace to connect, contact support.

Connect Claude

This works in Claude on the web and in the Claude desktop app.

Connect Claude Code

Run this in your terminal:

claude mcp add --transport http composerie https://app.composerie.com/api/mcp

This adds Composerie to the project folder you are in. To use it in every project, add --scope user after add.

Then start Claude Code, type /mcp, choose composerie and choose to authenticate. Your browser opens Composerie. Approve the connection as described in the section below, and the browser hands you back to Claude Code.

Connect ChatGPT

ChatGPT lets you add your own app only on plans that allow custom apps, and it may ask you to turn on developer mode in its settings first. The exact menu names in ChatGPT can change, so look for the place where you manage apps or connectors.

Approve the connection in Composerie

Every assistant ends up on the same Composerie screen, Connect an AI app.

What your role allows

The assistant works as you, so your role in the workspace still applies. Composerie gives the app only the permissions your role can grant. See team roles for what each role can do.

• Owners and Admins can let an assistant do everything described in this guide.
• Editors can let it read, and work on products, designs and images, but not act on orders.
• Fulfillment members can let it read, add order notes and retry failed renders, but not change products or designs.
• Viewers can let it read, but not change anything.

Composerie checks your role again on every action, so a lower role limits the assistant right away. A higher role does not widen a connection you already made: disconnect and connect again to give the app the new permissions. If you leave a workspace, the connection to it stops working.

What the assistant can do

Which of these your assistant offers depends on the permissions you approved.

Read your workspace

• Find products, designs, templates and files in your media library.
• Read order summaries with their payment and fulfillment status, and see why an order needs attention. Customer contact details and addresses are not shared.
• See the Needs attention items from your Home page, each with a link to the fix.
• Read your analytics, notifications, mockups, customizer settings and the health of your integrations.

Build designs

• Create the design for a product, starting empty or from a template, or duplicate a design.
• Start from a design recipe for the kind of product, such as a poster, card, mug or shirt: where the main parts go, a type scale, font pairings and color palettes with enough contrast.
• Edit a design with text, shapes, lines, icons, photos and empty photo slots.
• Add these smart elements: Star Map, Moon Phase, Calendar, Travel Map, QR Code, Barcode and Avatar, plus a clipart pool.
• Style layers with fonts, colors, gradients, shadows, text effects, photo crops and filters.
• Make parts of a design editable for your customers with personalization fields.
• Preview a change before saving it, also with short, long and empty customer text, to check that everything still fits.
• Check the layout for text that is too small, items that are almost but not quite aligned, uneven spacing, an unbalanced layout, and text hidden under or placed on a photo. Text is measured with the fonts used for print.
• Import an image from a web address into your media library. This only works for images on sites Composerie accepts. Other addresses are refused.

Finish products

• Create a product draft, and change its name, description and SEO fields.
• Read a catalog product’s print areas and variants.
• Set retail prices, compare-at prices and which variants are available.
• Rename options, choose how they are shown in your store, and set the storefront mode.
• Add, change and remove add-ons, such as gift wrapping.
• Start mockup renders, choose the main photo and the photo each variant shows, and set the order of the mockup gallery.
• Check what still blocks publishing, with the same checks Composerie runs when you publish. This does not publish anything.
• Change how your customizer looks and its photo upload rules. Only Owners and Admins can do this, and your shoppers see the change as soon as it is saved.

Follow up on orders

• Add an internal note to an order. Your team sees it on the order page. The customer never does.
• Retry the failed print renders of an order, the same retry you can start on the order page. The order then continues through its normal production flow. See fix a render or provider fulfillment error.

Sending an order to the print provider, shipping and refunds stay in the dashboard. A person does them there, not the assistant.

Edit images (paid)

The assistant can remove the background from an image in your media library, or upscale it. Each edit runs on your own AI provider, which bills it to your account, and it counts toward that provider’s monthly limit. See what AI generation costs. The assistant must ask you before each edit. The result is saved as a new image, and the original stays as it was.

Product and design changes are saved as drafts. The assistant never publishes by itself: putting a product on your store always needs your own confirmation in Composerie. Read what publishing does before you publish a draft an assistant made.

Limits

• Each workspace allows up to 60 assistant actions a minute, shared by every connected assistant. Each lookup or edit counts as one action. When the limit is reached, the assistant has to wait a moment before it tries again.
• An assistant cannot add a City Map, a Route Map or an Elevation Profile. Add those in the Design Studio.
• Product costs, tax, inventory, add-on visibility rules and custom CSS for the customizer stay in the dashboard.
• Each connection works in one workspace. To work in another one, disconnect and connect again, then choose the other workspace.

Manage or disconnect an assistant

The AI app connections list shows each assistant you connected, with its workspace and its permissions.

• Owners and Admins find it under Settings, then Security. When you open Composerie inside Shopify, the Security page does not show this list.
• Anyone signed in to Composerie can open the same list at app.composerie.com/mcp/connections. The consent screen links to it as Manage my AI connections.

To disconnect, choose Disconnect next to the connection. The assistant loses access right away. Your assistant may still list Composerie in its own settings, so remove it there too if you no longer want it.

The list shows only the connections you made. Each teammate manages their own.

Next

If something does not work as described here, contact support. To decide who on your team may let an assistant edit, see manage your team and roles.