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:// 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.
Vad den låter assistenten göra
Vad den låter assistenten göra
Vad den låter assistenten göra
Vad den låter assistenten göra
Vad den låter assistenten göra
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:
Vad assistenten kan göra
Vad assistenten kan göra
Vad assistenten kan göra
Vad assistenten kan göra
Vad assistenten kan göra
Vad assistenten kan göra
Vanliga förfrågningar fungerar bäst. Assistenten kan själv lägga upp och redigera designer med Gradientlys verktyg, och det kostar inga AI-krediter hos Gradiently. Ber du i stället om Gradiently egen Designer läser den din varumärkesprofil och varumärkets Mark innan den komponerar något, och precis som i Studio mäts dess 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://. 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 en Mark är en engångsbetalning, så slå bara på den behörigheten för en assistent som du vill ska säkra åt dig.
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