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://, och Claude och andra klienter till https://. 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://; Claude: https:// 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.
# 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.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer gr_live_…" }
}
}
}Så beter sig verktygen
- Verktygen returnerar JSON-text.
inspect_designreturnerar ä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
/på gradiently.design.studio/ <id> - Flera verktyg slår först upp dina varumärken via
/, som kräver bådeapi/ me workspaces:readochdesigns: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.
Marks
search_marksVad det gör
Indata
q, tone (dark eller light), limit (1 till 120, standard 24), alla valfriaBehörigheter
marks:readget_markVad det gör
Indata
code (en kod eller ett id)Behörigheter
marks:readlist_marksVad det gör
Indata
Behörigheter
marks:readclaim_markVad det gör
Indata
codeBehörigheter
marks:read, marks:claimexport_markVad det gör
Indata
mark, width, height, personalityBehörigheter
workspaces:read, designs:read, designs:writerestore_mark_versionVad det gör
Indata
mark, versionBehörigheter
brand:generateupdate_mark_versionVad det gör
Indata
mark, version, label, starredBehörigheter
brand:generatedelete_mark_versionVad det gör
Indata
mark, versionBehörigheter
brand:generateEn 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_personalitiesVad det gör
Indata
Behörigheter
workspaces:read, designs:readcreate_personalityVad det gör
Indata
nameBehörigheter
personalities:writeget_brand_profileVad det gör
Indata
personalityBehörigheter
workspaces:read, designs:readupdate_brand_profileVad det gör
Indata
personality, profileBehörigheter
workspaces:read, designs:read, personalities:writemy_workspaceVad det gör
Indata
Behörigheter
workspaces:read, designs:read, marks:readlist_workspacesVad det gör
Indata
cursorBehörigheter
workspaces:readinvite_memberVad det gör
Indata
workspaceId, email, role (admin, editor eller viewer)Behörigheter
members:writetone 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_guidanceVad det gör
Indata
purpose, topicBehörigheter
draw_designVad det gör
Indata
drawing, personality, mark, designId, page, titleBehörigheter
designs:write, workspaces:read, designs:read, marks:readinspect_designVad det gör
Indata
id, page, maxDimensionBehörigheter
designs:readfind_iconsVad det gör
Indata
query, limitBehörigheter
find_graphicsVad det gör
Indata
query, limitBehörigheter
find_photosVad det gör
Indata
query, countBehörigheter
designs:readimport_photoVad det gör
Indata
idBehörigheter
designs:writedesignBer 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, selectionBehörigheter
workspaces:read, designs:read, designs:writecreate_designsVad det gör
Indata
brief, items (size, brief, title), title, personality, mark, waitBehörigheter
workspaces:read, designs:read, designs:writeget_design_setVad det gör
Indata
idBehörigheter
designs:readstop_design_setVad det gör
Indata
idBehörigheter
designs:writecompose_designVad det gör
Indata
composition, personality, designId, titleBehörigheter
workspaces:read, designs:read, designs:writelist_sizesVad det gör
Indata
Behörigheter
create_designVad det gör
Indata
form, size, copy, look, personalityBehörigheter
workspaces:read, designs:read, designs:writedesign 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.
{
"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 innehåller designens id, dess länk till Studion, granskningsproblem och de element den placerade.Redigera och exportera
list_designsVad det gör
Indata
personalityBehörigheter
workspaces:read, designs:readget_designVad det gör
Indata
id, page, kind, name, textBehörigheter
designs:readedit_designVad det gör
Indata
id, ops, pageBehörigheter
designs:writeupdate_design_textVad det gör
Indata
id, text (element-id till ord)Behörigheter
designs:read, designs:writeresize_copiesVad det gör
Indata
id, sizesBehörigheter
designs:read, designs:writewear_markVad det gör
Indata
mark, och design eller personalityBehörigheter
render_designVad det gör
Indata
id, width, height, format, pageBehörigheter
designs:readexport_design_linkVad det gör
/ d/ <id>, som alla som har den kan öppna.Indata
idBehörigheter
designs:writewear_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_textochresize_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äverworkspaces:read.
Hela referensen för slutpunkterna bakom de här verktygen finns i API-referens. För allt annat, skicka en förfrågan.