MarketExploreTry on
Pricing
Sign inStart
Field GuideUsing Gradiently
Using Gradiently

Gradiently MCP: connect Claude, ChatGPT or any MCP client

Gradiently speaks MCP, so an AI assistant can search Marks, read your brand and make designs that open in your Studio. Here is the setup in plain language, and how to keep it safe.

GradientlyVerified Gradiently account·Updated October 5, 2026·6 min read
Cover: Hanoi Refuge · GR·EA10·2A

The short version

  • Gradiently runs a hosted MCP server at https://gradiently.design/api/mcp that any MCP client able to send an Authorization header can connect to.
  • You connect with an API key created by a workspace owner or admin in Settings, under API and agents, sent as a Bearer token.
  • Each key belongs to one workspace and carries only the permissions ticked when it was made, such as reading designs or searching Marks.
  • Once connected, an assistant can search Marks, read your brand profile, make and edit designs and resize them, and every design opens in the Studio.
  • A key is shown once, can be revoked at any time, and never moves a Mark's ownership to anyone else.
On this page
What you need before you startStep 1: create a scoped API keyStep 2: add the endpoint to your clientWhat your assistant can do once connectedKeeping the connection safe

To use the Gradiently MCP server, create an API key in Settings › API and agents, then add the hosted endpoint https://gradiently.design/api/mcp to your MCP client with the header Authorization: Bearer <your key>. That's the whole connection. From then on, an assistant such as Claude can search Marks, read your brand, make designs and change them, and each design it makes opens in your Studio like any other.

MCP, the Model Context Protocol, is an open standard that lets AI assistants use real tools. If the idea is new, what MCP is explains it in plain words, and the protocol's own site at modelcontextprotocol.io has the specification. The full technical reference for Gradiently's server lives in the developer docs.

What you need before you start

  • A Gradiently account and a workspace you are an owner or admin of. Only owners and admins can create or revoke keys.
  • An MCP client that can connect to a remote server over HTTP and send a custom Authorization header. Claude Code does; many desktop and editor clients do too.
  • A safe place for the key, such as a password manager or your client's secret storage. It is shown only once.

Step 1: create a scoped API key

  1. 1

    Open Settings › API and agents

    Pick the workspace the assistant should work in with the picker at the top. A key only ever acts in the workspace that issued it.

  2. 2

    Name it after where it's used

    "Claude Desktop" or "Marketing agent". The name is how you'll know which one to revoke later.

  3. 3

    Tick only what it needs

    The permissions are listed below. Four are ticked by default; Claim Marks is not.

  4. 4

    Create, then copy it now

    The key appears once, in full. Copy it into your password manager before closing the dialog. Afterwards Settings shows only its first characters, when it was last used and how many permissions it has.

Read designs

What it lets the assistant do

List and open designs in the workspace
Create and edit designs

What it lets the assistant do

Make new designs and change them
Search Marks

What it lets the assistant do

Look up Marks in the Market
Claim Marks

What it lets the assistant do

Claim a Mark for this workspace (off by default)
Generate brands

What it lets the assistant do

Make brand candidates from a description
PermissionWhat it lets the assistant do
Read designsList and open designs in the workspace
Create and edit designsMake new designs and change them
Search MarksLook up Marks in the Market
Claim MarksClaim a Mark for this workspace (off by default)
Generate brandsMake brand candidates from a description
The permissions a key can carry, as Settings names them. Grant the smallest set that does the job.

Step 2: add the endpoint to your client

The same page shows a ready-made snippet under Connect an MCP client, with a copy button. Clients that read a JSON configuration take it as it is; put your key in place of YOUR_KEY.

