Lyhyesti
- Gradiently ylläpitää isännöityä MCP-palvelinta osoitteessa https://gradiently.design/api/mcp, johon voi yhdistää minkä tahansa MCP-asiakkaan, joka osaa lähettää Authorization-otsakkeen.
- Yhdistät API-avaimella, jonka työtilan omistaja tai ylläpitäjä luo Asetuksissa, kohdassa API ja agentit, ja joka lähetetään Bearer-tunnuksena.
- Jokainen avain kuuluu yhdelle työtilalle ja sisältää vain sen luonnissa rastitut oikeudet, kuten designien lukemisen tai Markien haun.
- Yhdistettynä avustaja voi hakea Markeja, lukea brändiprofiilisi, tehdä ja muokata suunnitelmia ja muuttaa niiden kokoa, ja jokainen suunnitelma avautuu studiossa.
- Avain näytetään kerran, sen voi peruuttaa milloin tahansa, eikä se koskaan siirrä Markin omistajuutta kenellekään muulle.
Tällä sivulla
Gradiently MCP -palvelimen käyttöön luot API-avaimen kohdassa Asetukset › API ja agentit ja lisäät sitten isännöidyn päätepisteen https://gradiently.design/api/mcp MCP-asiakkaaseesi otsakkeella Authorization: Bearer <avaimesi>. Siinä koko yhteys. Siitä lähtien avustaja, kuten Claude, voi hakea Markeja, lukea brändisi, tehdä suunnitelmia ja muuttaa niitä, ja jokainen tekemä suunnitelma avautuu studiossasi kuten mikä tahansa muu.
MCP eli Model Context Protocol on avoin standardi, jonka avulla tekoälyavustajat voivat käyttää oikeita työkaluja. Jos ajatus on uusi, mitä MCP on selittää sen selkeästi, ja protokollan oma sivusto modelcontextprotocol.io sisältää määrittelyn. Gradientlyn palvelimen täysi tekninen viite on kehittäjädokumenteissa.
Mitä tarvitset ennen aloittamista
- Gradiently-tili ja työtila, jonka omistaja tai ylläpitäjä olet. Vain omistajat ja ylläpitäjät voivat luoda tai peruuttaa avaimia.
- MCP-asiakas, joka osaa yhdistää etäpalvelimeen HTTP:n yli ja lähettää mukautetun
Authorization-otsakkeen. Claude Code osaa, ja monet työpöytä- ja editoriasiakkaat myös. - Turvallinen paikka avaimelle, kuten salasanahallinta tai asiakkaasi salaisuuksien tallennus. Se näytetään vain kerran.
Vaihe 1: luo rajattu API-avain
- 1
Avaa Asetukset › API ja agentit
Valitse työtila, jossa avustajan pitäisi työskennellä, yläreunan valitsimella. Avain toimii aina vain sen työtilan sisällä, joka sen antoi.
- 2
Nimeä se käyttöpaikan mukaan
”Claude Desktop” tai ”Markkinointiagentti”. Nimestä tiedät myöhemmin, minkä peruutat.
- 3
Rastita vain tarvittava
Oikeudet on lueteltu alla. Neljä on rastitettu oletuksena, Lunasta Markeja ei.
- 4
Luo, kopioi se heti
Avain ilmestyy kerran, kokonaisena. Kopioi se salasanahallintaan ennen ikkunan sulkemista. Sen jälkeen Asetukset näyttää vain sen ensimmäiset merkit, milloin sitä käytettiin viimeksi ja kuinka monta oikeutta sillä on.
| Oikeus | Mitä se antaa avustajan tehdä |
|---|---|
| Lue designeja | Listata ja avata työtilan suunnitelmia |
| Luo ja muokkaa designeja | Tehdä uusia suunnitelmia ja muuttaa niitä |
| Hae Markeja | Hakea Markeja Markkinoilta |
| Lunasta Markeja | Lunastaa Mark tälle työtilalle (oletuksena pois) |
| Luo brändejä | Tehdä brändiehdokkaita kuvauksesta |
Vaihe 2: lisää päätepiste asiakkaaseesi
Samalla sivulla on valmis pätkä kohdassa Yhdistä MCP-asiakasohjelma, kopiointipainikkeella. Asiakkaat, jotka lukevat JSON-määrityksen, ottavat sen sellaisenaan. Laita avaimesi kohtaan YOUR_KEY.
{
"mcpServers": {
"gradiently": {
"url": "https://gradiently.design/api/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}Claude Codessa lisää palvelin päätteestäsi. Pidä avain ympäristömuuttujassa sen sijaan, että kirjoittaisit sen komentohistoriaasi.
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
--header "Authorization: Bearer $GRADIENTLY_API_KEY"Muut avustajat, ChatGPT mukaan lukien, voivat yhdistää kaikkialla, missä niiden sovellus, tilaus ja työtilan asetukset sallivat mukautetun etä-MCP-palvelimen valtuutusotsakkeella. Tuki vaihtelee asiakkaiden välillä ja muuttuu ajan myötä, joten tarkista asiakkaasi omat ohjesivut. Brändin mukaisten suunnitelmien tekeminen ChatGPT:llä kertoo, mitä etsiä. Kun olet yhdistänyt, pyydä avustajaa listaamaan Gradiently-työkalunsa varmistaaksesi, että se toimi.
Mitä avustajasi osaa yhdistettynä
Palvelin tarjoaa samat toiminnot kuin tuotteessa, samojen oikeuksien kautta. Tehtävittäin ryhmiteltyinä ne näyttävät tältä:
| Tehtävä | Mitä avustaja voi tehdä |
|---|---|
| Löydä | Hakea Markeja nimellä, koodilla tai sävyllä, lukea Markin resepti, listata Markisi ja löytää pohjia, joista aloittaa |
| Suunnittele | Pyytää Gradientlyn omaa Designeria tekemään tai muuttamaan suunnitelman selkeästä pyynnöstä, tehdä suunnitelmasarjan yhdestä toimeksiannosta, aloittaa pohjasta, muokata tekstiä ja elementtejä |
| Muuta kokoa | Tallentaa suunnitelmasta kopioita muissa koissa alkuperäisen viereen, joka pysyy ennallaan |
| Brändi | Lukea ja päivittää brändin profiilia, luoda brändiehdokkaita ja ottaa käyttöön yksi Markin ja aloitussuunnitelmien kanssa |
| Markit | Takoa Mark-resepti kuvauksesta ja tallentaa se yksityiseksi luonnokseksi, laittaa Mark suunnitelmaan, lunastaa Mark, jos avain sen sallii |
| Jaa ja vie | Ottaa käyttöön vain katseltavan linkin suunnitelmalle tai piirtää se PNG:nä tai PDF:nä, kun Mark on lunastettu |
Selkeät pyynnöt toimivat parhaiten. Avustaja välittää ne Designerille, joka lukee brändiprofiilisi ja brändin Markin ennen kuin se sommittelee mitään. Kuten studiossa, Designerin työtä mitataan tekoälykrediiteillä.
Tällainen voi olla vastaus pyyntöön ”juliste kattojuhlallemme kesäpäivänseisauksena 21. kesäkuuta, auringonlaskusta auringonnousuun”: tallennettu suunnitelma brändisi Markilla, valmiina avattavaksi ja säädettäväksi.
- ”Tee kuusi julkaisua syksyn lanseeraukselle brändillämme, pystykuvina Instagramiin.”
- ”Ota eilinen ilmoitus ja tee siitä tarina ja X-otsikkokuva.”
- ”Löydä kolme tummaa Markia silkkimateriaalilla ja kerro niiden koodit.”
- ”Päivitä brändiprofiilimme: kuulostamme rauhallisilta ja täsmällisiltä, emme koskaan myyntipuheisilta.”
Perusteellisempaan läpikäyntiin Clauden kanssa katso suunnittelu Clauden kanssa Gradientlyn kautta. Jos haluat avustajan pysyvän brändin mukaisena, brändiohjeet, joita tekoälyavustajasi voi noudattaa näyttää, miten kirjoitat sen lukeman brändiprofiilin.
Yhteyden pitäminen turvallisena
Vältä
- Yksi avain kaikilla oikeuksilla, jaettuna jokaisen työkalun kesken
- Avaimen liittäminen keskusteluun, asiakirjaan tai tietovarastoon
- Avainten jättäminen työkaluille, joiden käytön olet lopettanut
- Lunasta Markeja -oikeuden rastittaminen agentille, joka vain suunnittelee
Tee näin
- Yksi avain asiakasta kohden, nimetty sen ajopaikan mukaan
- Sen tallennus salasanahallintaan tai salaisuuksien tallennukseen
- Käyttämättömien avainten peruutus Asetuksissa, ne lakkaavat heti
- Pienimmän toimivan oikeuksien joukon myöntäminen
Muutama takuu pätee asiakkaan tekemisistä riippumatta. Avain toimii vain sen työtilan sisällä, joka sen antoi. Se toimii samojen sääntöjen kautta kuin sen luonut henkilö, joten se ei voi tehdä mitään, mitä hänen roolinsa ei voi. Avain ei koskaan siirrä Markin omistajuutta työtilalle tai kenellekään muulle. Yksityiset suunnitelmat pysyvät yksityisinä: vain katseltava linkki syntyy vain, kun pyydät sellaisen. Ja jos avaimen luonut henkilö poistetaan työtilasta tai menettää ylläpitäjän roolinsa, myös hänen avaimensa lakkaavat toimimasta.
Usein kysyttyä
Mikä on Gradientlyn MCP-päätepiste?
Isännöity päätepiste on https://gradiently.design/api/mcp. Jokainen pyyntö tarvitsee otsakkeen Authorization: Bearer ja sen perään API-avaimen kohdasta Asetukset › API ja agentit.
Kuka voi luoda Gradientlyn API-avaimen?
Työtilan omistajat ja ylläpitäjät. Jokainen avain kuuluu tuolle yhdelle työtilalle ja sisältää vain sen luonnissa rastitut oikeudet.
Toimiiko se ChatGPT:n kanssa?
Se toimii minkä tahansa MCP-asiakkaan kanssa, joka osaa yhdistää etä-HTTP-palvelimeen ja lähettää valtuutusotsakkeen. Se, osaako ChatGPT, riippuu käyttämästäsi sovelluksesta, tilauksesta ja työtilan asetuksista, joten tarkista sen nykyiset ohjesivut.
Mitä tapahtuu, jos avaimeni vuotaa?
Peruuta se kohdassa Asetukset › API ja agentit. Kaikki sitä käyttävä lakkaa toimimasta heti, ja voit luoda uuden avaimen.
Voiko avustaja lunastaa Markeja puolestani?
Vain jos sen avaimella on Lunasta Markeja -oikeus, joka on oletuksena pois. Lunastaminen on ilmaista Gradientlyn julkaisun aikana.
Kirjoittanut Gradiently
Gradientlyn tiimi. Gradiently on Markien ympärille rakennettu suunnittelutyökalu: eläviä liukuvärejä, joiden ansiosta kaikki suunnittelemasi näyttää omaltasi.
Katso profiilimme
