# Käyttöönotto

Näin otat Paytrail MCP:n käyttöön tekoälysovelluksessasi. Ohjelmointitaitoja ei tarvita.

Tarvitset:

- **MCP-yhteensopivan tekoälysovelluksen** — esim. Claude, ChatGPT, Gemini tai LibreChat
- **Paytrail-kauppiastunnukset** — samat, joilla kirjaudut kauppiaspaneeliin
- **MCP-käyttöoikeus** — aktivoidaan kauppiaspaneelissa kohdasta "Käyttäjät"

## Palvelimen lisääminen

Asennustapa vaihtelee sovelluksittain. Paytrail MCP:n tiedot ovat kaikissa samat:

| Asetus        | Arvo                                               |
| ------------- | -------------------------------------------------- |
| **URL**       | `https://mcp.paytrail.com/mcp`                     |
| **Transport** | Streamable HTTP                                    |
| **Auth**      | OAuth 2.0 — kirjautuminen tapahtuu automaattisesti |

### Mistä asetuksen löytää

Etsi sovelluksestasi kohta, josta voi lisätä MCP-palvelimen. Se voi näkyä nimellä:

- _MCP Servers_, _Integrations_, _Tools_ tai vastaava
- Joissain sovelluksissa asetus tehdään konfiguraatiotiedostoon (esim. JSON)

Syötä yllä oleva URL ja valitse yhteystavaksi Streamable HTTP (tai pelkkä HTTP, jos sovellus ei erota tyyppejä).

### Kirjautuminen

Kun käytät Paytrail MCP:n toimintoja ensimmäistä kertaa, tekoälysovellus pyytää avaamaan kirjautumisikkunan. Kirjaudu sisään samoilla tunnuksilla kuin Kauppiaspaneeliin.

Paytrail MCP hoitaa kirjautumisen omassa palvelussaan — tekoälysovellus ei koskaan näe salasanaasi.

## Kokeile

Kirjautumisen jälkeen assistentti näkee kauppasi. Kokeile esimerkiksi:

> "Näytä kauppani."

tai

> "Luo maksulinkki 150 euron tilaukselle, viite LASKU-0042, asiakkaan sähköposti tilaus@esimerkki.fi."

?> Kaikki käytettävissä olevat toiminnot on kuvattu [Teknisessä dokumentaatiossa](tekninen-viite.md).

## Ongelmatilanteet

Jos yhteys ei toimi, tarkista:

1. URL on kirjoitettu oikein: `https://mcp.paytrail.com/mcp`
2. Yhteystapana on Streamable HTTP (ei stdio tai SSE)
3. Olet käynnistänyt sovelluksen uudelleen asetusten muuttamisen jälkeen
4. Kirjaudut oikeilla Paytrail-tunnuksilla
5. Jos kirjautumisikkuna ei avaudu, tarkista selaimen ponnahdusikkunaestoasetukset
6. Kauppiaallasi on MCP-käyttöoikeus aktivoituna

## Henkilötietojen suoja ja rekisterinpitäjän vastuu

Asiakas vastaa itse MCP-rajapinnan kautta käsiteltävien henkilötietojen lainmukaisesta käsittelystä sekä tietosuojavaatimusten noudattamisesta omassa toiminnassaan. Asiakkaan tulee huolehtia siitä, että MCP-rajapinnan käyttö, henkilötietojen käsittely, säilytys ja mahdollinen luovutus toteutetaan soveltuvan lainsäädännön, kuten EU:n yleisen tietosuoja-asetuksen (GDPR), mukaisesti. Paytrail toimii MCP-rajapinnan teknisenä palveluntarjoajana eikä vastaa asiakkaan omien AI-agenttien, järjestelmien, prosessien tai käyttöoikeuksien tietoturvasta tai tietosuojan toteutuksesta.

<div class="footer-menu">
    <a href="#/ucp" class="prev">
        <span>Edellinen</span>
        UCP
    </a>
    <a href="#/tekninen-viite" class="next">
        <span>Seuraava</span>
        Tekninen dokumentaatio
    </a>
</div>
