MarknadenUtforskaProva
Priser
Logga inKom igång
Utvecklare

MCP och AI-assistenter

Gradiently har ett HTTP-API och en värdbaserad MCP-server. Anslut en assistent med OAuth eller en API-nyckel för en arbetsyta.

Uppdaterad 11 oktober 2026

Utvecklardokumentation

  • Översikt
  • MCP och AI-assistenter
  • API-referens
  • API-nycklar och behörigheter

På den här sidan

Innan du ansluterAnslut ChatGPT och ClaudeAnslut Claude CodeAndra klienterSå beter sig verktygenMarksVarumärken och arbetsytaDesignaRedigera och exporteraVideo, ljud och undertexterExempel på uppmaningar

Servern accepterar OAuth-åtkomsttoken och API-nycklar för arbetsytan. Båda använder samma behörigheter, licenser, krediter och gränser. Model Context Protocol är en öppen standard för att ge AI-assistenter verktyg. Gradiently driver en hostad MCP-server. ChatGPT ansluter till https://gradiently.design/api/mcp/chatgpt, och Claude och andra klienter till https://gradiently.design/api/mcp. Anslut den en gång med en API-nyckel, så kan din assistent anropa Gradientlys verktyg medan du pratar med den. Varje verktyg gör samma API-förfrågningar som din egen kod skulle göra, så det har samma behörigheter, licenser, krediter och gränser.

Innan du ansluter

  • Skapa en nyckel i Inställningar › API och agenter (se API-nycklar och behörigheter). Nyckeln avgör vilken arbetsyta assistenten arbetar i och vilka verktyg som fungerar.
  • En klient med API-nyckel skickar Authorization: Bearer gr_live_…. ChatGPT och Claude skickar OAuth-token efter inloggning.
  • Servern använder Streamable HTTP, tillståndslöst, med JSON-svar. Den behöver ingen session och har ingen separat händelseström att öppna.
  • Servern accepterar OAuth-åtkomsttoken och API-nycklar för arbetsytan. Båda använder samma behörigheter, licenser, krediter och gränser.

Anslut ChatGPT och Claude

Lägg till en anpassad anslutning med ChatGPT: https://gradiently.design/api/mcp/chatgpt; Claude: https://gradiently.design/api/mcp och välj OAuth-inloggning. Logga in på Gradiently, välj en arbetsyta och granska behörigheterna. Bara ägare och administratörer kan ansluta en assistent.

Anslutningar löper ut efter en timme och förnyas automatiskt i upp till 30 dagar. Återkalla en anslutning i Inställningar › API och agenter för att stoppa åtkomst och förnyelse direkt.

En anpassad anslutning och en plats i den offentliga katalogen är olika saker. Publicering i katalogen kräver granskning och godkännande av OpenAI eller Anthropic.

Anslut Claude Code

Lägg till Gradiently som fjärrserver över HTTP, med din nyckel i huvudet. Förvara nyckeln i en miljövariabel så att den aldrig hamnar i skalets historik eller i en incheckad fil.

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"

Starta en ny session i Claude Code och be den lista Gradientlys verktyg för att kontrollera anslutningen. Om den rapporterar ett autentiseringsfel är nyckeln felskriven eller återkallad, eller så är skaparen inte längre ägare eller admin i arbetsytan.

Andra klienter

Alla klienter som kan lägga till en fjärransluten MCP-server över Streamable HTTP och skicka ett eget huvud i förfrågan kan använda Gradiently med samma URL och huvud. Om din klient kan det beror på klienten och dess version.

  • Klienter som konfigureras med en JSON-fil accepterar ofta formatet nedan, som också visas i Inställningar under Anslut en MCP-klient. Se klientens dokumentation för exakt format.
json
{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer gr_live_…" }
    }
  }
}

Tillåt långa verktygsanrop

