MarkedetUdforskPrøv
Priser
Log indStart
Udviklere

MCP og AI-assistenter

Gradiently har et HTTP-API og en hostet MCP-server. Forbind en assistent med OAuth eller en API-nøgle til et arbejdsområde.

Opdateret 11. oktober 2026

Udviklerdokumentation

  • Overblik
  • MCP og AI-assistenter
  • API-reference
  • API-nøgler og tilladelser

På denne side

Før du forbinderForbind ChatGPT og ClaudeForbind Claude CodeAndre klienterSådan opfører værktøjerne sigMarksBrands og arbejdsområdeDesignRedigering og eksportVideo, lyd og underteksterEksempler på prompts

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://gradiently.design/api/mcp/chatgpt, og Claude og andre klienter til https://gradiently.design/api/mcp. 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://gradiently.design/api/mcp/chatgpt; Claude: https://gradiently.design/api/mcp, 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.

bash
# 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.
json
{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer gr_live_…" }
    }
  }
}

Tillad lange værktøjskald

De fleste værktøjer svarer på få sekunder. render_design, inspect_design og export_mark kan tage op til tre minutter, design op til omkring fem og create_designs med wait op til omkring fire. Har din klient en indstilling for timeout på værktøjer, så hæv den tilsvarende.

Sådan opfører værktøjerne sig

  • Værktøjerne returnerer JSON-tekst. inspect_design returnerer 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 /studio/<id> på gradiently.design.
  • Flere værktøjer slår først dine brands op via /api/me, som kræver både workspaces:read og designs: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.

Tilladelserne, du skal give en assistent

En nøgle, der oprettes i Indstillinger, starter med designs:read, designs:write, marks:read, brand:generate og workspaces:read: nok til alle designværktøjer. Tilføj marks:claim for at sikre dig Marks, personalities:write for at oprette brands eller ændre deres Mark og profil og members:write for at sende invitationer.

Marks

search_marks

Hvad det gør

Søger i det offentlige Marked efter navn eller kode. Returnerer farver, materialer, status og indehaver.

Input

q, tone (dark eller light), limit (1 til 120, standard 24), alle valgfri

Tilladelser

marks:read
get_mark

Hvad det gør

Én Mark og dens fulde opskrift.

Input

code (en kode eller et id)

Tilladelser

marks:read
list_marks

Hvad det gør

Marks, der ejes for dette arbejdsområde, med licensstatus, og dine kladder i det.

Input

ingen

Tilladelser

marks:read
claim_mark

Hvad det gør

Sikrer en ledig Mark. Nøglens skaber bliver indehaver, aldrig arbejdsområdet.

Input

code

Tilladelser

marks:read, marks:claim
export_mark

Hvad det gør

Gengiver en Mark alene som PNG, op til 4096 px på hver side.

Input

mark, width, height, personality

Tilladelser

workspaces:read, designs:read, designs:write
restore_mark_version

Hvad det gør

Sætter en version tilbage som kladden. Den nuværende tilstand gemmes først som en version.

Input

mark, version

Tilladelser

brand:generate
update_mark_version

Hvad det gør

Omdøber eller stjernemarkerer en version. Stjernemarkerede versioner bevares.

Input

mark, version, label, starred

Tilladelser

brand:generate
delete_mark_version

Hvad det gør

Sletter en version, aldrig den udgivne.

Input

mark, version

Tilladelser

brand:generate
VærktøjHvad det gørInputTilladelser
search_marksSøger i det offentlige Marked efter navn eller kode. Returnerer farver, materialer, status og indehaver.q, tone (dark eller light), limit (1 til 120, standard 24), alle valgfrimarks:read
get_markÉn Mark og dens fulde opskrift.code (en kode eller et id)marks:read
list_marksMarks, der ejes for dette arbejdsområde, med licensstatus, og dine kladder i det.ingenmarks:read
claim_markSikrer en ledig Mark. Nøglens skaber bliver indehaver, aldrig arbejdsområdet.codemarks:read, marks:claim
export_markGengiver en Mark alene som PNG, op til 4096 px på hver side.mark, width, height, personalityworkspaces:read, designs:read, designs:write
restore_mark_versionSætter en version tilbage som kladden. Den nuværende tilstand gemmes først som en version.mark, versionbrand:generate
update_mark_versionOmdøber eller stjernemarkerer en version. Stjernemarkerede versioner bevares.mark, version, label, starredbrand:generate
delete_mark_versionSletter en version, aldrig den udgivne.mark, versionbrand:generate

