# Yhdistä tekoälyavustajasi

Simafri Suiten posti yhdistyy tekoälyavustajaasi **MCP<!-- -->:n** (Model Context Protocol) kautta. Se on avoin protokolla, jota Claude, ChatGPT ja johtavat avustajat puhuvat. Kun yhteys on muodostettu, avustajasi hoitaa postiasi puolestasi: se lukee, hakee, vastaa, kirjoittaa, järjestää ja ajastaa lähetyksesi, postilaatikoissasi ja sinun nimissäsi.

|                         |                                              |
| ----------------------- | -------------------------------------------- |
| **Postin MCP-palvelin** | `https://suite-mcp.simafri.com/mcp`          |
| **Siirtotapa**          | suoratoistettava HTTP (streamable HTTP)      |
| **Yhteys**              | Simafri Suite -tilisi (liitin) tai API-avain |

## Mitä avustajasi tekee sähköposteillasi

| Toiminto                          | Mitä avustaja tekee                                                                                             |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Lukeminen**                     | käy läpi postilaatikkosi ja niiden kansiot, lukemattomat viestit, kokonaisen ketjun liitteineen                 |
| **Liitteiden lukeminen**          | PDF-tiedoston, Word-asiakirjan, Excel-taulukon, esityksen tai zip-tiedoston tekstin; kuvat, joita se katsoo     |
| **Haku**                          | postilaatikosta aiheen, tekstin, kirjeenvaihtokumppanin tai liitetiedoston nimen perusteella                    |
| **Vastaaminen ja kirjoittaminen** | vastaa ketjussa lähettäjälle tai kaikille, kirjoittaa uuden viestin, kopioineen, piilokopioineen ja liitteineen |
| **Edelleenlähetys**               | lähettää viestin eteenpäin jollekulle toiselle, liitteet mukaan lukien                                          |
| **Ajastaminen**                   | asettaa viestin lähtöajan, luettelee ajastetut lähetykset ja peruu niistä yhden                                 |
| **Järjestäminen**                 | siirtää ketjun arkistoon, roskakoriin tai saapuneisiin, merkitsee sen luetuksi tai lukemattomaksi               |
| **Ei-toivotun postin lajittelu**  | ilmoittaa roskapostin ja estää sen lähettäjän, peruu uutiskirjeen tilauksen                                     |
| **Luonnokset**                    | tallentaa viestin myöhemmin viimeisteltäväksi, jatkaa sitä, poistaa sen                                         |
| **Allekirjoitus ja yhteystiedot** | asettaa osoitteen allekirjoituksen, katsoo ja ylläpitää osoitekirjaa                                            |
| **Postin nouto**                  | hakee postin heti                                                                                               |