De flesta verktyg svarar på några sekunder. render_design, inspect_design och export_mark kan ta upp till tre minuter, design upp till ungefär fem och create_designs med wait upp till ungefär fyra. Om din klient har en inställning för tidsgräns för verktyg, höj den så att den räcker.

Så beter sig verktygen

  • Verktygen returnerar JSON-text. inspect_design returnerar även en PNG-bild. Vid fel returneras ett felmeddelande.
  • Verktyg som behöver ett varumärke tar en valfri personality (dess id eller slug). Utan den använder de arbetsytans första varumärke.
  • Verktyg som sparar en design returnerar dess länk till Studion, designens adress /studio/<id> på gradiently.design.
  • Flera verktyg slår först upp dina varumärken via /api/me, som kräver både workspaces:read och designs:read. De verktygen listar båda behörigheterna nedan.
  • Ett verktygsanrop räknas mot nyckelns hastighetsgräns en gång för MCP-förfrågan och en gång för varje API-förfrågan som verktyget gör.

Behörigheterna att ge en assistent

En nyckel som skapas i Inställningar börjar med designs:read, designs:write, marks:read, brand:generate och workspaces:read: tillräckligt för alla designverktyg. Lägg till marks:claim för att säkra Marks, personalities:write för att skapa varumärken eller ändra deras Mark och profil, och members:write för att skicka inbjudningar.

Marks

search_marks

Vad det gör

Söker på den offentliga Marknaden efter namn eller kod. Returnerar färger, material, status och innehavare.

Indata

q, tone (dark eller light), limit (1 till 120, standard 24), alla valfria

Behörigheter

marks:read
get_mark

Vad det gör

En Mark och hela dess recept.

Indata

code (en kod eller ett id)

Behörigheter

marks:read
list_marks

Vad det gör

Marks som innehas för den här arbetsytan, med licensstatus, och dina utkast i den.

Indata

inga

Behörigheter

marks:read
claim_mark

Vad det gör

Säkrar en ledig Mark. Nyckelns skapare innehar den, aldrig arbetsytan.

Indata

code

Behörigheter

marks:read, marks:claim
export_mark

Vad det gör

Renderar en Mark för sig som PNG, upp till 4096 px per sida.

Indata

mark, width, height, personality

Behörigheter

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

Vad det gör

Återställer en version som utkast. Det nuvarande läget sparas först som en version.

Indata

mark, version

Behörigheter

brand:generate
update_mark_version

Vad det gör

Byter namn på eller stjärnmärker en version. Stjärnmärkta versioner behålls.

Indata

mark, version, label, starred

Behörigheter

brand:generate
delete_mark_version

Vad det gör

Raderar en version, aldrig den publicerade.

Indata

mark, version

Behörigheter

brand:generate
VerktygVad det görIndataBehörigheter
search_marksSöker på den offentliga Marknaden efter namn eller kod. Returnerar färger, material, status och innehavare.q, tone (dark eller light), limit (1 till 120, standard 24), alla valfriamarks:read
get_markEn Mark och hela dess recept.code (en kod eller ett id)marks:read
list_marksMarks som innehas för den här arbetsytan, med licensstatus, och dina utkast i den.ingamarks:read
claim_markSäkrar en ledig Mark. Nyckelns skapare innehar den, aldrig arbetsytan.codemarks:read, marks:claim
export_markRenderar en Mark för sig som PNG, upp till 4096 px per sida.mark, width, height, personalityworkspaces:read, designs:read, designs:write
restore_mark_versionÅterställer en version som utkast. Det nuvarande läget sparas först som en version.mark, versionbrand:generate
update_mark_versionByter namn på eller stjärnmärker en version. Stjärnmärkta versioner behålls.mark, version, label, starredbrand:generate
delete_mark_versionRaderar en version, aldrig den publicerade.mark, versionbrand:generate

En säkring som kräver betalning misslyckas med ett meddelande om att den behöver gå via kassan; slutför den i Gradiently. En nyckel kan inte betala för något.

