Palvelin hyväksyy OAuth-käyttötokenit ja työtilan API-avaimet. Molempiin sovelletaan samoja oikeuksia, lisenssejä, krediittejä ja rajoja. Model Context Protocol on avoin standardi, jolla tekoälyavustajille annetaan työkaluja. Gradientlyllä on isännöity MCP-palvelin. ChatGPT yhdistää osoitteeseen https://, Claude ja muut asiakasohjelmat osoitteeseen https://. Yhdistä se kerran API-avaimella, niin avustajasi voi kutsua Gradientlyn työkaluja, kun keskustelet sen kanssa. Jokainen työkalu tekee samat API-pyynnöt kuin oma koodisi tekisi, joten sillä on samat oikeudet, lisenssit, krediitit ja rajat.
Ennen kuin yhdistät
- Luo avain kohdassa Asetukset › API ja agentit (katso API-avaimet ja oikeudet). Avain ratkaisee, missä työtilassa avustaja toimii ja mitkä työkalut toimivat.
- API-avainasiakas lähettää otsakkeen
Authorization: Bearer gr_live_…. ChatGPT ja Claude lähettävät OAuth-tokenin kirjautumisen jälkeen. - Palvelin käyttää Streamable HTTP -yhteyttä tilattomasti JSON-vastauksin. Se ei tarvitse istuntoa, eikä erillistä tapahtumavirtaa tarvitse avata.
- Palvelin hyväksyy OAuth-käyttötokenit ja työtilan API-avaimet. Molempiin sovelletaan samoja oikeuksia, lisenssejä, krediittejä ja rajoja.
Yhdistä ChatGPT ja Claude
Lisää mukautettu yhteys osoitteella ChatGPT: https://; Claude: https:// ja valitse OAuth-kirjautuminen. Kirjaudu Gradientlyyn, valitse työtila ja tarkista oikeudet. Vain omistajat ja ylläpitäjät voivat yhdistää avustajan.
Yhteydet vanhenevat tunnin kuluttua ja uusiutuvat automaattisesti enintään 30 päivän ajan. Peru yhteys kohdassa Asetukset › API ja agentit, niin käyttö ja uusiminen päättyvät heti.
Mukautettu yhteys ja julkisen hakemiston listaus ovat eri asioita. Hakemistossa julkaiseminen vaatii OpenAI:n tai Anthropicin tarkistuksen ja hyväksynnän.
Yhdistä Claude Code
Lisää Gradiently etäpalvelimeksi HTTP:n yli niin, että avaimesi on otsakkeessa. Pidä avain ympäristömuuttujassa, jotta se ei koskaan päädy komentohistoriaasi tai versionhallintaan tallennettuun tiedostoon.
# 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"Aloita uusi Claude Code -istunto ja pyydä sitä listaamaan Gradientlyn työkalut, niin näet, toimiiko yhteys. Jos se ilmoittaa tunnistautumisvirheestä, avain on kirjoitettu väärin tai kumottu, tai sen luoja ei ole enää työtilan omistaja tai ylläpitäjä.
Muut asiakasohjelmat
Mikä tahansa asiakasohjelma, joka voi lisätä etä-MCP-palvelimen Streamable HTTP:n yli ja lähettää mukautetun pyyntöotsakkeen, voi käyttää Gradientlyä samalla URL-osoitteella ja otsakkeella. Se, onnistuuko tämä omalla ohjelmallasi, riippuu ohjelmasta ja sen versiosta.
- JSON-tiedostolla määritettävät asiakasohjelmat hyväksyvät usein alla olevan muodon, joka näkyy myös Asetuksissa kohdassa Yhdistä MCP-asiakasohjelma. Tarkista ohjelmasi dokumentaatiosta sen tarkka muoto.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer gr_live_…" }
}
}
}Miten työkalut toimivat
- Työkalut palauttavat JSON-tekstiä.
inspect_designpalauttaa myös PNG-kuvan. Virhetilanteessa palautetaan virheilmoitus. - Brändiä tarvitsevat työkalut ottavat valinnaisen
personality-arvon (sen id:n tai slugin). Ilman sitä ne käyttävät työtilan ensimmäistä brändiä. - Designin tallentavat työkalut palauttavat sen Studio-linkin eli designin osoitteen
/sivustolla gradiently.design.studio/ <id> - Monet työkalut hakevat ensin brändisi osoitteesta
/, joka vaatii sekä oikeudenapi/ me workspaces:readettädesigns:read. Näiden työkalujen kohdalla alla luetellaan molemmat oikeudet. - Työkalukutsu kuluttaa avaimesi pyyntörajaa kerran MCP-pyynnöstä ja kerran jokaisesta työkalun tekemästä API-pyynnöstä.
Markit
search_marksMitä se tekee
Syötteet
q, tone (dark tai light), limit (vähintään 1, enintään 120, oletus 24), kaikki valinnaisiaOikeudet
marks:readget_markMitä se tekee
Syötteet
code (koodi tai id)Oikeudet
marks:readlist_marksMitä se tekee
Syötteet
Oikeudet
marks:readclaim_markMitä se tekee
Syötteet
codeOikeudet
marks:read, marks:claimexport_markMitä se tekee
Syötteet
mark, width, height, personalityOikeudet
workspaces:read, designs:read, designs:writerestore_mark_versionMitä se tekee
Syötteet
mark, versionOikeudet
brand:generateupdate_mark_versionMitä se tekee
Syötteet
mark, version, label, starredOikeudet
brand:generatedelete_mark_versionMitä se tekee
Syötteet
mark, versionOikeudet
brand:generateMaksua vaativa lunastus epäonnistuu viestillä, jonka mukaan se vaatii kassan; viimeistele se Gradientlyssä. Avain ei voi maksaa mitään.
Brändit ja työtila
list_personalitiesMitä se tekee
Syötteet
Oikeudet
workspaces:read, designs:readcreate_personalityMitä se tekee
Syötteet
nameOikeudet
personalities:writeget_brand_profileMitä se tekee
Syötteet
personalityOikeudet
workspaces:read, designs:readupdate_brand_profileMitä se tekee
Syötteet
personality, profileOikeudet
workspaces:read, designs:read, personalities:writemy_workspaceMitä se tekee
Syötteet
Oikeudet
workspaces:read, designs:read, marks:readlist_workspacesMitä se tekee
Syötteet
cursorOikeudet
workspaces:readinvite_memberMitä se tekee
Syötteet
workspaceId, email, role (admin, editor tai viewer)Oikeudet
members:writetone hyväksyy enintään kolme arvoista calm, bold, warm, cool, playful, luxe, natural, technical, editorial ja nocturnal; pyyntö, jossa niitä on enemmän, hylätään. colours hyväksyy enintään kahdeksan hex-väriä, ja count pyytää yhdestä kahdeksaan ehdotusta; myös näiden rajojen ylittävä pyyntö hylätään. Kun otat ehdotuksen käyttöön, lähetä täsmälleen sama syöte, josta se luotiin, ja ehdotuksen key: palvelin tekee ehdotuksen uudelleen tuosta syötteestä eikä koskaan luota asiakasohjelman lähettämään reseptiin.
Suunnittelu
Pyydä yhdistettyä tekoälyäsi lukemaan brändiprofiili ja get_design_guidance, luomaan design draw_design-työkalulla, tarkastamaan oikea kuva inspect_design-työkalulla ja viimeistelemään se edit_design-työkalulla. Suora piirtäminen, muokkaaminen ja tarkastaminen eivät käytä Gradientlyn tekoälykrediittejä. Palveluntarjoajasi käyttörajat sekä tilin ja viennin käyttöoikeudet ovat edelleen voimassa. Piirros voi sisältää isäntämallin omaa vektorikuvitusta, puhdistettua SVG:tä, aitoja kaavioita, kirjaston grafiikkaa ja lisensoituja valokuvia; kaikki pysyy muokattavana Studiossa. Valokuvahaku ja -tuonti käyttävät Openverseä, ulkoista luetteloa.
get_design_guidanceMitä se tekee
Syötteet
purpose, topicOikeudet
draw_designMitä se tekee
Syötteet
drawing, personality, mark, designId, page, titleOikeudet
designs:write, workspaces:read, designs:read, marks:readinspect_designMitä se tekee
Syötteet
id, page, maxDimensionOikeudet
designs:readfind_iconsMitä se tekee
Syötteet
query, limitOikeudet
find_graphicsMitä se tekee
Syötteet
query, limitOikeudet
find_photosMitä se tekee
Syötteet
query, countOikeudet
designs:readimport_photoMitä se tekee
Syötteet
idOikeudet
designs:writedesignPyytää Gradientlyn omaa Designeria tekemään designin tai muuttamaan sitä tavallisen pyynnön perusteella. Se lukee brändin profiilin ja Markin, suunnittelee, arvioi ja tallentaa. Käyttää Gradientlyn tekoälykrediittejä.Syötteet
request, personality, size, designId, scope, selectionOikeudet
workspaces:read, designs:read, designs:writecreate_designsMitä se tekee
Syötteet
brief, items (size, brief, title), title, personality, mark, waitOikeudet
workspaces:read, designs:read, designs:writeget_design_setMitä se tekee
Syötteet
idOikeudet
designs:readstop_design_setMitä se tekee
Syötteet
idOikeudet
designs:writecompose_designMitä se tekee
Syötteet
composition, personality, designId, titleOikeudet
workspaces:read, designs:read, designs:writelist_sizesMitä se tekee
Syötteet
Oikeudet
create_designMitä se tekee
Syötteet
form, size, copy, look, personalityOikeudet
workspaces:read, designs:read, designs:writedesign ja create_designs kuluttavat työtilan AI-krediittejä samoin kuin Designer Studiossa. Kun saldo on liian pieni, ne epäonnistuvat viestillä, joka kertoo siitä; lisää krediittejä kohdassa Asetukset › AI-krediitit. Kullakin henkilöllä voi olla käynnissä enintään kaksi sarjaa kerrallaan, ja valmis sarja on luettavissa noin kaksikymmentä minuuttia. Itse designit säilyvät.
Sommitelma nimeää koon size (esiasetuksen id, kuten ig-post, x-post tai li-banner, tai {w, h} pikseleinä), asettelun layout (statement, editorial, poster, split, stat, quote, list, event tai minimal) ja lukujärjestyksessä olevat lohkot blocks, joilla kullakin on role, kuten headline, body tai cta, sekä sen 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. Vastauksessa ovat designin id, sen Studio-linkki, arviointihuomiot ja sen sijoittamat elementit.Muokkaaminen ja vienti
list_designsMitä se tekee
Syötteet
personalityOikeudet
workspaces:read, designs:readget_designMitä se tekee
Syötteet
id, page, kind, name, textOikeudet
designs:readedit_designMitä se tekee
Syötteet
id, ops, pageOikeudet
designs:writeupdate_design_textMitä se tekee
Syötteet
id, text (elementin id ja sen sanat)Oikeudet
designs:read, designs:writeresize_copiesMitä se tekee
Syötteet
id, sizesOikeudet
designs:read, designs:writewear_markMitä se tekee
Syötteet
mark sekä design tai personalityOikeudet
render_designMitä se tekee
Syötteet
id, width, height, format, pageOikeudet
designs:readexport_design_linkMitä se tekee
/ d/ <id>, jonka kuka tahansa linkin saanut voi avata.Syötteet
idOikeudet
designs:writewear_mark designille vaatii oikeudet designs:read ja designs:write. Markin tekeminen brändin Markiksi vaatii oikeudet workspaces:read, designs:read ja personalities:write sekä Markin, joka on hallussasi voimassa olevalla lisenssillä. Jos nimeät Markin sen koodilla, tarvitaan myös marks:read.
render_design ottaa arvot width ja height 1:n ja 4096 pikselin väliltä sekä format-arvon png tai pdf. page lasketaan nollasta: PNG renderöi oletuksena ensimmäisen sivun ja PDF kaikki sivut. PDF säilyttää jokaisen sivun Studion koossa, joten pyytämäsi koon on vastattava sitä. Renderöinti vaatii designin Markille saman vientilisenssin kuin Studio, eikä se koskaan julkaise tai muuta designia.
Video, ääni ja tekstitykset
Etsi sallitut lähdeviittaukset työkalulla find_uploads ja käytä sitten edit_design-työkalua komennoilla add_video, update_video, split_video, add_audio, update_audio, split_audio, remove_audio, set_element_timing, set_captions tai remove_captions. Älä koskaan arvaa lähteen kestoa. Videon jakaminen ja elementtien ajoitus käyttävät sivun sekunteja; äänen aloitukset, äänen jakaminen ja tekstitykset käyttävät koko dokumentin sekunteja. Ääni ei pidennä kohtauksia. Tekstitykset hyväksyvät annetun tekstin aikoineen tai SRT/WebVTT-sisällön; automaattista litterointia ei ole saatavilla. get_design palauttaa koko aikajanan ja raidat. export_captions palauttaa SRT/WebVTT-tiedoston sisällön enintään 100 tekstityksen ja 48 000 merkin osissa; hae seuraava osa arvolla nextOffset.
Esimerkkikehotteita
- ”Etsi Markkinoilta tummia Markeja, joissa on kromia, ja näytä kolme lähimpänä syvää sinivihreää olevaa.” Käyttää työkalua
search_marks. - ”Vaihda designin 4f1c… otsikoksi ’Ovet aukeavat seitsemältä’ ja tee kopiot Instagram-tarinaa ja X-julkaisua varten.” Käyttää työkaluja
get_design,update_design_textjaresize_copies. - ”Renderöi design 4f1c… 1080 × 1350 -kokoiseksi PNG-kuvaksi ja tallenna se tiedostoon launch.png.” Käyttää työkalua
render_design. - ”Tee juliste kattoterassin juhannusjuhliimme 21. kesäkuuta, auringonlaskusta auringonnousuun.” Käyttää työkalua
design, joka vaatii oikeudenworkspaces:read.
Näiden työkalujen taustalla olevien päätepisteiden koko referenssi on sivulla API-referenssi. Kaikessa muussa lähetä meille pyyntö.