Kortversionen
- Gradiently kör en värdbaserad MCP-server på https://gradiently.design/api/mcp som vilken MCP-klient som helst kan ansluta till, om den kan skicka en Authorization-header.
- Du ansluter med en API-nyckel som en ägare eller admin på arbetsytan skapar i Inställningar, under API och agenter, och som skickas som en Bearer-token.
- Varje nyckel tillhör en arbetsyta och har bara de behörigheter som kryssades i när den skapades, till exempel att läsa designer eller söka Marks.
- När en assistent är ansluten kan den söka Marks, läsa din varumärkesprofil, göra och redigera designer och ändra deras storlek, och varje design öppnas i Studio.
- En nyckel visas en gång, kan återkallas när som helst och flyttar aldrig en Marks ägarskap till någon annan.
På den här sidan
För att använda Gradiently MCP-servern skapar du en API-nyckel i Inställningar › API och agenter och lägger sedan till den värdbaserade slutpunkten https://gradiently.design/api/mcp i din MCP-klient, med headern Authorization: Bearer <din nyckel>. Det är hela anslutningen. Därefter kan en assistent som Claude söka Marks, läsa ditt varumärke, göra designer och ändra dem, och varje design den gör öppnas i din Studio som vilken annan design som helst.
MCP, Model Context Protocol, är en öppen standard som låter AI-assistenter använda riktiga verktyg. Om idén är ny förklarar vad MCP är den med enkla ord, och protokollets egen webbplats modelcontextprotocol.io har specifikationen. Den fullständiga tekniska referensen för Gradiently-servern finns i utvecklardokumentationen.
Det här behöver du innan du börjar
- Ett Gradiently-konto och en arbetsyta där du är ägare eller admin. Bara ägare och admins kan skapa eller återkalla nycklar.
- En MCP-klient som kan ansluta till en fjärrserver över HTTP och skicka en egen
Authorization-header. Claude Code kan det, och många skrivbords- och redigeringsklienter också. - Ett säkert ställe för nyckeln, till exempel en lösenordshanterare eller klientens hemlighetslagring. Den visas bara en gång.
Steg 1: skapa en begränsad API-nyckel
- 1
Öppna Inställningar › API och agenter
Välj den arbetsyta som assistenten ska arbeta i med väljaren högst upp. En nyckel agerar alltid bara i den arbetsyta som utfärdade den.
- 2
Namnge den efter var den används
”Claude Desktop” eller ”Marknadsföringsagent”. Namnet är hur du vet vilken du ska återkalla senare.
- 3
Kryssa bara i det den behöver
Behörigheterna listas nedan. Fyra är ikryssade som standard, Säkra Marks är det inte.
- 4
Skapa och kopiera den direkt
Nyckeln visas en gång, i sin helhet. Kopiera den till din lösenordshanterare innan du stänger dialogrutan. Efteråt visar Inställningar bara dess första tecken, när den senast användes och hur många behörigheter den har.
| Behörighet | Vad den låter assistenten göra |
|---|---|
| Läsa designer | Lista och öppna designer på arbetsytan |
| Skapa och redigera designer | Göra nya designer och ändra dem |
| Söka Marks | Slå upp Marks på Marknaden |
| Säkra Marks | Säkra en Mark för den här arbetsytan (av som standard) |
| Generera varumärken | Skapa varumärkesförslag utifrån en beskrivning |
Steg 2: lägg till slutpunkten i din klient
Samma sida visar ett färdigt utdrag under Anslut en MCP-klient, med en kopieringsknapp. Klienter som läser en JSON-konfiguration tar det som det är, med din nyckel i stället för YOUR_KEY.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}I Claude Code lägger du till servern från terminalen. Förvara nyckeln i en miljövariabel i stället för att skriva in den i skalets historik.
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"Andra assistenter, däribland ChatGPT, kan ansluta så snart deras app, abonnemang och arbetsyteinställningar tillåter en egen MCP-fjärrserver med en auktoriseringsheader. Stödet skiljer sig mellan klienter och ändras över tid, så titta i klientens egna hjälpsidor. Att göra designer i ditt varumärke från ChatGPT tar upp vad du ska leta efter. När den är ansluten ber du assistenten lista sina Gradiently-verktyg för att bekräfta att det fungerade.
Vad din assistent kan göra när den är ansluten
Servern erbjuder samma åtgärder som du har i produkten, genom samma behörigheter. Grupperade efter jobb ser de ut så här:
| Jobb | Vad assistenten kan göra |
|---|---|
| Hitta | Söka Marks på namn, kod eller ton, läsa en Marks recept, lista dina Marks och hitta mallar att utgå från |
| Designa | Be Gradiently egen Designer göra eller ändra en design utifrån en vanlig förfrågan, göra en serie designer utifrån en brief, utgå från en mall och redigera text och element |
| Ändra storlek | Spara kopior av en design i andra storlekar, bredvid originalet, som förblir oförändrat |
| Varumärke | Läsa och uppdatera ett varumärkes profil, generera varumärkesförslag och sätta upp ett med en Mark och startdesigner |
| Marks | Smida ett Mark-recept utifrån en beskrivning och spara det som ditt privata utkast, lägga en Mark på en design, säkra en Mark om nyckeln tillåter det |
| Dela och exportera | Slå på en länk med enbart visning för en design, eller rendera den som PNG eller PDF när Marken är säkrad |
Vanliga förfrågningar fungerar bäst. Assistenten lämnar dem vidare till Designer, som läser din varumärkesprofil och varumärkets Mark innan den komponerar något. Precis som i Studio mäts Designers arbete i AI-krediter.
Vad ”en affisch till vår solståndsfest på taket, 21 juni, från solnedgång till soluppgång” kan bli: en sparad design på ditt varumärkes Mark, redo att öppna och justera.
- ”Gör sex inlägg till vår höstlansering i vårt varumärke, stående format för Instagram.”
- ”Ta gårdagens tillkännagivande och gör en story och en X-header av det.”
- ”Hitta tre mörka Marks med siden som material och berätta koderna för mig.”
- ”Uppdatera vår varumärkesprofil: vi låter lugna och exakta, aldrig säljiga.”
För en fullständigare genomgång med Claude specifikt, se att designa med Claude via Gradiently. Om du vill att assistenten ska hålla sig till varumärket visar varumärkesriktlinjer som din AI-assistent kan följa hur du skriver den varumärkesprofil den läser.
Så håller du anslutningen säker
Undvik
- En nyckel med alla behörigheter, delad av alla verktyg
- Att klistra in en nyckel i en chatt, ett dokument eller ett arkiv
- Att lämna kvar nycklar för verktyg du slutat använda
- Att kryssa i Säkra Marks för en agent som bara designar
Gör så här
- En nyckel per klient, namngiven efter var den körs
- Att förvara den i en lösenordshanterare eller hemlighetslagring
- Att återkalla oanvända nycklar i Inställningar, de slutar fungera direkt
- Att ge den minsta uppsättning behörigheter som fungerar
Några garantier gäller oavsett vad klienten gör. En nyckel fungerar bara i den arbetsyta som utfärdade den. Den agerar enligt samma regler som personen som skapade den, så den kan inte göra något som deras roll inte kan. En nyckel överför aldrig en Marks ägarskap till arbetsytan eller någon annan. Privata designer förblir privata: en länk med enbart visning finns bara när du ber om en. Och om personen som skapade en nyckel tas bort från arbetsytan eller förlorar sin adminroll slutar även hens nycklar att fungera.
Vanliga frågor
Vilken är Gradiently MCP-slutpunkten?
Den värdbaserade slutpunkten är https://gradiently.design/api/mcp. Varje förfrågan kräver headern Authorization: Bearer följt av en API-nyckel från Inställningar › API och agenter.
Vem kan skapa en Gradiently API-nyckel?
Ägare och admins på en arbetsyta. Varje nyckel tillhör just den arbetsytan och har bara de behörigheter som kryssades i när den skapades.
Fungerar det med ChatGPT?
Det fungerar med vilken MCP-klient som helst som kan ansluta till en HTTP-fjärrserver och skicka en auktoriseringsheader. Om ChatGPT kan det beror på app, abonnemang och arbetsyteinställningar, så titta i dess aktuella hjälpsidor.
Vad händer om min nyckel läcker?
Återkalla den i Inställningar › API och agenter. Allt som använder den slutar fungera direkt, och du kan skapa en ny nyckel.
Kan en assistent säkra Marks åt mig?
Bara om dess nyckel har behörigheten Säkra Marks, som är av som standard. Att säkra är gratis medan Gradiently lanseras.
Skriven av Gradiently
Teamet bakom Gradiently, ett designverktyg byggt kring Marks: levande gradienter som får allt du gör att kännas som ditt.
Se vår profil