Kræ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_personalities

Hvad det gør

Arbejdsområdets brands med deres id’er.

Input

ingen

Tilladelser

workspaces:read, designs:read
create_personality

Hvad det gør

Opretter et navngivet brand.

Input

name

Tilladelser

personalities:write
get_brand_profile

Hvad det gør

Hvad et brand er, hvem det er til, dets tone, hvad man gør og ikke gør, og skrifttyper.

Input

personality

Tilladelser

workspaces:read, designs:read
update_brand_profile

Hvad det gør

Erstatter et brands profil. Designer læser den før hvert design.

Input

personality, profile

Tilladelser

workspaces:read, designs:read, personalities:write
my_workspace

Hvad det gør

Dig, arbejdsområdets brands med deres Mark-koder og de Marks, der ejes for det.

Input

ingen

Tilladelser

workspaces:read, designs:read, marks:read
list_workspaces

Hvad det gør

Nøglens arbejdsområde og din rolle i det.

Input

cursor

Tilladelser

workspaces:read
invite_member

Hvad det gør

Sender en invitation, der gælder i syv dage, til at blive medlem af arbejdsområdet.

Input

workspaceId, email, role (admin, editor eller viewer)

Tilladelser

members:write
VærktøjHvad det gørInputTilladelser
list_personalitiesArbejdsområdets brands med deres id’er.ingenworkspaces:read, designs:read
create_personalityOpretter et navngivet brand.namepersonalities:write
get_brand_profileHvad et brand er, hvem det er til, dets tone, hvad man gør og ikke gør, og skrifttyper.personalityworkspaces:read, designs:read
update_brand_profileErstatter et brands profil. Designer læser den før hvert design.personality, profileworkspaces:read, designs:read, personalities:write
my_workspaceDig, arbejdsområdets brands med deres Mark-koder og de Marks, der ejes for det.ingenworkspaces:read, designs:read, marks:read
list_workspacesNøglens arbejdsområde og din rolle i det.cursorworkspaces:read
invite_memberSender en invitation, der gælder i syv dage, til at blive medlem af arbejdsområdet.workspaceId, email, role (admin, editor eller viewer)members:write

tone 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_guidance

Hvad det gør

Gennemgået, skriftlig art direction: kvalitetsniveauet, tegnemulighederne, konceptmetoden og gennemgangsløkken, med dybere emner som illustration, data og typografi. Ikke skabeloner eller modeltræning.

Input

purpose, topic

Tilladelser

enhver nøgle
draw_design

Hvad det gør

Tegner et originalt, redigerbart design med din tilsluttede AI: tekst, former, egne vektorillustrationer, SVG, rigtige diagrammer, grafik, fotos, Mark-vinduer og tabeller. Kun den valgte side tegnes om.

Input

drawing, personality, mark, designId, page, title

Tilladelser

designs:write, workspaces:read, designs:read, marks:read
inspect_design

Hvad det gør

Returnerer et rigtigt PNG-billede, som assistenten kan vurdere og forbedre. Mindre størrelser er hele siden skaleret ned, som et feed viser den.

Input

id, page, maxDimension

Tilladelser

designs:read
find_icons

Hvad det gør

Finder gyldige navne på indbyggede ikoner.

Input

query, limit

Tilladelser

enhver nøgle
find_graphics

Hvad det gør

Finder Gradientlys egen grafik, der kan farves om og bruges som understøttende detaljer.

Input

query, limit

Tilladelser

enhver nøgle
find_photos

Hvad det gør

Søger i licenserede fotos på Openverse og returnerer miniaturer, som assistenten kan se. Oplyser det, når en miniature ikke kan hentes. Intet gemmes.

Input

query, count

Tilladelser

designs:read
import_photo

