Gradiently kehittäjille

Rakenna Gradientlyllä

Käytä API:a ja Gradientlyn MCP-palvelinta, niin koodisi tai tekoälyavustajasi voi hakea Markeja ja tehdä designeja, jotka aukeavat Studiossa.

Päivitetty 1. lokakuuta 2026

Gradientlyyn pääsee kahta reittiä. MCP-palvelimen avulla tekoälyavustaja, kuten Claude Code, voi käyttää Gradientlyn työkaluja, kun keskustelet sen kanssa. API:n avulla oma koodisi kutsuu samoja päätepisteitä suoraan. Molemmat tunnistautuvat yhteen työtilaan kuuluvalla API-avaimella, ja molemmat käyvät läpi samat tarkistukset kuin sovellus: työtilan roolit, Markien lisenssit, AI-krediitit ja pyyntörajat.

Mitä voit tehdä

  • Hae Markkinoilta ja lue minkä tahansa julkisen Markin koko resepti.
  • Luo brändiehdotuksia nimestä ja kuvauksesta ja ota yksi käyttöön: Mark-luonnos, brändi ja kolme aloitusdesignia yhdellä askeleella.
  • Tee designeja Gradientlyn oman Designerin tai asettelumoottorin avulla tai mallipohjasta, ja saat takaisin linkin, joka aukeaa Studiossa.
  • Muokkaa tallennettuja designeja elementti kerrallaan, vaihda niiden tekstit, tallenna kopioita muihin kokoihin ja vaihda niihin toinen Mark.
  • Renderöi tallennettu design PNG- tai PDF-tiedostoksi tai julkaise sille katselulinkki.
  • Tee Mark-reseptejä tavoitteen pohjalta Forgessa, tarkista niiden värit ja luettavuus ja säilytä luonnostesi versiot.

MCP vai API

MCP-palvelin

  • Tekoälyavustajille, jotka tukevat etä-MCP-palvelimia.
  • Yksi osoite: https://gradiently.design/api/mcp.
  • Työkalut löytävät brändisi, tallentavat designeja ja palauttavat Studio-linkit puolestasi.
  • Paras, kun haluat pyytää työtä tavallisin sanoin.

API

  • Skripteille, taustajärjestelmille ja automaatioille.
  • JSONia HTTPS:n yli osoitteen https://gradiently.design/api alla.
  • Valitset brändin, lähetät design-dokumentin ja käsittelet jokaisen vastauksen itse.
  • Paras, kun tarvitset tarkkaa ja toistettavaa hallintaa.

MCP-työkalut on rakennettu API:n päälle. Työkalukutsu tekee samat pyynnöt kuin koodisi tekisi, samalla avaimella, joten se kuluttaa samoja rajoja ja epäonnistuu samoin viestein.

Pika-aloitus

  1. 1

    Luo avain

    Avaa Gradientlyssä Asetukset › API ja agentit, valitse työtila, nimeä avain sen mukaan, missä käytät sitä, valitse, mitä se voi tehdä, ja valitse Luo avain. Kopioi avain, kun se tulee näkyviin: se näytetään vain kerran. Vain omistajat ja ylläpitäjät voivat luoda avaimia.

  2. 2

    Yhdistä avustajasi

    Lisää Gradiently Claude Codeen etä-MCP-palvelimeksi niin, että avaimesi on Authorization-otsakkeessa (komento on alla). Muut asiakasohjelmat käsitellään sivulla MCP ja tekoälyavustajat.

  3. 3

    Pyydä jotain

    Kokeile: ”Luo kolme brändisuuntaa pienelle Hearth-nimiselle leipomolle, rauhallinen ja lämmin, ja ota sitten ensimmäinen käyttöön.” Avustaja kutsuu työkaluja generate_brand ja adopt_brand, ja työtilaasi tulee uusi brändi omalla Mark-luonnoksellaan ja aloitusdesigneillaan.

bash
export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"
Säilytä avain ympäristömuuttujassa tai salaisuuksien hallinnassa, älä koskaan tiedostossa, jonka tallennat versionhallintaan.

Jos kutsut mieluummin API:a, lähetä sama otsake jokaisen pyynnön mukana:

bash
curl https://gradiently.design/api/marks?q=harbour \
  -H "Authorization: Bearer $GRADIENTLY_API_KEY"
Markkinoilta hakeminen vaatii avaimen, jolla on Hae Markeja -oikeus (marks:read).

Miten avain toimii

Avain toimii sen luoneen henkilön nimissä ja vain siinä yhdessä työtilassa, jota varten se luotiin. Se ei pääse koskaan muihin työtiloihin, ei edes sellaiseen, johon sen luoja kuuluu. Se toimii vain niin kauan kuin sen luoja on yhä työtilan omistaja tai ylläpitäjä ja hänen tilinsä on käytössä; jos hänet poistetaan, hänen roolinsa lasketaan tai hänen tilinsä poistetaan käytöstä, avain lakkaa toimimasta.

  • Avaimella tehdyt designit, brändit ja lataukset kuuluvat työtilalle täsmälleen kuin jos sen luoja olisi tehnyt ne sovelluksessa.
  • Avaimella lunastetut Markit ovat sen luojan hallussa, eivät koskaan työtilan, ja mahdollinen lisenssi pysyy hänellä.
  • Avaimella käynnistetty Designerin työ kuluttaa työtilan AI-krediittejä samoin kuin Designer Studiossa.
  • Avain ei voi hallita avaimia, muuttaa tiliä, päästä laskutukseen tai luovuttaa Markia. API-avaimet ja oikeudet luettelee, mitä se ei voi koskaan tehdä.

Muu dokumentaatio

  • MCP ja tekoälyavustajat: Claude Coden ja muiden asiakasohjelmien yhdistäminen, jokainen työkalu syötteineen ja oikeuksineen sekä esimerkkikehotteita.
  • API-referenssi: perus-URL, tunnistautuminen, jokainen päätepiste, jota avain voi kutsua, virheet, pyyntörajat ja sivutus.
  • API-avaimet ja oikeudet: avainten luominen, vaihtaminen ja kumoaminen, mitä kukin oikeus sallii ja miten avaimet pidetään turvassa.
  • Onko MCP sinulle uusi? Mikä on MCP selittää sen selkokielellä, ja modelcontextprotocol.io sisältää määrityksen.

Jäitkö jumiin, tai puuttuuko jotain, mitä tarvitset? Lähetä meille pyyntö, niin ihminen vastaa.

Tarvitsetko apua?

Lähetä meille pyyntö aiheella API ja MCP, niin ihminen vastaa.

Lähetä pyyntö