Se, minkä avustajasi lähettää, lähtee osoitteistasi verkkotunnuksesi DKIM-allekirjoituksella ja tallentuu **Lähetettyihin**, täsmälleen kuten osoitteessa [suite.simafri.com](https://suite.simafri.com/) kirjoitettu viesti.

### Mitä voit pyytää siltä

* «Tiivistä `yhteys@`-laatikon lukemattomat viestit maanantaista lähtien ja kerro, mitkä odottavat vastausta.»
* «Vastaa Camillelle, että tarjous lähtee huomenna, liitä eilen saapunut PDF ja ajasta lähetys kello 8
  <!-- -->
  :ksi
  <!-- -->
  .»
* «Siirrä arkistoon kaikki tämän kuun toimitusilmoitukset.»
* «Etsi sopimus, jonka Julien lähetti minulle keväällä, ja kerro sen päättymispäivä.»
* «Peru tämän uutiskirjeen tilaus ja ilmoita kaksi viimeisintä roskapostia.»

## Yhdistäminen liittimellä

Tämä on yksinkertaisin tapa: ei mitään kopioitavaa, ei mitään liitettävää. Se palvelee avustajia, jotka lisäävät MCP-palvelimen sen osoitteella, kuten Clauden ja ChatGPT<!-- -->:n<!-- --> liittimet.

1. Lisää avustajassasi **mukautettu liitin** ja anna sille osoite `https://suite-mcp.simafri.com/mcp`.
2. Avustaja avaa osoitteen [suite.simafri.com](https://suite.simafri.com/): kirjaudu sisään tavalliseen tapaan postilaatikkosi osoitteella tai Simafri-tunnuksellasi.
3. Valtuutussivu näyttää sovelluksen, joka pyytää pääsyä: vahvista valtuutus.
4. Postisi työkalut ilmestyvät avustajaasi. Pyydä sitä esimerkiksi luettelemaan viimeisimmät viestisi.

Jokainen tiimin jäsen yhdistää oman avustajansa roolistaan riippumatta, ja tämä yhteys toimii hänen puolestaan.

## Yhdistäminen avaimella

Avustajassa, jonka otsakkeet asetat itse (Claude Code, Claude Desktop, yrityksesi MCP-asiakasohjelma), yhteys muodostetaan **API-avaimella**.

1. Tilin haltija avaa osoitteen [suite.simafri.com](https://suite.simafri.com/), **Asetukset**, **API-avaimet**, ja luo avaimen.
2. **Kopioi avain heti**: se näytetään vain kerran.
3. Lisää palvelin avustajaasi niin, että avain on `Authorization`-otsakkeessa. Claude Codessa:

```
claude mcp add --transport http --scope user simafri-suite https://suite-mcp.simafri.com/mcp --header "Authorization: Bearer AVAIMESI"
```

Avain toimii koko tilin puolesta: se palvelee yrityksen automaatiota, kuten ohjelmaa, joka lajittelee kaikkien postilaatikoiden postin. Yksittäisen henkilön avustajalle liitin on luonteva tie.

## Mihin avustajasi ulottuu

Liittimellä yhdistetty avustaja toimii **sinun oikeuksillasi**: se näkee sen, minkä näyttösi sinulle näyttää.

* **Postilaatikkosi**: ne, joita luet, oma laatikkosi ja sinulle uskotut jaetut postilaatikot, kuten `yhteys@`. Kukin postilaatikko avautuu sitä lukeville henkilöille ja heidän rinnallaan heidän avustajalleen.
* **Lähetyksesi**: ne lähtevät osoitteesta, jota luet.
* **Tilin asetukset** (kuka lukee mitäkin postilaatikkoa, kutsut, yhteinen hakemisto) seuraavat rooliasi, kuten näytöllä.
* **Luettu ja lukematon** pysyy omanasi: jaetussa postilaatikossa se, minkä avustajasi merkitsee luetuksi, on luettu vain sinulle.

## Yhteyden tarkastelu ja katkaiseminen

**Yhdistetyt sovellukset** -näyttö luettelee yhteytesi: avaa se tilisi valikosta osoitteen [suite.simafri.com](https://suite.simafri.com/) oikeasta yläkulmasta. Jokainen rivi kertoo sovelluksen, valtuutuksen päivämäärän ja sen, milloin sitä viimeksi käytettiin.

Sovelluksen yhteyden katkaiseminen sulkee sen yhteyden välittömästi ja kokonaan: avustajan pääsy päättyy samassa sekunnissa.

* Jokainen näkee ja katkaisee **valtuuttamansa yhteydet**.
* **Tilin haltija** näkee ja katkaisee **kaikki tilin yhteydet**, kunkin valtuuttaneen henkilön nimen kera. Kun työntekijä lähtee, yksi liike sulkee hänen avustajansa pääsyn.
* API-avain poistetaan kohdasta **Asetukset**, **API-avaimet**.

## Tilin MCP-palvelin: osoitteet, verkkotunnukset, tila

Toinen MCP-palvelin kantaa itse Simafri-**tiliä**, sitä mitä teet osoitteessa [my.simafri.com](https://my.simafri.com/). Se yhdistetään samalla tavalla, liittimellä, Simafri-tunnuksellasi:

|                        |                                  |
| ---------------------- | -------------------------------- |
| **Tilin MCP-palvelin** | `https://mcp.simafri.com/v1/mcp` |

Siellä tilin haltija antaa avustajansa hoidettavaksi Simafri Suiten ylläpidon:

* **osoitteet**: varannon ja osoitteiden tarkistaminen, osoitteen luominen salasanoineen, uuden salasanan antaminen, osoitteen sulkeminen. Kirjautumiskortti näytetään kerran, jotta tilin haltija voi antaa sen henkilölle;
* **verkkotunnukset**: postin toimituksen DNS-rivit, niiden tarkistus ja DMARCin siirto tiukempaan käytäntöön;
* **tila**: lisäyksen hinta-arvio ja sen jälkeen proforma, jonka tilin haltija maksaa tavalliseen tapaan.

Sama palvelin kantaa myös [Serenity-sivustosi](https://docs.simafri.com/fi/serenity/) ja VPS-palvelimesi. Yhdistä molemmat palvelimet samaan avustajaan: silloin se hoitaa sekä tiliäsi että postiasi.

## Apua tarvittaessa

Kirjoita osoitteeseen <support@simafri.com> ja kerro, mitä avustajaa käytät: autamme sinua yhdistämisessä.
