Serveren accepterer OAuth-adgangstokens og API-nøgler til arbejdsområdet. Begge bruger samme tilladelser, licenser, credits og grænser. Model Context Protocol er en åben standard for at give AI-assistenter værktøjer. Gradiently kører en hostet MCP-server. ChatGPT forbinder til https://, og Claude og andre klienter til https://. Forbind den én gang med en API-nøgle, så kan din assistent kalde Gradientlys værktøjer, mens du taler med den. Hvert værktøj laver de samme API-forespørgsler, som din egen kode ville, så det har de samme tilladelser, licenser, kreditter og grænser.
Før du forbinder
- Opret en nøgle i Indstillinger › API og agenter (se API-nøgler og tilladelser). Nøglen afgør, hvilket arbejdsområde assistenten arbejder i, og hvilke værktøjer der virker.
- En klient med API-nøgle sender
Authorization: Bearer gr_live_…. ChatGPT og Claude sender OAuth-tokenet efter login. - Serveren taler Streamable HTTP, tilstandsløst, med JSON-svar. Den kræver ingen session og har ingen separat hændelsesstrøm, der skal åbnes.
- Serveren accepterer OAuth-adgangstokens og API-nøgler til arbejdsområdet. Begge bruger samme tilladelser, licenser, credits og grænser.
Forbind ChatGPT og Claude
Tilføj en brugerdefineret forbindelse med ChatGPT: https://; Claude: https://, og vælg OAuth-login. Log ind på Gradiently, vælg et arbejdsområde, og gennemgå tilladelserne. Kun ejere og administratorer kan forbinde en assistent.
Forbindelser udløber efter en time og fornyes automatisk i op til 30 dage. Tilbagekald en forbindelse i Indstillinger › API og agenter for at stoppe adgang og fornyelse med det samme.
En brugerdefineret forbindelse og en plads i det offentlige katalog er forskellige ting. Udgivelse i kataloget kræver gennemgang og godkendelse fra OpenAI eller Anthropic.
Forbind Claude Code
Tilføj Gradiently som ekstern server over HTTP med din nøgle i headeren. Gem nøglen i en miljøvariabel, så den aldrig havner i din shell-historik eller i en fil, der bliver committet.
# 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 session i Claude Code, og bed den om at vise Gradientlys værktøjer for at tjekke forbindelsen. Melder den en godkendelsesfejl, er nøglen skrevet forkert, tilbagekaldt, eller dens skaber er ikke længere ejer eller admin af arbejdsområdet.
Andre klienter
Enhver klient, der kan tilføje en ekstern MCP-server over Streamable HTTP og sende en brugerdefineret header, kan bruge Gradiently med samme URL og header. Om din kan, afhænger af klienten og dens version.
- Klienter, der konfigureres med en JSON-fil, accepterer ofte formatet nedenfor, som også vises i Indstillinger under Tilslut en MCP-klient. Tjek din klients dokumentation for det præcise format.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer gr_live_…" }
}
}
}Sådan opfører værktøjerne sig
- Værktøjerne returnerer JSON-tekst.
inspect_designreturnerer også et PNG-billede. Fejl returnerer en fejlmeddelelse. - Værktøjer, der skal bruge et brand, tager en valgfri
personality(dens id eller slug). Uden den bruger de arbejdsområdets første brand. - Værktøjer, der gemmer et design, returnerer dets link til Studiet, designets adresse
/på gradiently.design.studio/ <id> - Flere værktøjer slår først dine brands op via
/, som kræver bådeapi/ me workspaces:readogdesigns:read. Disse værktøjer viser begge tilladelser nedenfor. - Et værktøjskald tæller mod din nøgles hastighedsgrænse én gang for MCP-forespørgslen og én gang for hver API-forespørgsel, værktøjet laver.
Marks
search_marksHvad det gør
Input
q, tone (dark eller light), limit (1 til 120, standard 24), alle valgfriTilladelser
marks:readget_markHvad det gør
Input
code (en kode eller et id)Tilladelser
marks:readlist_marksHvad det gør
Input
Tilladelser
marks:readclaim_markHvad det gør
Input
codeTilladelser
marks:read, marks:claimexport_markHvad det gør
Input
mark, width, height, personalityTilladelser
workspaces:read, designs:read, designs:writerestore_mark_versionHvad det gør
Input
mark, versionTilladelser
brand:generateupdate_mark_versionHvad det gør
Input
mark, version, label, starredTilladelser
brand:generatedelete_mark_versionHvad det gør
Input
mark, versionTilladelser
brand:generateKræver det betaling at sikre sig en Mark, fejler kaldet med en besked om, at det kræver checkout; gør det færdigt i Gradiently. En nøgle kan ikke betale for noget.
Brands og arbejdsområde
list_personalitiesHvad det gør
Input
Tilladelser
workspaces:read, designs:readcreate_personalityHvad det gør
Input
nameTilladelser
personalities:writeget_brand_profileHvad det gør
Input
personalityTilladelser
workspaces:read, designs:readupdate_brand_profileHvad det gør
Input
personality, profileTilladelser
workspaces:read, designs:read, personalities:writemy_workspaceHvad det gør
Input
Tilladelser
workspaces:read, designs:read, marks:readlist_workspacesHvad det gør
Input
cursorTilladelser
workspaces:readinvite_memberHvad det gør
Input
workspaceId, email, role (admin, editor eller viewer)Tilladelser
members:writetone tager op til tre af calm, bold, warm, cool, playful, luxe, natural, technical, editorial og nocturnal; en forespørgsel med flere afvises. colours tager op til otte hexfarver, og count beder om et til otte forslag; flere end det afvises også. For at vælge et forslag sender du præcis det input, der genererede det, sammen med forslagets key: serveren laver forslaget igen ud fra det input og stoler aldrig på en opskrift sendt af klienten.
Design
Bed din tilsluttede AI om at læse brandprofilen og get_design_guidance, skabe med draw_design, se det rigtige billede med inspect_design og finpudse med edit_design. Direkte tegning, redigering og gennemgang bruger ingen Gradiently AI-credits. Din udbyders forbrugsgrænser samt konto- og eksporttilladelser gælder stadig. En tegning kan rumme værtens egne vektorillustrationer, renset SVG, rigtige diagrammer, grafik fra biblioteket og licenserede fotos; alt kan stadig redigeres i Studio. Fotosøgning og -import henter fra Openverse, et eksternt katalog.
get_design_guidanceHvad det gør
Input
purpose, topicTilladelser
draw_designHvad det gør
Input
drawing, personality, mark, designId, page, titleTilladelser
designs:write, workspaces:read, designs:read, marks:readinspect_designHvad det gør
Input
id, page, maxDimensionTilladelser
designs:readfind_iconsHvad det gør
Input
query, limitTilladelser
find_graphicsHvad det gør
Input
query, limitTilladelser
find_photosHvad det gør
Input
query, countTilladelser
designs:readimport_photoHvad det gør
Input
idTilladelser
designs:writedesignBeder Gradientlys egen Designer om at lave et design, eller ændre et, ud fra en almindelig forespørgsel. Den læser brandprofilen og Marken, designer, gennemgår og gemmer. Bruger Gradiently AI-credits.Input
request, personality, size, designId, scope, selectionTilladelser
workspaces:read, designs:read, designs:writecreate_designsHvad det gør
Input
brief, items (size, brief, title), title, personality, mark, waitTilladelser
workspaces:read, designs:read, designs:writeget_design_setHvad det gør
Input
idTilladelser
designs:readstop_design_setHvad det gør
Input
idTilladelser
designs:writecompose_designHvad det gør
Input
composition, personality, designId, titleTilladelser
workspaces:read, designs:read, designs:writelist_sizesHvad det gør
Input
Tilladelser
create_designHvad det gør
Input
form, size, copy, look, personalityTilladelser
workspaces:read, designs:read, designs:writedesign og create_designs bruger arbejdsområdets AI-kreditter, ligesom Designer gør i Studiet. Er saldoen for lav, fejler de med en besked om det; fyld op i Indstillinger › AI-kreditter. Højst to serier kører ad gangen pr. person, og en færdig serie kan læses i omkring tyve minutter. Selve designene bliver.
En komposition angiver en size (et id på en forudindstilling som ig-post, x-post eller li-banner, eller {w, h} i pixels), et layout (statement, editorial, poster, split, stat, quote, list, event eller minimal) og blocks i læserækkefø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 indeholder designets id, dets link til Studiet, fund fra gennemgangen og de elementer, det placerede.Redigering og eksport
list_designsHvad det gør
Input
personalityTilladelser
workspaces:read, designs:readget_designHvad det gør
Input
id, page, kind, name, textTilladelser
designs:readedit_designHvad det gør
Input
id, ops, pageTilladelser
designs:writeupdate_design_textHvad det gør
Input
id, text (element-id til ord)Tilladelser
designs:read, designs:writeresize_copiesHvad det gør
Input
id, sizesTilladelser
designs:read, designs:writewear_markHvad det gør
Input
mark og design eller personalityTilladelser
render_designHvad det gør
Input
id, width, height, format, pageTilladelser
designs:readexport_design_linkHvad det gør
/ d/ <id>, som alle med linket kan åbne.Input
idTilladelser
designs:writewear_mark på et design kræver designs:read og designs:write. At gøre en Mark til et brands Mark kræver workspaces:read, designs:read og personalities:write og en Mark, du ejer med en aktiv licens. Angiver du Marken med dens kode, kræves også marks:read.
render_design tager width og height fra 1 til 4096 pixels og format png eller pdf. page tælles fra 0: PNG gengiver som standard den første side og PDF alle sider. En PDF bevarer hver side i dens størrelse fra Studiet, så den størrelse, du beder om, skal passe. Gengivelse kræver samme eksportlicens til designets Mark som i Studiet, og den udgiver eller ændrer aldrig designet.
Video, lyd og undertekster
Brug find_uploads til at finde tilladte kildereferencer og derefter 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. Gæt aldrig kildens varighed. Videodelinger og elementtider bruger sekunder på siden; lydstarter, lyddelinger og undertekster bruger sekunder i hele dokumentet. Lyd forlænger ikke scenerne. Undertekster tager imod angivet tekst med tider eller SRT/WebVTT-indhold; automatisk transskription er ikke tilgængelig. get_design viser hele tidslinjen og sporene. export_captions returnerer SRT/WebVTT-filindhold i dele med højst 100 undertekster og 48.000 tegn; brug nextOffset til næste del.
Eksempler på prompts
- »Find mørke Marks i Markedet med krom i, og vis mig de tre, der ligger tættest på dyb petroleum.« Bruger
search_marks. - »Skift overskriften på design 4f1c… til ›Dørene åbner klokken syv‹, og lav kopier til en Instagram-story og et opslag på X.« Bruger
get_design,update_design_textogresize_copies. - »Gengiv design 4f1c… som en PNG på 1080 gange 1350, og gem den som launch.png.« Bruger
render_design. - »Lav en plakat til vores solhvervsfest på taget, 21. juni, fra solnedgang til solopgang.« Bruger
design, som kræverworkspaces:read.
Hele referencen for de endpoints, der ligger bag disse værktøjer, står på API-reference. Til alt andet kan du sende os en forespørgsel.