---
title: "MCP: yhdistä Claude ja muut tekoälyavustajat mssgs:ään"
description: "Yhdistä Claude, Cursor ja muut tekoälytyökalut mssgs:ään MCP:n kautta. Paikallinen, oikeuksilla rajattu palvelin ja 127 työkalua: kanavat, viestit ja muuta."
canonical: https://docs.mss.gs/fi/mcp
language: fi
---

# Yhdistä tekoälyavustaja

mssgs-työpöytäsovelluksessa on sisäänrakennettu MCP-palvelin. Yhdistä Claude, Cursor tai Codex, niin ne voivat lukea, tiivistää ja vastata valitsemillasi kanavilla suoraan omalta tietokoneeltasi.

## Mitä voit tehdä

- **Lue ja tiivistä** Kanavat, yksityisviestit, maininnat ja kiinnitetyt viestit, vain avaamillasi kanavilla.

- **Kirjoita, kun sallit sen** Lähetä, vastaa, reagoi, muokkaa ja kiinnitä, kun kytket lähettämisen päälle.

- **Pelaa pelejä** Hyväksy kutsu, lue pelilauta ja tee oikeita siirtoja.

- **Pidä ohjat käsissäsi** Oletuksena pois päältä, aluksi vain luku, vain paikallisesti, peruttava token jokaiselle tekoälytyökalulle.

Sovelluksessa

Kysyt tekoälytyökalultasi; se lukee #general-kanavan MCP-palvelimen kautta ja julkaisee yhteenvedon sinun nimissäsi, koska sallit lähettämisen.