Hvad det gør

Kopierer et valgt foto til arbejdsområdets uploads med kreditering, inden for din uploadkvote.

Input

id

Tilladelser

designs:write
designBeder 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, selection

Tilladelser

workspaces:read, designs:read, designs:write
create_designs

Hvad det gør

Laver en serie på op til tolv designs ud fra ét brief, i baggrunden. Bruger Gradiently AI-credits.

Input

brief, items (size, brief, title), title, personality, mark, wait

Tilladelser

workspaces:read, designs:read, designs:write
get_design_set

Hvad det gør

En series fremskridt og hvert designs link til Studiet, når det findes.

Input

id

Tilladelser

designs:read
stop_design_set

Hvad det gør

Stopper en kørende serie. Designs, der allerede er tegnet, forbliver gemt.

Input

id

Tilladelser

designs:write
compose_design

Hvad det gør

Sætter din tekst op med layoutmotoren og gemmer den. Returnerer fund fra gennemgangen, der skal rettes.

Input

composition, personality, designId, title

Tilladelser

workspaces:read, designs:read, designs:write
list_sizes

Hvad det gør

Alle forudindstillede størrelser med deres størrelse i pixels.

Input

ingen

Tilladelser

enhver nøgle
create_design

Hvad det gør

Opretter et design ud fra en grundform (tom som standard), en forudindstillet størrelse og tekst knyttet til element-id.

Input

form, size, copy, look, personality

Tilladelser

workspaces:read, designs:read, designs:write
VærktøjHvad det gørInputTilladelser
get_design_guidanceGennemgået, skriftlig art direction: kvalitetsniveauet, tegnemulighederne, konceptmetoden og gennemgangsløkken, med dybere emner som illustration, data og typografi. Ikke skabeloner eller modeltræning.purpose, topicenhver nøgle
draw_designTegner et originalt, redigerbart design med din tilsluttede AI: tekst, former, egne vektorillustrationer, SVG, rigtige diagrammer, grafik, fotos, Mark-vinduer og tabeller. Kun den valgte side tegnes om.drawing, personality, mark, designId, page, titledesigns:write, workspaces:read, designs:read, marks:read
inspect_designReturnerer et rigtigt PNG-billede, som assistenten kan vurdere og forbedre. Mindre størrelser er hele siden skaleret ned, som et feed viser den.id, page, maxDimensiondesigns:read
find_iconsFinder gyldige navne på indbyggede ikoner.query, limitenhver nøgle
find_graphicsFinder Gradientlys egen grafik, der kan farves om og bruges som understøttende detaljer.query, limitenhver nøgle
find_photosSøger i licenserede fotos på Openverse og returnerer miniaturer, som assistenten kan se. Oplyser det, når en miniature ikke kan hentes. Intet gemmes.query, countdesigns:read
import_photoKopierer et valgt foto til arbejdsområdets uploads med kreditering, inden for din uploadkvote.iddesigns:write
designBeder 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.request, personality, size, designId, scope, selectionworkspaces:read, designs:read, designs:write
create_designsLaver en serie på op til tolv designs ud fra ét brief, i baggrunden. Bruger Gradiently AI-credits.brief, items (size, brief, title), title, personality, mark, waitworkspaces:read, designs:read, designs:write
get_design_setEn series fremskridt og hvert designs link til Studiet, når det findes.iddesigns:read
stop_design_setStopper en kørende serie. Designs, der allerede er tegnet, forbliver gemt.iddesigns:write
compose_designSætter din tekst op med layoutmotoren og gemmer den. Returnerer fund fra gennemgangen, der skal rettes.composition, personality, designId, titleworkspaces:read, designs:read, designs:write
list_sizesAlle forudindstillede størrelser med deres størrelse i pixels.ingenenhver nøgle
create_designOpretter et design ud fra en grundform (tom som standard), en forudindstillet størrelse og tekst knyttet til element-id.form, size, copy, look, personalityworkspaces:read, designs:read, designs:write

design 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.

json
{
  "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" }
    ]
  }
}
Input til compose_design. Svaret indeholder designets id, dets link til Studiet, fund fra gennemgangen og de elementer, det placerede.