Varumärken och arbetsyta

list_personalities

Vad det gör

Arbetsytans varumärken, med deras id.

Indata

inga

Behörigheter

workspaces:read, designs:read
create_personality

Vad det gör

Skapar ett namngivet varumärke.

Indata

name

Behörigheter

personalities:write
get_brand_profile

Vad det gör

Vad ett varumärke är, vem det är till för, dess ton, vad man gör och inte gör, och typsnitt.

Indata

personality

Behörigheter

workspaces:read, designs:read
update_brand_profile

Vad det gör

Ersätter ett varumärkes profil. Designer läser den före varje design.

Indata

personality, profile

Behörigheter

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

Vad det gör

Du, arbetsytans varumärken med deras Mark-koder, och de Marks som innehas för den.

Indata

inga

Behörigheter

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

Vad det gör

Nyckelns arbetsyta och din roll i den.

Indata

cursor

Behörigheter

workspaces:read
invite_member

Vad det gör

Mejlar en inbjudan att gå med i arbetsytan som gäller i sju dagar.

Indata

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

Behörigheter

members:write
VerktygVad det görIndataBehörigheter
list_personalitiesArbetsytans varumärken, med deras id.ingaworkspaces:read, designs:read
create_personalitySkapar ett namngivet varumärke.namepersonalities:write
get_brand_profileVad ett varumärke är, vem det är till för, dess ton, vad man gör och inte gör, och typsnitt.personalityworkspaces:read, designs:read
update_brand_profileErsätter ett varumärkes profil. Designer läser den före varje design.personality, profileworkspaces:read, designs:read, personalities:write
my_workspaceDu, arbetsytans varumärken med deras Mark-koder, och de Marks som innehas för den.ingaworkspaces:read, designs:read, marks:read
list_workspacesNyckelns arbetsyta och din roll i den.cursorworkspaces:read
invite_memberMejlar en inbjudan att gå med i arbetsytan som gäller i sju dagar.workspaceId, email, role (admin, editor eller viewer)members:write

tone tar upp till tre av calm, bold, warm, cool, playful, luxe, natural, technical, editorial och nocturnal; en förfrågan med fler avvisas. colours tar upp till åtta hexfärger och count ber om ett till åtta förslag; fler än så avvisas också. För att anta ett förslag skickar du exakt samma indata som genererade det, tillsammans med förslagets key: servern skapar förslaget på nytt från den indatan och litar aldrig på ett recept som klienten skickar.

Designa

Be din anslutna AI läsa varumärkesprofilen och get_design_guidance, skapa med draw_design, granska den riktiga bilden med inspect_design och förfina med edit_design. Direkt ritning, redigering och granskning använder inga Gradiently AI-krediter. Din leverantörs användningsgränser samt konto- och exportbehörigheter gäller fortfarande. En ritning kan innehålla värdens egna vektorillustrationer, rensad SVG, riktiga diagram, grafik från biblioteket och licensierade foton; allt går fortfarande att redigera i Studio. Fotosökning och fotoimport hämtar från Openverse, en extern katalog.

get_design_guidance

Vad det gör

Granskad, skriven art direction: kvalitetsnivån, ritmöjligheterna, konceptmetoden och granskningsloopen, med fördjupningar som illustration, data och typografi. Inte mallar eller modellträning.

Indata

purpose, topic

Behörigheter

valfri nyckel
draw_design

Vad det gör

Ritar en originaldesign som går att redigera med din anslutna AI: text, former, egna vektorillustrationer, SVG, riktiga diagram, grafik, foton, Mark-fönster och tabeller. Bara den valda sidan ritas om.

Indata

drawing, personality, mark, designId, page, title

Behörigheter

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

Vad det gör

Returnerar en riktig PNG-bild som assistenten kan granska och förbättra. Mindre storlekar är hela sidan nedskalad, så som ett flöde visar den.

