Serveren godtar OAuth-tilgangstokener og API-nøkler for arbeidsområdet. Begge bruker de samme tillatelsene, lisensene, kredittene og grensene. Model Context Protocol er en åpen standard for å gi AI-assistenter verktøy. Gradiently driver en MCP-server. ChatGPT kobler til https://, og Claude og andre klienter til https://. Koble den til én gang med en API-nøkkel, så kan assistenten din kalle verktøyene til Gradiently mens du snakker med den. Hvert verktøy gjør de samme API-forespørslene som din egen kode ville gjort, så det har de samme tillatelsene, lisensene, kredittene og grensene.
Før du kobler til
- Opprett en nøkkel i Innstillinger › API og agenter (se API-nøkler og tillatelser). Nøkkelen avgjør hvilket arbeidsområde assistenten jobber i, og hvilke verktøy som virker.
- En klient med API-nøkkel sender
Authorization: Bearer gr_live_…. ChatGPT og Claude sender OAuth-tokenet etter pålogging. - Serveren bruker Streamable HTTP, uten tilstand, med JSON-svar. Den trenger ingen økt og har ingen egen hendelsesstrøm som må åpnes.
- Serveren godtar OAuth-tilgangstokener og API-nøkler for arbeidsområdet. Begge bruker de samme tillatelsene, lisensene, kredittene og grensene.
Koble til ChatGPT og Claude
Legg til en egendefinert tilkobling med ChatGPT: https://; Claude: https://, og velg OAuth-pålogging. Logg inn på Gradiently, velg et arbeidsområde og gjennomgå tillatelsene. Bare eiere og administratorer kan koble til en assistent.
Tilkoblinger utløper etter én time og fornyes automatisk i opptil 30 dager. Tilbakekall en tilkobling i Innstillinger › API og agenter for å stoppe tilgang og fornyelse med en gang.
En egendefinert tilkobling og en plass i den offentlige katalogen er ulike ting. Publisering i katalogen krever gjennomgang og godkjenning fra OpenAI eller Anthropic.
Koble til Claude Code
Legg til Gradiently som en ekstern server over HTTP, med nøkkelen din i headeren. Oppbevar nøkkelen i en miljøvariabel, så den aldri havner i skallhistorikken eller i en fil som committes.
# Paste your key when asked. It stays hidden and out of your shell history.
read -rs GRADIENTLY_API_KEY && export GRADIENTLY_API_KEY
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"Start en ny økt i Claude Code og be den liste opp verktøyene til Gradiently for å sjekke tilkoblingen. Melder den en autentiseringsfeil, er nøkkelen skrevet feil eller tilbakekalt, eller så er den som opprettet den, ikke lenger eier eller administrator i arbeidsområdet.
Andre klienter
Alle klienter som kan legge til en ekstern MCP-server over Streamable HTTP og sende en egendefinert header i forespørselen, kan bruke Gradiently med samme URL og header. Om din kan det, avhenger av klienten og versjonen.
- Klienter som konfigureres med en JSON-fil, godtar ofte formen nedenfor, som også vises i Innstillinger under Koble til en MCP-klient. Sjekk dokumentasjonen til klienten din for det nøyaktige formatet.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer gr_live_…" }
}
}
}Slik oppfører verktøyene seg
- Verktøyene returnerer JSON-tekst.
inspect_designreturnerer også et PNG-bilde. Feil returnerer en feilmelding. - Verktøy som trenger en merkevare, tar en valgfri
personality(id-en eller sluggen). Uten den bruker de den første merkevaren i arbeidsområdet. - Verktøy som lagrer et design, returnerer Studio-lenken, altså designets
/-adresse på gradiently.design.studio/ <id> - Flere verktøy slår først opp merkevarene dine via
/, som krever bådeapi/ me workspaces:readogdesigns:read. Disse verktøyene oppgir begge tillatelsene nedenfor. - Et verktøykall teller mot nøkkelens forespørselsgrense én gang for MCP-forespørselen og én gang for hver API-forespørsel verktøyet gjør.
Marks
search_marksHva det gjør
Inndata
q, tone (dark eller light), limit (1 til 120, standard 24), alle valgfrieTillatelser
marks:readget_markHva det gjør
Inndata
code (en kode eller en id)Tillatelser
marks:readlist_marksHva det gjør
Inndata
Tillatelser
marks:readclaim_markHva det gjør
Inndata
codeTillatelser
marks:read, marks:claimexport_markHva det gjør
Inndata
mark, width, height, personalityTillatelser
workspaces:read, designs:read, designs:writerestore_mark_versionHva det gjør
Inndata
mark, versionTillatelser
brand:generateupdate_mark_versionHva det gjør
Inndata
mark, version, label, starredTillatelser
brand:generatedelete_mark_versionHva det gjør
Inndata
mark, versionTillatelser
brand:generateEt forsøk på å sikre en Mark som krever betaling, feiler med en melding om at det må betales; fullfør det i Gradiently. En nøkkel kan ikke betale for noe.
Merkevarer og arbeidsområde
list_personalitiesHva det gjør
Inndata
Tillatelser
workspaces:read, designs:readcreate_personalityHva det gjør
Inndata
nameTillatelser
personalities:writeget_brand_profileHva det gjør
Inndata
personalityTillatelser
workspaces:read, designs:readupdate_brand_profileHva det gjør
Inndata
personality, profileTillatelser
workspaces:read, designs:read, personalities:writemy_workspaceHva det gjør
Inndata
Tillatelser
workspaces:read, designs:read, marks:readlist_workspacesHva det gjør
Inndata
cursorTillatelser
workspaces:readinvite_memberHva det gjør
Inndata
workspaceId, email, role (admin, editor eller viewer)Tillatelser
members:writetone tar opptil tre av calm, bold, warm, cool, playful, luxe, natural, technical, editorial og nocturnal; en forespørsel med flere avvises. colours tar opptil åtte hex-farger, og count ber om ett til åtte forslag; flere enn det avvises også. For å ta i bruk et forslag sender du nøyaktig de inndataene som genererte det, sammen med forslagets key: serveren lager forslaget på nytt fra de inndataene og stoler aldri på en oppskrift sendt fra klienten.
Design
Be din tilkoblede KI lese merkevareprofilen og get_design_guidance, lage designet med draw_design, se det ekte bildet med inspect_design og finpusse med edit_design. Direkte tegning, redigering og gjennomgang bruker ingen Gradiently KI-kreditter. Leverandørens bruksgrenser og konto- og eksporttillatelser gjelder fortsatt. En tegning kan inneholde vertens egne vektorillustrasjoner, renset SVG, ekte diagrammer, grafikk fra biblioteket og lisensierte bilder; alt kan fortsatt redigeres i Studio. Bildesøk og -import henter fra Openverse, en ekstern katalog.
get_design_guidanceHva det gjør
Inndata
purpose, topicTillatelser
draw_designHva det gjør
Inndata
drawing, personality, mark, designId, page, titleTillatelser
designs:write, workspaces:read, designs:read, marks:readinspect_designHva det gjør
Inndata
id, page, maxDimensionTillatelser
designs:readfind_iconsHva det gjør
Inndata
query, limitTillatelser
find_graphicsHva det gjør
Inndata
query, limitTillatelser
find_photosHva det gjør
Inndata
query, countTillatelser
designs:readimport_photoHva det gjør
Inndata
idTillatelser
designs:writedesignBer Gradientlys egen Designer lage et design, eller endre et, ut fra en vanlig forespørsel. Den leser merkevareprofilen og Marken, designer, vurderer og lagrer. Bruker Gradiently KI-kreditter.Inndata
request, personality, size, designId, scope, selectionTillatelser
workspaces:read, designs:read, designs:writecreate_designsHva det gjør
Inndata
brief, items (size, brief, title), title, personality, mark, waitTillatelser
workspaces:read, designs:read, designs:writeget_design_setHva det gjør
Inndata
idTillatelser
designs:readstop_design_setHva det gjør
Inndata
idTillatelser
designs:writecompose_designHva det gjør
Inndata
composition, personality, designId, titleTillatelser
workspaces:read, designs:read, designs:writelist_sizesHva det gjør
Inndata
Tillatelser
create_designHva det gjør
Inndata
form, size, copy, look, personalityTillatelser
workspaces:read, designs:read, designs:writedesign og create_designs bruker arbeidsområdets AI-kreditter, slik Designer gjør i Studio. Når saldoen er for lav, feiler de med en melding om det; fyll på i Innstillinger › AI-kreditter. Høyst to serier kjører samtidig per person, og en ferdig serie kan leses i rundt tjue minutter. Selve designene blir værende.
En komposisjon angir en size (en id for en forhåndsinnstilt størrelse som ig-post, x-post eller li-banner, eller {w, h} i piksler), en layout (statement, editorial, poster, split, stat, quote, list, event eller minimal) og blocks i leserekkefølge, hver med en role som headline, body eller cta og sin text.
{
"composition": {
"size": "ig-post",
"layout": "event",
"blocks": [
{ "role": "eyebrow", "text": "Summer supper club" },
{ "role": "headline", "text": "Long table on the roof" },
{ "role": "details", "text": "", "items": ["Saturday 21 June", "7pm till late"] },
{ "role": "cta", "text": "Book a seat" }
]
}
}compose_design. Svaret inneholder designets id, Studio-lenken, funn fra vurderingen og elementene som ble plassert.Redigering og eksport
list_designsHva det gjør
Inndata
personalityTillatelser
workspaces:read, designs:readget_designHva det gjør
Inndata
id, page, kind, name, textTillatelser
designs:readedit_designHva det gjør
Inndata
id, ops, pageTillatelser
designs:writeupdate_design_textHva det gjør
Inndata
id, text (element-id til ord)Tillatelser
designs:read, designs:writeresize_copiesHva det gjør
Inndata
id, sizesTillatelser
designs:read, designs:writewear_markHva det gjør
Inndata
mark, og design eller personalityTillatelser
render_designHva det gjør
Inndata
id, width, height, format, pageTillatelser
designs:readexport_design_linkHva det gjør
/ d/ <id>, som alle som har den, kan åpne.Inndata
idTillatelser
designs:writewear_mark på et design krever designs:read og designs:write. Å gjøre en Mark til merkevarens Mark krever workspaces:read, designs:read og personalities:write, og en Mark du innehar med aktiv lisens. Å angi Marken med koden krever i tillegg marks:read.
render_design tar width og height fra 1 til 4096 piksler og format png eller pdf. page teller fra 0: PNG gjengir første side som standard og PDF alle sidene. En PDF beholder hver side i størrelsen den har i Studio, så størrelsen du ber om, må stemme. Gjengivelse krever den samme eksportlisensen for designets Mark som Studio, og den publiserer eller endrer aldri designet.
Video, lyd og undertekster
Bruk find_uploads for å finne tillatte kildereferanser og deretter edit_design med add_video, update_video, split_video, add_audio, update_audio, split_audio, remove_audio, set_element_timing, set_captions eller remove_captions. Gjett aldri kildens varighet. Videodeling og elementtider bruker sekunder på siden; lydstarter, lyddeling og undertekster bruker sekunder i hele dokumentet. Lyd forlenger ikke scenene. Undertekster godtar angitt tekst med tider eller SRT/WebVTT-innhold; automatisk transkripsjon er ikke tilgjengelig. get_design viser hele tidslinjen og sporene. export_captions returnerer SRT/WebVTT-filinnhold i deler med høyst 100 undertekster og 48 000 tegn; bruk nextOffset for neste del.
Eksempler på ledetekster
- «Finn mørke Marks i Markedet med krom i seg, og vis meg de tre som ligger nærmest dyp blågrønn.» Bruker
search_marks. - «Endre overskriften på design 4f1c… til ‘Dørene åpner klokka sju’, og lag kopier til en Instagram-story og et X-innlegg.» Bruker
get_design,update_design_textogresize_copies. - «Gjengi design 4f1c… som en PNG på 1080 ganger 1350 og lagre den som launch.png.» Bruker
render_design. - «Lag en plakat til solvervfesten vår på taket, 21. juni, fra solnedgang til soloppgang.» Bruker
design, som kreverworkspaces:read.
Hele referansen for endepunktene bak disse verktøyene finner du under API-referanse. For alt annet kan du sende oss en forespørsel.