# Clauden liittimet: mitä ne ovat ja miten lisäät yhden

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

Liitin antaa Claudelle kädet: se voi etsiä tiedostojasi, lukea projektin tai tehdä suunnitelman oikeassa työkalussa pelkän ohjeistuksen sijaan. Näin ne toimivat ja näin lisäät yhden muutamassa minuutissa.

## The short version

- Clauden liittimet yhdistävät Clauden ulkopuolisiin palveluihin, joissa se voi hakea, lukea ja toimia keskustelun aikana.
- Liittimet perustuvat Model Context Protocoliin, avoimeen standardiin tekoälyavustajien yhdistämiseksi työkaluihin ja tietoon.
- Etäliittimet toimivat verkossa ja lisätään URL-osoitteella tai hakemistosta, kun taas paikalliset palvelimet toimivat omalla tietokoneellasi.
- Claude pyytää luvan ennen liittimen työkalujen käyttöä, ja voit sallia toiminnon kerran tai aina.
- Käytettävissä olevat liitintoiminnot riippuvat Claude-tilauksestasi ja organisaatiossa omistajan sallimista asetuksista.

**Clauden liittimet** yhdistävät Clauden ulkopuolisiin palveluihin, jotta se voi keskustelussa hakea niistä tietoa, lukea sitä ja tehdä toimintoja, kuten luoda asiakirjan tai suunnitelman. Jokainen liitin on MCP-palvelin: pieni verkkopalvelu, joka puhuu avointa Model Context Protocolia ja kertoo Claudelle tarjoamansa työkalut. Lisää liitin Clauden hakemistosta tai liitä mukautetun liittimen palvelinosoite asetuksiin. Kirjaudu sitten palveluun ja valitse, mitä Claude saa siellä tehdä.

## Miten liittimet toimivat

