Bygg med Gradiently

Gradiently ger dig två vägar in. MCP-servern låter en AI-assistent som Claude Code använda Gradientlys verktyg medan du pratar med den. API:t låter din egen kod anropa samma slutpunkter direkt. Båda autentiserar med en API-nyckel som hör till en arbetsyta, och båda går igenom samma kontroller som appen: roller i arbetsytan, licenser för Marks, AI-krediter och hastighetsgränser.

Vad du kan göra

• Söka på Marknaden och läsa hela receptet för vilken offentlig Mark som helst.
• Generera varumärkesförslag utifrån ett namn och en beskrivning och sedan anta ett av dem: ett Mark-utkast, ett varumärke och tre startdesigner i ett steg.
• Skapa designer med Gradientlys egen Designer, med layoutmotorn eller från en mall, och få tillbaka en länk som öppnas i Studion.
• Redigera sparade designer element för element, ändra deras text, spara kopior i andra storlekar och ge dem en annan Mark.
• Rendera en sparad design till PNG eller PDF, eller publicera en visningslänk för den.
• Smida Mark-recept utifrån en avsikt, granska deras färg och läsbarhet och spara versioner av dina utkast.

MCP eller API:t

MCP-verktygen bygger på API:t. Ett verktygsanrop gör samma förfrågningar som din kod skulle göra, med samma nyckel, så det räknas mot samma gränser och misslyckas med samma meddelanden.

Snabbstart

1. 1

   Skapa en nyckel

   Öppna Inställningar › API och agenter i Gradiently, välj arbetsyta, namnge nyckeln efter var du ska använda den, välj vad den kan göra och välj Skapa nyckel. Kopiera nyckeln när den visas: den visas bara en gång. Bara ägare och admins kan skapa nycklar.

2. 2

   Anslut din assistent

   Lägg till Gradiently som fjärransluten MCP-server i Claude Code, med din nyckel i Authorization-huvudet (kommandot finns nedan). Andra klienter beskrivs på MCP och AI-assistenter.

3. 3

   Be om något

   Prova ”Generera tre varumärkesriktningar för ett litet bageri som heter Hearth, lugnt och varmt, och anta sedan den första.” Assistenten anropar generate_brand och adopt_brand, och du får ett nytt varumärke med ett eget Mark-utkast och startdesigner i din arbetsyta.

export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

Om du vill anropa API:t i stället skickar du samma huvud med varje förfrågan:

curl https://gradiently.design/api/marks?q=harbour \
  -H "Authorization: Bearer $GRADIENTLY_API_KEY"

Hur en nyckel agerar

En nyckel agerar som personen som skapade den, inom den enda arbetsyta den skapades för. Den kan aldrig nå en annan arbetsyta, inte ens en som skaparen tillhör. Den fungerar bara så länge skaparen fortfarande är ägare eller admin i arbetsytan och kontot är aktivt; om personen tas bort, degraderas eller stängs av slutar nyckeln att fungera.

• Designer, varumärken och uppladdningar som en nyckel skapar tillhör arbetsytan, precis som om skaparen hade gjort dem i appen.
• Marks som en nyckel säkrar innehas av dess skapare, aldrig av arbetsytan, och en eventuell licens förblir skaparens.
• Arbete som en nyckel startar hos Designer förbrukar arbetsytans AI-krediter, precis som Designer i Studion.
• En nyckel kan inte hantera nycklar, ändra kontot, nå fakturering eller ge bort en Mark. API-nycklar och behörigheter listar vad den aldrig kan göra.

Resten av dokumentationen

• MCP och AI-assistenter: hur du ansluter Claude Code och andra klienter, varje verktyg med dess indata och behörigheter, och exempel på uppmaningar.
• API-referens: bas-URL, autentisering, varje slutpunkt som en nyckel kan anropa, fel, hastighetsgränser och sidindelning.
• API-nycklar och behörigheter: skapa, rotera och återkalla nycklar, vad varje behörighet tillåter och hur du håller nycklar säkra.
• Ny på MCP? Vad är MCP förklarar det med vanliga ord, och modelcontextprotocol.io har specifikationen.

Har du fastnat, eller saknar du något du behöver? Skicka en förfrågan så svarar en människa.