Indata

id, page, maxDimension

Behörigheter

designs:read
find_icons

Vad det gör

Hittar giltiga namn på inbyggda ikoner.

Indata

query, limit

Behörigheter

valfri nyckel
find_graphics

Vad det gör

Hittar Gradientlys egen grafik, som går att färga om, att använda som stödjande detaljer.

Indata

query, limit

Behörigheter

valfri nyckel
find_photos

Vad det gör

Söker bland licensierade foton på Openverse och returnerar miniatyrer som assistenten kan titta på. Säger till när en miniatyr inte är tillgänglig. Inget sparas.

Indata

query, count

Behörigheter

designs:read
import_photo

Vad det gör

Kopierar ett valt foto till arbetsytans uppladdningar med upphovsuppgift, inom din uppladdningskvot.

Indata

id

Behörigheter

designs:write
designBer Gradientlys egen Designer att skapa en design, eller ändra en, utifrån en vanlig förfrågan. Den läser varumärkets profil och Mark, designar, granskar och sparar. Använder Gradiently AI-krediter.

Indata

request, personality, size, designId, scope, selection

Behörigheter

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

Vad det gör

Skapar en uppsättning på upp till tolv designer från en brief, i bakgrunden. Använder Gradiently AI-krediter.

Indata

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

Behörigheter

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

Vad det gör

En uppsättnings förlopp och varje designs länk till Studion när den finns.

Indata

id

Behörigheter

designs:read
stop_design_set

Vad det gör

Stoppar en pågående uppsättning. Designer som redan har ritats förblir sparade.

Indata

id

Behörigheter

designs:write
compose_design

Vad det gör

Lägger ut din text med layoutmotorn och sparar. Returnerar granskningsproblem att åtgärda.

Indata

composition, personality, designId, title

Behörigheter

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

Vad det gör

Alla förinställda storlekar, med storleken i pixlar.

Indata

inga

Behörigheter

valfri nyckel
create_design

Vad det gör

Skapar en design från en grundform (tom som standard), en förinställd storlek och text kopplad till element-id.

Indata

form, size, copy, look, personality

Behörigheter

workspaces:read, designs:read, designs:write
VerktygVad det görIndataBehörigheter
get_design_guidanceGranskad, skriven art direction: kvalitetsnivån, ritmöjligheterna, konceptmetoden och granskningsloopen, med fördjupningar som illustration, data och typografi. Inte mallar eller modellträning.purpose, topicvalfri nyckel
draw_designRitar en originaldesign som går att redigera med din anslutna AI: text, former, egna vektorillustrationer, SVG, riktiga diagram, grafik, foton, Mark-fönster och tabeller. Bara den valda sidan ritas om.drawing, personality, mark, designId, page, titledesigns:write, workspaces:read, designs:read, marks:read
inspect_designReturnerar en riktig PNG-bild som assistenten kan granska och förbättra. Mindre storlekar är hela sidan nedskalad, så som ett flöde visar den.id, page, maxDimensiondesigns:read
find_iconsHittar giltiga namn på inbyggda ikoner.query, limitvalfri nyckel
find_graphicsHittar Gradientlys egen grafik, som går att färga om, att använda som stödjande detaljer.query, limitvalfri nyckel
find_photosSöker bland licensierade foton på Openverse och returnerar miniatyrer som assistenten kan titta på. Säger till när en miniatyr inte är tillgänglig. Inget sparas.query, countdesigns:read
import_photoKopierar ett valt foto till arbetsytans uppladdningar med upphovsuppgift, inom din uppladdningskvot.iddesigns:write
designBer Gradientlys egen Designer att skapa en design, eller ändra en, utifrån en vanlig förfrågan. Den läser varumärkets profil och Mark, designar, granskar och sparar. Använder Gradiently AI-krediter.request, personality, size, designId, scope, selectionworkspaces:read, designs:read, designs:write
create_designsSkapar en uppsättning på upp till tolv designer från en brief, i bakgrunden. Använder Gradiently AI-krediter.brief, items (size, brief, title), title, personality, mark, waitworkspaces:read, designs:read, designs:write
get_design_setEn uppsättnings förlopp och varje designs länk till Studion när den finns.iddesigns:read
stop_design_setStoppar en pågående uppsättning. Designer som redan har ritats förblir sparade.iddesigns:write
compose_designLägger ut din text med layoutmotorn och sparar. Returnerar granskningsproblem att åtgärda.composition, personality, designId, titleworkspaces:read, designs:read, designs:write
list_sizesAlla förinställda storlekar, med storleken i pixlar.ingavalfri nyckel
create_designSkapar en design från en grundform (tom som standard), en förinställd storlek och text kopplad till element-id.form, size, copy, look, personalityworkspaces:read, designs:read, designs:write

