# Gradientlyn Claude-yhdistin: suunnittelu MCP:n kautta

[Canonical HTML page](https://gradiently.design/fi/guide/design-with-claude-connector)

Claude voi hakea Markeja, lukea brändisi ja rakentaa oikeita muokattavia suunnitelmia työtilaasi. Reittejä on kaksi: kirjautuva yhdistin tai rajattu avain. Tämä sivu käsittelee molemmat.

## The short version

- Gradiently ylläpitää Claudelle MCP-palvelinta osoitteessa https://gradiently.design/api/mcp.
- Claude-sovelluksessa Gradiently lisätään mukautetuksi yhdistimeksi OAuth-kirjautumisella. Claude Codessa se lisätään rajatulla API-avaimella kohdasta Asetukset › API ja agentit.
- Uudessa API-avaimessa ovat aluksi jokaisen suunnittelutyökalun tarvitsemat oikeudet. Lunasta Markeja pysyy pois käytöstä, ellet valitse sitä.
- Kun Claude kokoaa suunnitelman Gradientlyn työkaluilla, Gradientlyn tekoälykrediittejä ei kulu ja jokainen tallennettu suunnitelma avautuu Studiossa.
- Avain toimii vain sen myöntäneessä työtilassa luojansa omistaja- tai ylläpitäjäroolilla. Sen voi kumota heti.

Määritä **Gradiently Claude** -yhdistin osoittamalla Claude Gradientlyn MCP-palvelimeen `https://gradiently.design/api/mcp`. Lisää Claude-sovelluksessa mukautettu yhdistin ja kirjaudu Gradientlyyn. Lisää Claude Codessa palvelin terminaalista rajatulla API-avaimella. Molemmilla tavoilla Claude voi hakea Markeja, lukea brändipakettisi ja tehdä työtilaasi tallentuvia suunnitelmia, jotka avautuvat Studiossa. Jokainen sana pysyy muokattavana.

MCP eli Model Context Protocol on avoin standardi, jonka avulla Claude käyttää oikeita työkaluja. [Mikä on MCP](https://gradiently.design/fi/guide/what-is-mcp) selittää sen yksinkertaisesti. Protokolla dokumentoidaan osoitteessa [modelcontextprotocol.io](https://modelcontextprotocol.io).

## Millä tavalla yhdistät Clauden

| Missä käytät Claudea | Yhteystapa | Kirjautuminen |
| --- | --- | --- |
| Claude-sovellus verkossa tai työpöydällä | Mukautettu yhdistin | OAuth: kirjaudu Gradientlyyn ja valitse työtila |
| Claude Code terminaalissa | Etä-MCP-palvelin HTTP:n kautta | Rajattu API-avain Authorization-otsakkeessa |
| Muut MCP-asiakasohjelmat | Etäpalvelin mukautetulla otsakkeella | Rajattu API-avain |

Sama palvelin, samat työkalut ja oikeudet. Vain Clauden tapa todistaa henkilöllisyys eroaa.

Kummallakin reitillä tarvitset Gradientlyn työtilan **omistajan tai ylläpitäjän** roolin. Muokkaajat ja katselijat eivät voi yhdistää avustajia tai luoda avaimia.

## Yhdistä Claude-sovellus mukautetulla yhdistimellä

1. **Avaa Clauden yhdistinasetukset** Lisää mukautettu yhdistin. Anthropic päättää, mitkä Claude-tilaukset sallivat tämän. Tarkista Clauden ohjesivut, jos vaihtoehto ei näy. [Claude-yhdistimet](https://gradiently.design/fi/guide/claude-connectors) selittää ominaisuuden.
2. **Liitä palvelimen osoite** Nimeä yhdistin Gradientlyksi ja käytä osoitetta `https://gradiently.design/api/mcp`. Valitse OAuth-kirjautuminen.
3. **Kirjaudu ja valitse työtila** Valitse Gradientlyn ikkunassa Clauden työtila ja lue oikeudet kohdasta **Salli tämän avustajan**.
4. **Salli ja tarkista** Valitse **Salli yhteys**. Pyydä sitten Claudea luettelemaan Gradiently-työkalunsa varmistaaksesi yhteyden.

Käyttöoikeus uusitaan automaattisesti enintään 30 päivää, minkä jälkeen yhdistät uudelleen. Mukautettu yhdistin on heti käytössäsi. Clauden julkinen hakemistolistaus on erillinen ja vaatii Anthropicin tarkistuksen.

## Yhdistä Claude Code rajatulla API-avaimella

Claude Code käyttää avainta kirjautumisen sijaan. Luo se Gradientlyssä kohdassa **Asetukset › API ja agentit**. Valitse työtila, nimeä avain käyttöpaikan mukaan, esimerkiksi *Claude Code, kannettava*, valitse sallitut toiminnot ja paina **Luo avain**. Avain näytetään kerran, joten kopioi se heti salasananhallintaan.

```bash
export GRADIENTLY_API_KEY="gr_live_…"

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"
```

Pidä avain ympäristömuuttujassa, jotta se ei päädy komentohistoriaan tai tallennettuun kooditiedostoon. Aloita uusi istunto ja pyydä Claudea luettelemaan Gradientlyn työkalut.

JSON-tiedostoa lukevat muut asiakasohjelmat hyväksyvät yleensä saman palvelimen ja otsakkeen. Asetuksissa on valmis esimerkki kohdassa **Yhdistä MCP-asiakasohjelma**.

```json
{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer gr_live_…" }
    }
  }
}
```

Monien MCP-asiakasohjelmien hyväksymä JSON-rakenne. Tarkista oman ohjelmasi tarkka muoto sen dokumentaatiosta.

## Avaimen oikeuksien valinta

Jokainen oikeus on käyttöoikeusalue. Uudella avaimella on aluksi viisi, jotka kattavat kaikki suunnittelutyökalut, joten useimpien ei tarvitse muuttaa mitään. Lisää muita vain Clauden tarvitessa niitä.

| Oikeus asetuksissa | Oletuksena käytössä | Mitä sallii |
| --- | --- | --- |
| Lue designeja | Kyllä | Lue brändejä, suunnitelmia ja latauksia sekä piirrä suunnitelmia |
| Luo ja muokkaa designeja | Kyllä | Luo, muuta ja muuta suunnitelmien kokoa, lataa kuvia ja käytä Designeria |
| Hae Markeja | Kyllä | Hae Markkinoilta ja lue julkisia Markeja |
| Lue työtilaa | Kyllä | Lue työtila ja sen jäsenet |
| Luo brändejä | Kyllä | Luo brändisuuntia nimen ja kuvauksen perusteella |
| Muokkaa brändejä | Ei | Muuta brändiprofiilia ja Markia sekä luo brändejä |
| Lunasta Markeja | Ei | Lunasta saatavilla oleva Mark avaimen luojalle |
| Kutsu jäseniä | Ei | Lähetä kutsuja työtilaan |

Anna vain työn tarvitsemat oikeudet. Avaimen oikeusalueita ei voi muuttaa myöhemmin, joten työn muuttuessa luo uusi avain.

## Mitä Claude voi tehdä yhdistettynä

Claude käyttää samoja toimintoja kuin sinä tuotteessa. Se voi hakea Markkinoilta nimellä, värisanoilla tai koodilla, lukea brändiprofiilin, äänensävyn ja fontit, piirtää alkuperäisen suunnitelman, katsoa kuvaa ja viimeistellä sitä. Se voi täyttää Gradientlyn pohjan, muuttaa tallennetun suunnitelman sanoja, tehdä eri kokoisia kopioita ja piirtää suunnitelman PNG- tai PDF-muotoon. Kun Claude kokoaa suunnitelman itse, Gradiently ei veloita **tekoälykrediittejä**. Gradientlyn omalle Designerille siirretty työ käyttää krediittejä kuten Studiossa.

Claude Code helpottaa tietynlaisia töitä. Jos pidät blogia ja haluat jokaiselle artikkelille linkkikuvan, pyydä: *”Tee jokaiselle /content-kansion artikkelille 1200×630-linkkikuva brändillämme ja artikkelin otsikolla. Piirrä jokainen PNG-tiedostoksi kansioon /public/og.”* Claude suunnittelee kuvat Gradientlyssä, tarkistaa ne ja kirjoittaa tiedostot sivuston odottamaan paikkaan. [Open Graph -kuvan koko](https://gradiently.design/fi/guide/open-graph-image-size) selittää koon 1200×630.

Leveä blogin linkkikuva kehitysartikkelin otsikolla liukuväritaustalla

1200×630-linkkikuva suunniteltu Gradientlyn MCP-palvelimella ja piirretty suoraan sivuston kansioon.

> **Salli pitkät työkalukutsut** Useimmat työkalut vastaavat sekunneissa. Suunnitelman piirtäminen ja tarkistaminen voi silti kestää kolme minuuttia ja Designerille annettu työ noin viisi. Nosta työkalun aikarajaa, jos asiakasohjelmassasi on sellainen asetus.

## Claudella toimivat kehotteet

- *”Lue brändiprofiilimme ja tee LinkedIn- sekä X-julkaisu uudesta toimistostamme Bristolissa.”*
- *”Etsi kolme tummaa Markia, joissa on Silkki-materiaali lähellä syvää petroolia, ja anna niiden koodit.”*
- *”Ota eilinen ilmoitus ja tee siitä tarina sekä YouTube-pikkukuva.”*
- *”Vaihda tapahtumajulisteen päiväksi 14. marraskuuta ja piirrä se PDF:nä.”*

Mitä parempi brändipakettisi on, sitä vähemmän jokaisessa pyynnössä tarvitsee sanoa. [Brändin ääni tekoälylle](https://gradiently.design/fi/guide/brand-kit-voice) näyttää täytettävät tiedot. Someideoita tarjoaa [Claude somesisältöön](https://gradiently.design/fi/guide/claude-social-media-posts), ja laajemman kuvan [suunnittelu Claudella](https://gradiently.design/fi/guide/design-with-claude).

## Yhteyden pitäminen turvallisena

### Avain voi

- Toimia vain sen myöntäneessä työtilassa
- Tehdä luojan roolin ja oikeusalueiden sallimat asiat
- Luoda työtilaan kuuluvia suunnitelmia
- Näyttää asetuksissa viimeisimmän käyttökerran

### Avain ei koskaan voi

- Päästä toiseen työtilaan, vaikka kuuluisit siihen
- Maksaa mitään tai päästä laskutukseen
- Siirtää, listata tai vapauttaa Markia
- Luoda tai hallita muita avaimia

Jos avain vuotaa tai lakkaat käyttämästä sitä, valitse sen vierestä **Kumoa** kohdassa **Asetukset › API ja agentit**. Se lakkaa toimimasta heti. Avaimet lakkaavat toimimasta myös, jos luoja poistuu työtilasta tai menettää ylläpitäjäroolin. Käytätkö myös ChatGPT:tä? [Gradiently ChatGPT:ssä](https://gradiently.design/fi/guide/design-with-chatgpt-app) käsittelee oman määrityksensä. Täysi työkalukuvaus on [kehittäjädokumentaatiossa](https://gradiently.design/fi/developers/mcp).

## FAQ

### Mikä on Gradientlyn MCP-palvelimen osoite Claudelle?

`https://gradiently.design/api/mcp`. Claude-sovelluksessa käytä sitä mukautettuna OAuth-yhdistimenä. Claude Codessa lisää API-avain Authorization-otsakkeeseen.

### Tarvitsenko API-avaimen Gradientlyn käyttöön Claudessa?

Et Claude-sovelluksessa, joka kirjautuu OAuthilla. Claude Code ja useimmat muut MCP-asiakasohjelmat tarvitsevat rajatun avaimen kohdasta Asetukset › API ja agentit.

### Kuluttaako Claude Gradientlyn tekoälykrediittejäni?

Ei kootessaan suunnitelmia itse Gradientlyn työkaluilla. Työn siirtäminen Gradientlyn omalle Designerille käyttää krediittejä.

### Voiko Claude lunastaa Markin puolestani?

Vain avaimella, jolla on Lunasta Markeja -oikeus. Se on oletuksena pois käytöstä. Maksua vaativa lunastus pitää silti viimeistellä Gradientlyssä.

### Miksi Claude sanoo, ettei todennus onnistu?

Avain on kirjoitettu väärin tai kumottu, tai sen luoja ei enää ole työtilan omistaja tai ylläpitäjä. Luo uusi avain ja päivitä asiakasohjelma.