Bygg med Gradiently

Gradiently gir deg to veier inn. MCP-serveren lar en AI-assistent som Claude Code bruke verktøyene til Gradiently mens du snakker med den. API-et lar din egen kode kalle de samme endepunktene direkte. Begge autentiserer med en API-nøkkel som hører til ett arbeidsområde, og begge går gjennom de samme kontrollene som appen: roller i arbeidsområdet, lisenser for Marks, AI-kreditter og forespørselsgrenser.

Hva du kan gjøre

• Søk i Markedet og les hele oppskriften til enhver offentlig Mark.
• Generer merkevareforslag fra et navn og en beskrivelse, og ta så i bruk ett av dem: et Mark-utkast, en merkevare og tre startdesign i ett steg.
• Lag design med Gradientlys egen Designer, med layoutmotoren eller fra en mal, og få tilbake en lenke som åpnes i Studio.
• Rediger lagrede design element for element, endre ordene, lagre kopier i andre størrelser og gi dem en annen Mark.
• Gjengi et lagret design som PNG eller PDF, eller publiser en visningslenke til det.
• Smi Mark-oppskrifter ut fra en intensjon, gå gjennom farger og lesbarhet, og ta vare på versjoner av utkastene dine.

MCP eller API-et

MCP-verktøyene er bygget på API-et. Et verktøykall gjør de samme forespørslene som koden din ville gjort, med den samme nøkkelen, så det teller mot de samme grensene og feiler med de samme meldingene.

Kom raskt i gang

1. 1

   Opprett en nøkkel

   Åpne Innstillinger › API og agenter i Gradiently, velg arbeidsområdet, gi nøkkelen et navn etter hvor du skal bruke den, velg hva den kan gjøre, og velg Opprett nøkkel. Kopier nøkkelen når den vises: den vises bare én gang. Bare eiere og administratorer kan opprette nøkler.

2. 2

   Koble til assistenten din

   I Claude Code legger du til Gradiently som en ekstern MCP-server med nøkkelen din i Authorization-headeren (kommandoen står nedenfor). Andre klienter er beskrevet under MCP og AI-assistenter.

3. 3

   Be om noe

   Prøv «Lag tre merkevareretninger for et lite bakeri som heter Hearth, rolig og varmt, og ta i bruk den første.» Assistenten kaller generate_brand og adopt_brand, og du får en ny merkevare med sitt eget Mark-utkast og startdesign i arbeidsområdet ditt.

export GRADIENTLY_API_KEY="gr_live_…"

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

Vil du kalle API-et i stedet, sender du den samme headeren med hver forespørsel:

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

Hvordan en nøkkel opptrer

En nøkkel opptrer som personen som opprettet den, innenfor det ene arbeidsområdet den ble opprettet for. Den kan aldri nå et annet arbeidsområde, heller ikke et som den som opprettet den, er medlem av. Den virker bare så lenge den som opprettet den, fortsatt er eier eller administrator i arbeidsområdet og kontoen er aktiv; blir personen fjernet, degradert eller deaktivert, slutter nøkkelen å virke.

• Design, merkevarer og opplastinger som en nøkkel lager, hører til arbeidsområdet, akkurat som om den som opprettet nøkkelen, hadde laget dem i appen.
• Marks som en nøkkel sikrer seg, innehas av den som opprettet nøkkelen, aldri av arbeidsområdet, og eventuelle lisenser forblir deres.
• Arbeid som en nøkkel setter i gang i Designer, bruker arbeidsområdets AI-kreditter, akkurat som Designer i Studio.
• En nøkkel kan ikke administrere nøkler, endre kontoen, nå fakturering eller gi bort en Mark. API-nøkler og tillatelser viser hva den aldri kan gjøre.

Resten av dokumentasjonen

• MCP og AI-assistenter: slik kobler du til Claude Code og andre klienter, alle verktøyene med inndata og tillatelser, og eksempler på ledetekster.
• API-referanse: basis-URL, autentisering, alle endepunktene en nøkkel kan kalle, feil, forespørselsgrenser og paginering.
• API-nøkler og tillatelser: opprette, rotere og tilbakekalle nøkler, hva hver tillatelse gir tilgang til, og hvordan du holder nøklene trygge.
• Ny med MCP? Hva er MCP forklarer det med vanlige ord, og modelcontextprotocol.io har spesifikasjonen.

Står du fast, eller mangler du noe? Send oss en forespørsel, så svarer et menneske.