design och create_designs förbrukar arbetsytans AI-krediter, precis som Designer i Studion. När saldot är för lågt misslyckas de med ett meddelande om det; fyll på under Inställningar › AI-krediter. Högst två uppsättningar körs samtidigt per person, och en färdig uppsättning går att läsa i ungefär tjugo minuter. Själva designerna finns kvar.

En komposition anger en size (ett id för en förinställd storlek som ig-post, x-post eller li-banner, eller {w, h} i pixlar), en layout (statement, editorial, poster, split, stat, quote, list, event eller minimal) och blocks i läsordning, var och en med en role som headline, body eller cta och 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" }
    ]
  }
}
Indata för compose_design. Svaret innehåller designens id, dess länk till Studion, granskningsproblem och de element den placerade.

Redigera och exportera

list_designs

Vad det gör

Ett varumärkes sparade designer med länkar till Studion.

Indata

personality

Behörigheter

workspaces:read, designs:read
get_design

Vad det gör

En designs storlek, sidor och varje element med dess egenskaper. Filtrera långa designer efter sida, typ, namn eller text.

Indata

id, page, kind, name, text

Behörigheter

designs:read
edit_design

Vad det gör

Ändrar en design med upp till 100 operationer, som en person skulle göra i Studion, och sparar den.

Indata

id, ops, page

Behörigheter

designs:write
update_design_text

Vad det gör

Ersätter orden i valda textelement och behåller layouten.

Indata

id, text (element-id till ord)

Behörigheter

designs:read, designs:write
resize_copies

Vad det gör

Sparar kopior i upp till åtta andra storlekar, omflödade som i Studion. Originalet ändras inte.

Indata

id, sizes

Behörigheter

designs:read, designs:write
wear_mark

Vad det gör

Lägger en Mark på en design, eller gör den till ett varumärkes Mark för nya designer.

Indata

mark, och design eller personality

Behörigheter

se nedan
render_design

Vad det gör

Renderar en sparad design till PNG eller PDF med Studions motor. Returnerar filen som base64.

Indata

id, width, height, format, page

Behörigheter

designs:read
export_design_link

Vad det gör

Publicerar en visningslänk, /d/<id>, som alla som har den kan öppna.

Indata

id

Behörigheter

designs:write
VerktygVad det görIndataBehörigheter
list_designsEtt varumärkes sparade designer med länkar till Studion.personalityworkspaces:read, designs:read
get_designEn designs storlek, sidor och varje element med dess egenskaper. Filtrera långa designer efter sida, typ, namn eller text.id, page, kind, name, textdesigns:read
edit_designÄndrar en design med upp till 100 operationer, som en person skulle göra i Studion, och sparar den.id, ops, pagedesigns:write
update_design_textErsätter orden i valda textelement och behåller layouten.id, text (element-id till ord)designs:read, designs:write
resize_copiesSparar kopior i upp till åtta andra storlekar, omflödade som i Studion. Originalet ändras inte.id, sizesdesigns:read, designs:write
wear_markLägger en Mark på en design, eller gör den till ett varumärkes Mark för nya designer.mark, och design eller personalityse nedan
render_designRenderar en sparad design till PNG eller PDF med Studions motor. Returnerar filen som base64.id, width, height, format, pagedesigns:read
export_design_linkPublicerar en visningslänk, /d/<id>, som alla som har den kan öppna.iddesigns:write