json
{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
The configuration from Settings › API and agents. Keep real keys out of files you share or commit.

In Claude Code, add the server from your terminal. Keep the key in an environment variable rather than typing it into your shell history.

bash
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"
Adding Gradiently to Claude Code over HTTP.

Other assistants, including ChatGPT, can connect wherever their app, plan and workspace settings allow a custom remote MCP server with an authorization header. Support differs between clients and changes over time, so check your client's own help pages; making on-brand designs from ChatGPT covers what to look for. Once connected, ask the assistant to list its Gradiently tools to confirm it worked.

What your assistant can do once connected

The server exposes the same actions you have in the product, through the same permissions. Grouped by job, they look like this:

Find

What the assistant can do

Search Marks by name, code or tone; read a Mark's recipe; list your Marks; find templates to start from
Design

What the assistant can do

Draw, edit and check designs directly; ask Gradiently's own Designer to make or change a design from a plain request; make a set of designs from one brief; start from a template
Resize

What the assistant can do

Save copies of a design in other sizes, beside the original, which stays unchanged
Brand

What the assistant can do

Read and update a brand's profile; generate brand candidates and set one up with a Mark and starter designs
Share and export

What the assistant can do

Turn on a view-only link for a design, or render it as a PNG or PDF when the Mark is claimed
JobWhat the assistant can do
FindSearch Marks by name, code or tone; read a Mark's recipe; list your Marks; find templates to start from
DesignDraw, edit and check designs directly; ask Gradiently's own Designer to make or change a design from a plain request; make a set of designs from one brief; start from a template
ResizeSave copies of a design in other sizes, beside the original, which stays unchanged
BrandRead and update a brand's profile; generate brand candidates and set one up with a Mark and starter designs
Share and exportTurn on a view-only link for a design, or render it as a PNG or PDF when the Mark is claimed
Every design the assistant makes is saved in your workspace and comes back with a link that opens it in the Studio.

Plain requests work best. The assistant can lay out and edit designs itself with Gradiently's tools, which spends no Gradiently AI credits. If you ask for Gradiently's own Designer instead, it reads your brand profile and the brand's Mark before it composes anything, and as in the Studio, its work is measured in AI credits.

21 June
Rooftop solstice party
Sunset to sunrise, bring a blanket
Gradiently · @gradiently

What "a poster for our rooftop solstice party, 21 June, sunset to sunrise" can come back as: a saved design on your brand's Mark, ready to open and adjust.

  • "Make six posts for our autumn launch in our brand, portrait for Instagram."
  • "Take yesterday's announcement and make a story and an X header from it."
  • "Find three dark Marks with a silk material and tell me their codes."
  • "Update our brand profile: we sound calm and precise, never salesy."

For a fuller walkthrough with Claude specifically, see designing with Claude through Gradiently. If you want the assistant to stay on-brand, brand guidelines your AI assistant can follow shows how to write the brand profile it reads.

Keeping the connection safe

Avoid

  • One key with every permission, shared by every tool
  • Pasting a key into a chat, a document or a repository
  • Leaving keys for tools you've stopped using
  • Ticking Claim Marks for an agent that only designs

Do

  • One key per client, named after where it runs
  • Storing it in a password manager or secret store
  • Revoking unused keys in Settings; they stop at once
  • Granting the smallest set of permissions that works

A few guarantees hold whatever the client does. A key only works in the workspace that issued it. It acts through the same rules as the person who created it, so it can't do anything their role can't. A key never transfers a Mark's ownership to the workspace or anyone else. Private designs stay private: a view-only link exists only when you ask for one. And if the person who created a key is removed from the workspace or loses their admin role, their keys stop working too.

Working as a team

Keys belong to a workspace, so an agent's designs land where your teammates can see and comment on them. Working with a team in Gradiently covers roles and sharing.

Connect your AI assistant

Let Claude or any MCP client search Marks and make designs that open in the Studio.

Read the developer docs

Questions people ask

What is the Gradiently MCP endpoint?

The hosted endpoint is https://gradiently.design/api/mcp. Every request needs the header Authorization: Bearer followed by an API key from Settings › API and agents.

Who can create a Gradiently API key?

Owners and admins of a workspace. Each key belongs to that one workspace and carries only the permissions ticked when it was created.

Does it work with ChatGPT?

It works with any MCP client that can connect to a remote HTTP server and send an authorization header. Whether ChatGPT can depends on the app, plan and workspace settings you use, so check its current help pages.

What happens if my key leaks?

Revoke it in Settings › API and agents. Anything using it stops working straight away, and you can create a new key.

Can an assistant claim Marks for me?

Only if its key has the Claim Marks permission, which is off by default. Claiming a Mark is a one-time payment, so tick that permission only for an assistant you want claiming for you.

Share this guide

Written by GradientlyVerified Gradiently account

The team behind Gradiently, a design tool built around Marks: living gradients that make everything you design look like yours.

See our profile

On this page

What you need before you startStep 1: create a scoped API keyStep 2: add the endpoint to your clientWhat your assistant can do once connectedKeeping the connection safe

Share this guide

Next in Using Gradiently

How to manage multiple brands from one Gradiently account

Keep reading

All Using Gradiently guides
AI and design

What is MCP? Letting your AI assistant use real tools

6 min read

An AI assistant that can only talk is limited to advice. One that can use your tools can actually do the work. MCP is the standard that connects the two.

AI and design

Claude design: making on-brand visuals with Gradiently

5 min read

Claude is good at understanding what you mean. Connected to Gradiently, it can also make it: real, editable designs in your brand, waiting in the Studio for your final touch.

AI and design

ChatGPT design: making on-brand designs from ChatGPT

5 min read

ChatGPT can draw you a picture. Connected to a design tool, it can do something more useful: make editable, on-brand designs you can open, fix and post.

Find the look that’s only yours.

Every Mark is a living background with one owner. Try an unclaimed Mark, and claim yours when it feels right.

Start designingSee the launch offer

Marks left to claim

50of 1,000

950 claimed so farFind yours

Check a certificate

Type a certificate number or a Mark’s code to see who owns it.

Works with ChatGPT and Claude

Ask your AI for a design. It makes it in your Mark, ready to edit.

ChatGPTClaude
How to connect

Product

  • Market
  • Explore
  • Pricing
  • Launch packs
  • Certificates

Learn

  • Field Guide
  • Help centre
  • What’s new

Developers

  • Overview
  • ChatGPT and Claude
  • API reference
  • API keys

Company

  • About
  • Contact us
  • Sign in

Legal

  • Terms
  • Privacy
  • Refunds
  • Mark protection
  • Cookies
  • All policies
Move through the letters. Each one wears a real Mark.Touch a letter to see its Mark.One name. Ten Marks inside it.
© 2026 Gradiently