- [Yleiskatsaus](#overview)

- [Yhdistäminen](#connect)

- [Oikeudet ja tokenit](#permissions)

- [Reaaliaikaiset tapahtumat](#events)

- [Työkalut](#tools)

## Yleiskatsaus

mssgs:n työpöytäsovelluksessa on sisäänrakennettu **MCP-palvelin** (Model Context Protocol), joten Clauden tai Cursorin kaltaiset tekoälyavustajat voivat lukea työtilaasi ja toimia siinä. Se toimii paikallisesti koneellasi ja keskustelee kirjautuneen mssgs-istuntosi kanssa; erillistä bottitiliä tai palvelinta ei tarvita.

### Sinä päätät, mitä se näkee

Palvelin toimii vain osoitteessa localhost , kun mssgs on auki ja olet kirjautunut. Valitset, mitkä kanavat avaat, ja kytket ryhmä kerrallaan päälle sen, mitä avustaja saa tehdä. Tällä hetkellä työkaluja on **127**, jaettuna 14 ryhmään.

## Yhdistäminen

Tunnistautuminen tapahtuu Bearer-tokenilla, jonka saat sovelluksen [MCP-asetussivulta](https://mss.gs/fi/help/bots-mcp/connect-your-ai): ota palvelin käyttöön, valitse avattavat kanavat ja paina "Kopioi asetukset"; kopioidussa lohkossa ovat jo porttisi ja tokenisi. Palvelin kuuntelee vain localhostia (oletusportti 7444) ja on käynnissä, kun mssgs on auki ja olet kirjautunut.

```bash
claude mcp add --transport http mssgs http://127.0.0.1:7444/mcp \
  --header "Authorization: Bearer <your-token>"
```

Claude Desktopille tai Cursorille: liitä "Kopioi asetukset" -lohko tekoälytyökalusi MCP-asetuksiin. Katso [vaiheittainen opas](https://mss.gs/fi/help/bots-mcp/connect-your-ai) ohjekeskuksesta.

## Oikeudet ja tokenit

Avustajan näkemät työkalut riippuvat siitä, mitkä kytkimet otat käyttöön. Vain lukevat työkalut ovat aina päällä; kaikki muu on ryhmäkohtaisen kytkimen takana. Palvelinten hallinta ja moderointi tarkistavat lisäksi tilisi todelliset oikeudet.

| Ryhmä | Avaa käyttöön |
| --- | --- |
| **Lukeminen** | Aina päällä: viestien, läsnäolon, mainintojen ja kiinnitysten lukeminen avatuilla kanavilla |
| **Lähettäminen ja vuorovaikutus** | Lähettäminen, vastaaminen, reagointi, muokkaus, poisto, kiinnitys ja kirjoitusilmaisin sekä läsnäolo yksityisviesteissä, äänipuhelut ja pelit |
| **Yhteiskatselut** | Yhteisten katselukertojen aloittaminen, niihin liittyminen ja niiden ohjaaminen |
| **Viestipyynnöt** | Saapuvien viestipyyntöjen katselu, hyväksyminen ja hylkääminen |
| **Sosiaalinen** | Profiilit, tarinat ja karttasuodattimesi |
| **Äänikanavat** | Äänikanavalle liittyminen, osallistujien tarkastelu ja mikrofonin ohjaus |
| **Tili ja yksityisyys** | Kaverit, estot, mykistykset, luettu-tila, leikkeet ja sijainnin jakaminen |
| **Agenttien ohjaus** | Kanavien agenttien, projektien ja käynnissä olevien tehtävien määrittäminen |
| **Palvelinten hallinta** | Kanavat, kategoriat, oikeusryhmät, jäsenet, kutsut, emojit, webhookit ja liipaisimet (todelliset hallintaoikeudet tarkistetaan edelleen) |
| **Yhteisön moderointi** | Tarkastusjonot ja äänestäminen (vaatii edelleen moderaattorin tai henkilökunnan tilin) |
| **Tietokoneen pitäminen hereillä** | Estää konetta menemästä lepotilaan avustajan työskennellessä |
| **Bottitilin työkalut** | Interaktiiviset embed-kortit ja niiden tapahtumat (vain bottitilit) |

### Tokenit

Tokenit ovat nimettyjä, tekoälytyökalukohtaisia ja peruttavissa yhdellä napsautuksella, ja tokenikohtaisesta aktiivisuuskäyrästä näet tarkalleen, milloin kutakin käytettiin. Hyvä käytäntö: yksi token työkalua kohden, selkeästi nimettynä. Katosiko kannettava? Peru sen token, niin se on hyödytön.

## Reaaliaikaiset tapahtumat SSE:n kautta

Avaa MCP-päätepiste virtana ( GET /mcp otsakkeella Accept: text/event-stream ), niin saat JSON-RPC-ilmoitukset sitä mukaa kuin asioita tapahtuu:

| Ilmoitus | Laukeaa, kun |
| --- | --- |
| notifications/mssgs/message | Uudet viestit kanavilla, jotka näet |
| notifications/mssgs/bot_event | Painikkeiden painallukset, reaktiot ja vastaukset viesteihin, jotka avustajasi julkaisi send_bot_message-työkalulla |
| notifications/mssgs/presence | Läsnäolon muutokset |
| notifications/mssgs/typing | Kirjoitusilmaisimet |
| notifications/mssgs/call | Äänipuhelujen tapahtumat |

## Interaktiiviset bottikortit

### Interaktiiviset bottikortit avustajaltasi

Julkaise painikkeellinen embed-kortti send_bot_message -työkalulla, kuuntele bot_event -tapahtumia virrasta (tai kysele get_bot_events -työkalulla) ja päivitä kortti paikallaan edit_message -työkalulla. Sama korttimalli kuin [bottiviestien](https://docs.mss.gs/fi/bots) dokumentaatiossa.

## Työkaluviite (127)

Jokainen alla oleva työkalu on todellinen toiminto mssgs:ssä. Nimet ovat tarkat MCP-tunnisteet. Työkalut näkyvät vasta, kun niiden ryhmä on kytketty päälle.

### Lukeminen

Vain lukevat työkalut, käytettävissä heti kun palvelin on päällä. Ne näkevät vain avaamasi kanavat.

| Työkalu | Mitä se tekee |
| --- | --- |
| list_channels | Listaa kanavat, jotka olet avannut tekoälytyökaluille. |
| read_channel | Lue avatun kanavan viimeaikaiset viestit. |
| get_new_messages | Hae aikaleimaa uudemmat viestit kaikilta avatuilta kanavilta. |
| get_channel_stamp | Kanavan luettu/lukematon-tila sekä lukemattomien ja mainintojen määrät. |
| get_presence | Ketkä ovat paikalla kanavalla ja heidän tilansa. |
| get_message | Hae yksi kokonainen viesti tunnisteella, upotukset ja linkkien esikatselut mukaan lukien. |
| search_messages | Hae viestien tekstiä palvelimen avatuilta kanavilta. |
| get_message_context | Lue yhden hakutuloksen välittömästi ympäröivät viestit. |
| get_account | Näytä kirjautunut tili ja sen käytettävissä olevat toiminnot. |
| get_typing | Kuka kirjoittaa kanavalla juuri nyt. |
| list_mentions | Viimeaikaiset viestit, joissa sinut on @mainittu. |
| list_pinned_messages | Kanavan kiinnitetyt viestit. |
| subscribe_channel | Tilaa kanavan reaaliaikaiset päivitykset. |
| unsubscribe_channel | Lopeta kanavan reaaliaikaiset päivitykset. |
| list_subscriptions | Listaa kanavat, joiden reaaliaikaiset päivitykset olet tilannut. |

### Lähettäminen ja vuorovaikutus

Julkaise ja toimi kirjautuneena käyttäjänä. Kaikki täällä kirjoittaa kanavalle, joten se on yhden kytkimen takana.

| Työkalu | Mitä se tekee |
| --- | --- |
| send_message | Lähetä viesti kanavalle omissa nimissäsi. |
| reply_message | Vastaa tiettyyn viestiin ketjutettuna. |
| add_reaction | Lisää viestiin emojireaktio. |
| remove_reaction | Poista yksi emojireaktioistasi. |
| edit_message | Muokkaa yhtä omista viesteistäsi. |
| delete_message | Poista yksi omista viesteistäsi. |
| pin_message | Kiinnitä viesti (vaatii kiinnitysoikeuden). |
| unpin_message | Poista viestin kiinnitys. |
| open_one_view_attachment | Avaa kerran katsottava kuva tai video yksityisviestissä. |
| set_typing | Näytä reaaliaikainen "kirjoittaa…"-ilmaisin. |
| stop_typing | Poista kirjoitusilmaisin. |

### Läsnäolo ja puhelut yksityisviesteissä

Ole paikalla yksityisviestissä ja soita oikeita äänipuheluita: start_dm_call käyttää tämän tietokoneen mikrofonia täsmälleen kuin sovelluksen soittopainike.

| Työkalu | Mitä se tekee |
| --- | --- |
| enter_dm_chat | Näytä itsesi paikalla olevana yksityisviestissä. |
| leave_dm_chat | Lopeta paikalla olevana näkyminen yksityisviestissä. |
| start_dm_call | Aloita äänipuhelu yksityisviestissä (käyttää tämän tietokoneen mikrofonia). |
| answer_dm_call | Vastaa soivaan puheluun yksityisviestissä. |
| decline_dm_call | Hylkää soiva puhelu yksityisviestissä. |
| end_dm_call | Lopeta tai peru puhelu yksityisviestissä. |
| get_call_status | Äänipuhelun nykyinen tila ja mahdollinen saapuva puhelu. |

### Pelit

Liity mssgs:n sisäänrakennettuihin minipeleihin ja pelaa niitä suoraan avustajastasi.

| Työkalu | Mitä se tekee |
| --- | --- |
| list_game_invites | Sinulle osoitetut avoimet pelikutsut. |
| list_active_games | Pelihuoneet, joissa pelaat parhaillaan. |
| accept_game_invite | Hyväksy kutsu room_id:n tai liittymiskoodin perusteella. |
| get_game_state | Käynnissä olevan pelisi reaaliaikainen lauta tai tila. |
| game_move | Pelaa vuoro pelissä. |
| resign_game | Luovuta tai poistu pelistä. |

### Yhteiskatselut

Aloita ja ohjaa yhteisiä katselukertoja, liity huoneeseen ja reagoi yhdessä reaaliajassa.

| Työkalu | Mitä se tekee |
| --- | --- |
| list_watch_parties | Listaa aktiiviset yhteiskatselut, joihin sinulla on pääsy. |
| get_watch_party | Hae yhden yhteiskatselun koko tila. |
| start_watch_party | Aloita yhteiskatselu kanavalla. |
| join_watch_party | Liity aktiiviseen yhteiskatseluun. |
| leave_watch_party | Poistu yhteiskatselusta. |
| control_watch_party | Toista, keskeytä tai siirry kohtaan koko huoneelle. |
| end_watch_party | Lopeta yhteiskatselu kaikilta. |
| send_watch_party_emote | Lähetä yhteiskatseluun reaaliaikainen emote. |

### Viestipyynnöt

Päätä, kuka saa aloittaa keskustelun kanssasi.

| Työkalu | Mitä se tekee |
| --- | --- |
| view_dm_requests | Avoimet saapuvat viestipyyntösi. |
| accept_dm_request | Hyväksy viestipyyntö. |
| deny_dm_request | Hylkää viestipyyntö. |

### Sosiaalinen: profiilit, tarinat, kartta

Katso profiileja ja tarinoita ja näe lähettämäsi karttasuodattimet.

| Työkalu | Mitä se tekee |
| --- | --- |
| get_profile | Käyttäjän julkinen profiili user_guidin perusteella. |
| list_story_users | Ihmiset, joilla on katsomaton tarina, jonka voit nähdä. |
| view_story | Katso käyttäjän aktiiviset tarinat. |
| list_map_filters | Tämän tilin lähettämät karttasuodattimet moderointitiloineen. |

### Äänikanavat

Tarkastele ja ohjaa tämän tietokoneen käynnissä olevaa äänikanavaistuntoa.

| Työkalu | Mitä se tekee |
| --- | --- |
| list_voice_channels | Listaa palvelimen äänikanavat. |
| get_voice_state | Hae nykyinen ääni-istunto ja osallistujat. |
| join_voice_channel | Liity äänikanavalle tällä tietokoneella. |
| leave_voice_channel | Poistu nykyiseltä äänikanavalta. |
| set_voice_muted | Mykistä tämän tietokoneen mikrofoni tai poista mykistys. |

### Tili ja yksityisyys

Hallitse kavereita, estoja, mykistyksiä, luettu-tilaa ja leikkeitä paljastamatta tilin salaisuuksia.

| Työkalu | Mitä se tekee |
| --- | --- |
| list_friends | Listaa kaverisi. |
| list_blocked | Listaa estämäsi tilit. |
| block_user | Estä tili. |
| unblock_user | Poista tilin esto. |
| list_mutes | Listaa mykistetyt kanavat ja palvelimet. |
| mute_channel | Mykistä kanava. |
| unmute_channel | Poista kanavan mykistys. |
| mute_server | Mykistä palvelin. |
| unmute_server | Poista palvelimen mykistys. |
| mark_channel_read | Merkitse kanava luetuksi. |
| list_clips | Listaa luomasi leikkeet. |
| share_clip | Tee yhdestä leikkeestäsi jaettava. |
| unshare_clip | Lopeta leikkeen jakaminen. |
| rename_clip | Nimeä yksi leikkeistäsi uudelleen. |
| list_stickers | Listaa käytettävissä olevat tarrasi. |
| list_friend_locations | Listaa kaverit, jotka jakavat sijaintinsa kanssasi juuri nyt. |
| list_location_viewers | Listaa, ketkä näkevät sijaintisi juuri nyt. |

### Bottitilin työkalut

Julkaise interaktiivisia embed-kortteja ja lue niihin tulleet vuorovaikutukset. Käytettävissä, kun olet kirjautunut bottitilillä.

| Työkalu | Mitä se tekee |
| --- | --- |
| send_bot_message | Julkaise näyttävä embed-kortti valinnaisin painikkein (vain bottitilit). |
| get_bot_events | Kysele bottiviestiesi painikkeiden painallukset, reaktiot ja vastaukset. |
| set_bot_status | Aseta tai poista mukautettu läsnäolotila (vain bottitilit). |

### Agenttien ohjaus

Määritä kanavien agentit, liitä projekteja, tarkastele käynnissä olevia tehtäviä ja ohjaa työtä keskustelusta. Hallintatoiminnot vaativat edelleen kanavan oikeudet.

| Työkalu | Mitä se tekee |
| --- | --- |
| list_agent_channels | Listaa avatut kanavat ja niiden agenttiasetukset. |
| get_channel_agents | Hae kanavan koko agenttimääritys. |
| set_channel_agents | Ota agentit käyttöön ja päivitä kanavan agenttisäännöt. |
| add_channel_agent | Lisää saatavilla oleva agentti kanavalle. |
| remove_channel_agent | Poista agentti kanavalta. |
| set_agent_project | Liitä projekti ja ohjeet kanavan agenttiin. |
| remove_agent_project | Irrota projekti kanavan agentista. |
| list_agent_tasks | Listaa nykyiset ja viimeaikaiset agenttitehtävät. |
| get_agent_task | Hae yhden agenttitehtävän reaaliaikainen tila ja tuloste. |
| steer_agent_task | Lähetä käynnissä olevalle agenttitehtävälle jatko-ohje. |

### Palvelinten hallinta

Muokkaa hallinnoimaasi palvelinta: kanavat, kategoriat, oikeusryhmät, webhookit ja liipaisimet. Jokainen kutsu tarkistaa silti todelliset hallintaoikeutesi kyseisellä palvelimella.

| Työkalu | Mitä se tekee |
| --- | --- |
| list_manageable_servers | Palvelimet, joita voit hallita, ja mitkä oikeudet sinulla on. |
| get_server_structure | Palvelimen koko kanava- ja kategoriarakenne. |
| create_channel | Luo kanava. |
| update_channel | Nimeä kanava uudelleen, vaihda sen tyyppiä tai siirrä sitä. |
| delete_channel | Poista kanava (peruuttamaton). |
| create_category | Luo kanavakategoria. |
| update_category | Nimeä kategoria uudelleen. |
| delete_category | Poista kategoria (sen kanavat säilyvät). |
| list_server_groups | Palvelimen oikeusryhmät. |
| create_server_group | Luo oikeusryhmä. |
| update_server_group | Nimeä oikeusryhmä uudelleen, vaihda sen väriä tai oikeuksia. |
| delete_server_group | Poista oikeusryhmä. |
| list_members | Listaa palvelimen jäsenet ja heidän oikeusryhmänsä. |
| add_member_to_group | Lisää palvelimen jäsen oikeusryhmään. |
| remove_member_from_group | Poista palvelimen jäsen oikeusryhmästä. |
| list_invites | Listaa palvelimen aktiiviset kutsut. |
| create_invite | Luo palvelinkutsu. |
| delete_invite | Peru palvelinkutsu. |
| list_custom_emojis | Listaa palvelimen mukautetut emojit. |
| list_webhooks | Palvelimen saapuvat webhookit. |
| create_webhook | Luo saapuva webhook. |
| get_webhook_url | Hae webhookin URL, johon voi lähettää POST-pyyntöjä. |
| update_webhook | Päivitä webhookin asetukset. |
| delete_webhook | Poista webhook (sen URL lakkaa toimimasta). |
| list_triggers | Palvelimen lähtevät liipaisimet. |
| create_trigger | Luo liipaisin (vastaavat viestit lähetetään POST-pyyntönä URL:iin). |
| update_trigger | Päivitä liipaisin. |
| delete_trigger | Poista liipaisin. |

### Yhteisön moderointi

Samat tarkastusjonot, jotka kilpipainike avaa sovelluksessa. Äänet ja veto-oikeus vaativat edelleen oikean moderaattorin (tai henkilökunnan) tilin.

| Työkalu | Mitä se tekee |
| --- | --- |
| get_moderation_stats | Moderointitilasi ja se, kuinka paljon odottaa. |
| list_moderation_queue | Karttasuodattimet, jotka odottavat moderaattorin ääntä. |
| approve_map_filter | Äänestä lähetetyn karttasuodattimen hyväksymisen puolesta. |
| deny_map_filter | Äänestä lähetetyn karttasuodattimen hylkäämisen puolesta. |
| list_report_queue | Ilmoitettu sisältö, joka odottaa moderaattorin ääntä. |
| approve_report | Äänestä, että ilmoitettu sisältö rikkoo sääntöjä. |
| deny_report | Äänestä, että ilmoitettu sisältö on kunnossa. |
| community_map_propose_filter | Lähetä uusi karttasuodatin tarkastettavaksi. |
| veto_map_filter | Vain henkilökunta: poista karttasuodatin välittömästi (peruuttamaton). |

### Apuvälineet

Pieniä apuja pitkään toimiville avustajille.

| Työkalu | Mitä se tekee |
| --- | --- |
| keep_computer_awake | Pidä tämä tietokone hereillä työskentelysi ajan tai vapauta se. |

## Jatka rakentamista