wear_mark på en design kräver designs:read och designs:write. För att göra en Mark till ett varumärkes Mark krävs workspaces:read, designs:read och personalities:write, och en Mark som du innehar med en aktiv licens. Om du anger Marken med dess kod krävs också marks:read.

render_design tar width och height från 1 till 4096 pixlar och format png eller pdf. page räknas från 0: PNG renderar som standard första sidan och PDF alla sidor. En PDF behåller varje sida i dess storlek i Studion, så storleken du begär måste stämma. Rendering kräver samma exportlicens för designens Mark som i Studion, och den publicerar eller ändrar aldrig designen.

Video, ljud och undertexter

Använd find_uploads för att hitta tillåtna källreferenser och sedan 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. Gissa aldrig källans längd. Videodelningar och elementtider använder sekunder inom sidan; ljudstarter, ljuddelningar och undertexter använder sekunder i hela dokumentet. Ljud förlänger inte scenerna. Undertexter tar emot angiven text med tider eller SRT/WebVTT-innehåll; automatisk transkribering är inte tillgänglig. get_design visar hela tidslinjen och spåren. export_captions returnerar SRT/WebVTT-filinnehåll i delar med högst 100 undertexter och 48 000 tecken; använd nextOffset för nästa del.

Exempel på uppmaningar

  • ”Hitta mörka Marks på Marknaden med krom i och visa mig de tre som ligger närmast djup petrol.” Använder search_marks.
  • ”Ändra rubriken på design 4f1c… till ’Dörrarna öppnar klockan sju’ och gör kopior för en Instagram-story och ett inlägg på X.” Använder get_design, update_design_text och resize_copies.
  • ”Rendera design 4f1c… som en PNG på 1080 gånger 1350 och spara den som launch.png.” Använder render_design.
  • ”Gör en affisch för vår solståndsfest på taket, 21 juni, från solnedgång till soluppgång.” Använder design, som kräver workspaces:read.

Hela referensen för slutpunkterna bakom de här verktygen finns i API-referens. För allt annat, skicka en förfrågan.

Behöver du hjälp?

Skicka en förfrågan med ämnet API och MCP, så svarar en människa.

Skicka en förfrågan

Hitta looken som bara är din.

Varje Mark är en levande bakgrund med en enda ägare. Prova en ledig Mark och säkra din när det känns rätt.

Börja designaSe lanseringserbjudandet

Marks kvar att säkra

50av 1 000

950 säkrade hittillsHitta din

Kontrollera ett certifikat

Skriv ett certifikatnummer eller en Marks kod för att se vem som äger den.

Fungerar med ChatGPT och Claude

Be din AI om en design. Den skapar den i din Mark, redo att redigera.

ChatGPTClaude
Så ansluter du

Produkt

  • Marknaden
  • Utforska
  • Priser
  • Lanseringspaket
  • Certifikat

Lär dig

  • Fältguiden
  • Hjälpcenter
  • Nyheter

Utvecklare

  • Översikt
  • ChatGPT och Claude
  • API-referens
  • API-nycklar

Företaget

  • Om oss
  • Kontakta oss
  • Logga in

Juridik

  • Villkor
  • Integritet
  • Återbetalningar
  • Mark-skydd
  • Cookies
  • Alla policyer
Rör dig över bokstäverna. Var och en bär en riktig Mark.Tryck på en bokstav för att se dess Mark.Ett namn. Tio Marks inuti.
© 2026 Gradiently