Kun liitin on käytössä, Claude saa listan sen työkaluista nimineen, kuvauksineen ja tarvittavine syötteineen. Kun pyyntösi sopii työkaluun, Claude täyttää syötteet ja pyytää luvan suorittamiseen. Palvelu tekee työn ja palauttaa tuloksen, jonka Claude lukee ja käyttää vastauksessaan. Määrittely ja esimerkkipalvelimia löytyvät osoitteesta [modelcontextprotocol.io](https://modelcontextprotocol.io), ja [mikä MCP on](https://gradiently.design/fi/guide/what-is-mcp) selittää ajatuksen selkokielellä.

| Tyyppi | Suorituspaikka | Lisääminen | Tavallinen käyttö |
| --- | --- | --- | --- |
| Hakemiston liitin | Palvelun palvelimilla | Valitse Clauden listalta ja kirjaudu | Suositut sovellukset ja tiedostosäilöt |
| Mukautettu etäliitin | Verkossa URL-osoitteessa | Liitä palvelimen URL asetuksiin | Mikä tahansa MCP-palvelimen tarjoava palvelu |
| Paikallinen palvelin | Omalla tietokoneellasi | Työpöytälaajennus tai asetustiedosto | Koneesi tiedostot ja sovellukset |
| Claude Code -palvelin | Paikallisesti tai etänä | `claude mcp add` päätteessä | Kehitys ja automaatio |

Neljä tapaa yhdistää Claude työkaluihin. Etäliittimiä on helpointa jakaa ja pitää ajan tasalla.

## Liittimen lisääminen hakemistosta

1. **Avaa liitinasetukset** Avaa Clauden verkko- tai työpöytäsovelluksen Settings ja etsi Connectors.
2. **Selaa hakemistoa** Valitse haluamasi palvelu. Jokainen listaus kertoo, mihin liitin pääsee käsiksi.
3. **Yhdistä ja kirjaudu** Claude vie sinut palveluun kirjautumaan ja hyväksymään käyttöoikeudet ja palauttaa sitten Claudeen.
4. **Ota käyttöön keskustelussa** Kytke liitin päälle keskustelun työkaluvalikosta. Jätä tarpeettomat liittimet pois käytöstä, jotta Claude valitsee pienemmästä työkalujoukosta.

## Mukautetun liittimen lisääminen

Mukautettu liitin on hakemistoon kuulumaton etä-MCP-palvelin, esimerkiksi pienemmän työkalun tai oman yrityksesi palvelin. Valitse Settings-asetusten Connectors-kohdasta mukautetun liittimen lisääminen, nimeä se ja liitä palvelimen URL. Jos palvelin vaatii kirjautumisen, Claude opastaa sen läpi. Team- ja Enterprise-tilauksissa omistajan pitää ehkä ensin lisätä tai sallia liitin organisaatiolle. Anthropic tarjoaa Clauden ohjekeskuksessa ajantasaiset vaiheet eri tilauksille. Tarkista ne, sillä valikot muuttuvat.

> **Osa palvelimista käyttää API-avaimia** Kaikki palvelimet eivät käytä selainkirjautumista. Osa odottaa API-avainta Authorization-otsakkeessa. Jos Claude-sovelluksen liitinlomakkeessa ei ole sille kenttää, käytä Claude Codea tai seuraa palvelun omaa asennusohjetta.

## MCP-palvelimen lisääminen Claude Codeen

Claude Code lisää palvelimet päätteestä ja osaa lähettää mukautetun otsakkeen. Se tekee siitä helpoimman reitin API-avaimia käyttäville palvelimille. Pidä avain ympäristömuuttujassa, jotta se ei päädy komentohistoriaan tai jaettuun tiedostoon.

```bash
# A remote server that signs in through the browser
claude mcp add --transport http example https://example.com/mcp

# A remote server that expects an API key
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

# Check what is connected
claude mcp list
```

Etäpalvelimien lisääminen Claude Codeen. Korvaa esimerkkiosoite haluamallasi palvelimella.

## Esimerkki: Claude tekee suunnitelmia

Suunnittelu näyttää, mitä liitin muuttaa. Yksin Claude voi ehdottaa otsikkoa ja kuvata asettelun. Gradientlyyn yhdistettynä se voi hakea Markeja, lukea brändisi ja luoda suunnitelmia, jotka avautuvat Studioon tarkistettaviksi ja vietäviksi. Työtilan omistaja tai ylläpitäjä luo rajatun API-avaimen Gradientlyn kohdassa Asetukset › API ja agentit ja valitsee tarkasti, mitä avustaja saa tehdä. [Kehittäjädokumentaatio](https://gradiently.design/fi/developers/mcp) kattaa käyttöönoton. Näin tehdyt suunnitelmat eivät kuluta Gradientlyn krediittejä.

Pystysuuntainen Instagram-tarina ilmoittaa perjantain pidemmästä aukiolosta keskiyöhön ja keittiön sulkemisesta yhdeltätoista

Tarina, jonka Claude teki yhdestä lauseesta suunnitteluliittimen avulla: oikea teksti, brändin Mark ja täsmällinen 1080×1920-kehys.

[Suunnittelu Claudella Gradientlyn kautta](https://gradiently.design/fi/guide/design-with-claude) käy läpi koko keskustelun yhdestä tarinasta kolmeen muotoon.

## Liittimien turvallinen käyttö

### Vältä

- Mukautettuja liittimiä lähteistä, joita et voi varmistaa
- ”Salli aina” -valintaa poistaville tai rahaa käyttäville toiminnoille
- Yhtä kaikki oikeudet sisältävää avainta kaikkialle jaettuna
- Kaikkien liittimien pitämistä käytössä joka keskustelussa

### Tee näin

- Käytä palvelun itsensä julkaisemia palvelimia
- Salli kerran, kunnes luotat työkalun toimintaan
- Luo kuhunkin käyttökohteeseen oma nimetty ja rajattu avain
- Ota käyttöön vain keskustelussa tarvittavat liittimet

Liitin voi lukea Clauden sille lähettämän tiedon ja toimia antamillasi käyttöoikeuksilla. Liittimen hakema sisältö, kuten verkkosivu tai jaettu tiedosto, voi sisältää myös ohjeita. Lue siis, mitä Claude aikoo tehdä seuraavaksi, äläkä hyväksy automaattisesti.

## Liittimen vianmääritys

| Oire | Todennäköinen syy | Kokeile |
| --- | --- | --- |
| Liitin lisätty, mutta työkaluja ei näy | Ei käytössä tässä keskustelussa | Kytke päälle työkaluvalikosta |
| Unauthorised- tai 401-virhe | Puuttuva tai peruttu avain tai kirjautuminen | Yhdistä uudelleen tai luo uusi avain |
| Claude ei käytä liitintä | Pyyntö ei vastaa työkalua | Nimeä viestissäsi palvelu ja haluamasi tulos |
| Mukautetun liittimen lisäysvalinta puuttuu | Tilaus tai organisaation asetukset | Kysy Claude-organisaation omistajalta tai tarkista ohjekeskus |

Neljä tavallista ongelmaa liittimen lisäämisessä.

ChatGPT:ssä on samanlainen järjestelmä, joka kuvataan artikkelissa [ChatGPT-sovellukset](https://gradiently.design/fi/guide/chatgpt-apps). [Tekoälyavustajan yhdistäminen](https://gradiently.design/fi/guide/connect-ai-assistant) käsittelee Gradientlyä useissa sovelluksissa, ja [MCP-palvelimet suunnittelijoille](https://gradiently.design/fi/guide/mcp-servers-for-designers) ehdottaa, millaisia palvelimia kannattaa yhdistää ensin.

## FAQ

### Mitä Clauden liittimet ovat?

Integraatioita, joiden avulla Claude voi hakea, lukea ja toimia ulkopuolisissa palveluissa keskustelun aikana. Jokainen on MCP-palvelin, joka tarjoaa Claudelle joukon työkaluja.

### Miten lisään mukautetun liittimen Claudeen?

Avaa Settings, siirry Connectors-kohtaan, valitse mukautetun liittimen lisääminen ja liitä etä-MCP-palvelimen URL. Kirjaudu pyydettäessä. Joissakin tilauksissa omistajan pitää sallia se ensin.

### Mitä eroa paikallisella ja etä-MCP-palvelimella on?

Paikallinen palvelin toimii tietokoneellasi ja pääsee tiedostoihisi ja sovelluksiisi. Etäpalvelin toimii verkossa URL-osoitteessa, joten se on käytettävissä mistä tahansa laitteesta.

### Voiko Claude tehdä suunnitelmia liittimellä?

Kyllä, jos suunnittelutyökalu tarjoaa MCP-palvelimen. Gradiently antaa Clauden luoda brändisi mukaisia suunnitelmia, jotka avautuvat Studioon muokattaviksi.