Redigering og eksport

list_designs

Hvad det gør

Et brands gemte designs med links til Studiet.

Input

personality

Tilladelser

workspaces:read, designs:read
get_design

Hvad det gør

Et designs størrelse, sider og hvert element med dets egenskaber. Filtrér lange designs efter side, type, navn eller tekst.

Input

id, page, kind, name, text

Tilladelser

designs:read
edit_design

Hvad det gør

Ændrer et design med op til 100 handlinger, som en person ville gøre i Studiet, og gemmer det.

Input

id, ops, page

Tilladelser

designs:write
update_design_text

Hvad det gør

Erstatter ordene i udvalgte tekstelementer og bevarer layoutet.

Input

id, text (element-id til ord)

Tilladelser

designs:read, designs:write
resize_copies

Hvad det gør

Gemmer kopier i op til otte andre størrelser, omlagt som i Studiet. Originalen er uændret.

Input

id, sizes

Tilladelser

designs:read, designs:write
wear_mark

Hvad det gør

Sætter en Mark på ét design eller gør den til et brands Mark for nye designs.

Input

mark og design eller personality

Tilladelser

se nedenfor
render_design

Hvad det gør

Gengiver et gemt design som PNG eller PDF med Studiets motor. Returnerer filen som base64.

Input

id, width, height, format, page

Tilladelser

designs:read
export_design_link

Hvad det gør

Udgiver et visningslink, /d/<id>, som alle med linket kan åbne.

Input

id

Tilladelser

designs:write
VærktøjHvad det gørInputTilladelser
list_designsEt brands gemte designs med links til Studiet.personalityworkspaces:read, designs:read
get_designEt designs størrelse, sider og hvert element med dets egenskaber. Filtrér lange designs efter side, type, navn eller tekst.id, page, kind, name, textdesigns:read
edit_designÆndrer et design med op til 100 handlinger, som en person ville gøre i Studiet, og gemmer det.id, ops, pagedesigns:write
update_design_textErstatter ordene i udvalgte tekstelementer og bevarer layoutet.id, text (element-id til ord)designs:read, designs:write
resize_copiesGemmer kopier i op til otte andre størrelser, omlagt som i Studiet. Originalen er uændret.id, sizesdesigns:read, designs:write
wear_markSætter en Mark på ét design eller gør den til et brands Mark for nye designs.mark og design eller personalityse nedenfor
render_designGengiver et gemt design som PNG eller PDF med Studiets motor. Returnerer filen som base64.id, width, height, format, pagedesigns:read
export_design_linkUdgiver et visningslink, /d/<id>, som alle med linket kan åbne.iddesigns:write

wear_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_text og resize_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æver workspaces: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.

Brug for hjælp?

Send os en forespørgsel med emnet API og MCP, så svarer en person.

Send en forespørgsel

Find det look, der kun er dit.

Hver Mark er en levende baggrund med én ejer. Prøv en ledig Mark, og sikr dig din, når det føles rigtigt.

Begynd at designeSe lanceringstilbuddet

Marks tilbage at sikre sig

50af 1.000

950 sikret indtil nuFind din

Tjek et certifikat

Skriv et certifikatnummer eller en Marks kode for at se, hvem der ejer den.

Virker med ChatGPT og Claude

Bed din AI om et design. Den laver det i din Mark, klar til at redigere.

ChatGPTClaude
Sådan forbinder du

Produkt

  • Markedet
  • Udforsk
  • Priser
  • Lanceringspakker
  • Certifikater

Lær

  • Designguiden
  • Hjælpecenter
  • Nyheder

Udviklere

  • Oversigt
  • ChatGPT og Claude
  • API-reference
  • API-nøgler

Virksomhed

  • Om os
  • Kontakt os
  • Log ind

Juridisk

  • Vilkår
  • Privatliv
  • Refusion
  • Mark-beskyttelse
  • Cookies
  • Alle politikker
Bevæg dig hen over bogstaverne. Hvert af dem bærer en ægte Mark.Rør ved et bogstav for at se dets Mark.Ét navn. Ti Marks inden i.
© 2026 Gradiently