---
title: "MCP: ühenda Claude ja teised TI-assistendid mssgs’iga"
description: "Ühenda Claude, Cursor ja teised TI-tööriistad MCP kaudu mssgs’iga. Kohalik, õigustega server 127 tööriistaga: kanalid, sõnumid, botid, serverid, modereerimine."
canonical: https://docs.mss.gs/et/mcp
language: et
---

# Ühenda TI-assistent

mssgs’i arvutirakendusse on sisse ehitatud MCP-server. Ühenda Claude, Cursor või Codex ja need saavad sinu valitud kanalites lugeda, kokku võtta ja vastata, otse sinu enda arvutist.

## Mida saad teha

- **Loeb ja võtab kokku** Kanalid, otsesõnumid, mainimised ja kinnitatud sõnumid, ainult kanalites, mida jagad.

- **Kirjutab, kui lubad** Saadab, vastab, reageerib, muudab ja kinnitab, kui saatmise sisse lülitad.

- **Mängib mänge** Võtab kutse vastu, loeb mängulauda ja teeb päris käike.

- **Kontroll jääb sinule** Vaikimisi väljas, alguses ainult lugemine, ainult kohalikult, iga TI-tööriista jaoks eraldi tühistatav token.

Rakenduses

Sina küsid oma TI-tööriistas; see loeb MCP-serveri kaudu kanalit #general ja postitab kokkuvõtte sinu nimel, sest oled saatmise lubanud.

- [Ülevaade](#overview)

- [Ühendamine](#connect)

- [Õigused ja tokenid](#permissions)

- [Reaalajas sündmused](#events)

- [Tööriistad](#tools)

## Ülevaade

mssgs’i arvutirakendusega tuleb kaasa sisseehitatud **MCP-server** (Model Context Protocol), nii et TI-assistendid nagu Claude või Cursor saavad sinu tööruumis lugeda ja tegutseda. See töötab kohalikult sinu arvutis ja suhtleb sinu sisselogitud mssgs’i seansiga; eraldi botikontot ega majutust pole vaja.

### Sina otsustad, mida see näeb

Server töötab ainult aadressil localhost , kuni mssgs on avatud ja sa oled sisse logitud. Sina valid, milliseid kanaleid jagada, ja lülitad grupi kaupa sisse, mida assistent teha tohib. Praegu on 14 grupis kokku **127 tööriista**.

## Ühendamine

Autentimine käib Bearer-tokeniga, mille saad rakenduse [AI / MCP seadete lehelt](https://mss.gs/et/help/bots-mcp/connect-your-ai): lülita server sisse, vali jagatavad kanalid ja vajuta „Copy config“; kopeeritud plokis on sinu port ja token juba olemas. Server kuulab ainult localhostis (vaikimisi port 7444) ja töötab, kuni mssgs on avatud ja sa oled sisse logitud.

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

Claude Desktopi või Cursori jaoks: kleebi „Copy config“ plokk oma TI-tööriista MCP-seadetesse. Vaata Abikeskuses [samm-sammulist juhendit](https://mss.gs/et/help/bots-mcp/connect-your-ai).

## Õigused ja tokenid

Assistendile nähtavad tööriistad sõltuvad lülititest, mille sisse lülitad. Lugemistööriistad on alati sees; kõik muu on grupilüliti taga. Serverihaldus ja modereerimine kontrollivad lisaks sinu konto tegelikke õigusi.

| Grupp | Avab |
| --- | --- |
| **Lugemine** | Alati sees: sõnumite, kohaloleku, mainimiste ja kinnituste lugemine jagatud kanalites |
| **Saatmine ja suhtlus** | Saatmine, vastamine, reageerimine, muutmine, kustutamine, kinnitamine, kirjutamise indikaator, lisaks kohalolek otsesõnumites, häälkõned ja mängud |
| **Watch party** | Ühiste vaatamisseansside alustamine, nendega liitumine ja nende juhtimine |
| **Otsesõnumi taotlused** | Sissetulevate otsesõnumi taotluste vaatamine, vastuvõtmine ja tagasilükkamine |
| **Sotsiaalne** | Profiilid, lood ja sinu kaardifiltrid |
| **Häälkanalid** | Häälkanalitega liitumine, osalejate vaatamine ja mikrofoni juhtimine |
| **Konto ja privaatsus** | Sõbrad, blokeeringud, vaigistused, loetud olek, klipid ja asukoha jagamine |
| **Agentide juhtimine** | Kanali agentide, projektide ja käimasolevate ülesannete seadistamine |
| **Serverihaldus** | Kanalid, kategooriad, õiguste grupid, liikmed, kutsed, emojid, webhookid ja triggerid (tegelikke haldusõigusi kontrollitakse endiselt) |
| **Kogukonna modereerimine** | Ülevaatusjärjekorrad ja hääletused (endiselt on vaja moderaatori või mssgs’i meeskonna kontot) |
| **Arvuti ärkvel hoidmine** | Ei lase arvutil assistendi töö ajal unerežiimi minna |
| **Botikonto tööriistad** | Interaktiivsed embed-kaardid ja nende sündmused (ainult botikontod) |

### Tokenid

Tokenitel on nimed, igal TI-tööriistal oma, ja neid saab ühe klõpsuga tühistada; iga tokeni juures olev tegevusgraafik näitab täpselt, millal seda kasutati. Hea tava: üks token tööriista kohta, selge nimega. Sülearvuti kadus? Tühista selle token ja see on kasutu.

## Reaalajas sündmused SSE kaudu

Ava MCP endpoint voona ( GET /mcp päisega Accept: text/event-stream ) ja JSON-RPC teavitused saabuvad kohe, kui midagi juhtub:

| Teavitus | Millal saabub |
| --- | --- |
| notifications/mssgs/message | Uued sõnumid kanalites, mida näed |
| notifications/mssgs/bot_event | Nupuvajutused, reaktsioonid ja vastused sõnumitele, mille sinu assistent postitas tööriistaga send_bot_message |
| notifications/mssgs/presence | Kohaloleku muutused |
| notifications/mssgs/typing | Kirjutamise indikaatorid |
| notifications/mssgs/call | Häälkõne sündmused |

## Interaktiivsed botikaardid

### Interaktiivsed botikaardid sinu assistendilt

Postita nuppudega embed-kaart tööriistaga send_bot_message , kuula voos sündmust bot_event (või päri get_bot_events ) ja uuenda kaarti kohapeal tööriistaga edit_message . Sama kaardimudel mis [botisõnumite](https://docs.mss.gs/et/bots) dokumentatsioonis.

## Tööriistade loend (127)

Iga allolev tööriist on päris toiming mssgs’is. Nimed on täpsed MCP-identifikaatorid. Tööriistad ilmuvad alles siis, kui nende grupp on sisse lülitatud.

### Lugemine

Ainult lugemiseks mõeldud tööriistad, saadaval kohe, kui server on sees. Need näevad ainult kanaleid, mida jagasid.

| Tööriist | Mida see teeb |
| --- | --- |
| list_channels | Loetleb kanalid, mida TI-tööriistadega jagasid. |
| read_channel | Loeb jagatud kanali viimaseid sõnumeid. |
| get_new_messages | Toob kõigist jagatud kanalitest sõnumid, mis on uuemad kui antud ajatempel. |
| get_channel_stamp | Kanali loetud/lugemata olek koos lugemata sõnumite ja mainimiste arvuga. |
| get_presence | Kes kanalis kohal on ja mis on nende olek. |
| get_message | Toob ühe täieliku sõnumi id järgi, koos embedide ja lingieelvaadetega. |
| search_messages | Otsib sõnumite tekstist serveri jagatud kanalites. |
| get_message_context | Loeb sõnumeid vahetult ühe otsingutulemuse ümber. |
| get_account | Näitab sisselogitud kontot ja selle võimalusi. |
| get_typing | Kes kanalis parasjagu kirjutab. |
| list_mentions | Viimased sõnumid, mis sind @mainivad. |
| list_pinned_messages | Kanali kinnitatud sõnumid. |
| subscribe_channel | Tellib kanali reaalajas uuendused. |
| unsubscribe_channel | Lõpetab kanali reaalajas uuendused. |
| list_subscriptions | Loetleb kanalid, mille reaalajas uuendused oled tellinud. |

### Saatmine ja suhtlus

Postita ja tegutse sisselogitud kasutajana. Kõik siin kirjutab kanalisse, seega on see ühe lüliti taga.

| Tööriist | Mida see teeb |
| --- | --- |
| send_message | Saadab kanalisse sõnumi sinu nimel. |
| reply_message | Vastab konkreetsele sõnumile, viidates sellele. |
| add_reaction | Lisab sõnumile emoji-reaktsiooni. |
| remove_reaction | Eemaldab ühe sinu emoji-reaktsioonidest. |
| edit_message | Muudab üht sinu enda sõnumit. |
| delete_message | Kustutab ühe sinu enda sõnumi. |
| pin_message | Kinnitab sõnumi (vajab kinnitamise õigust). |
| unpin_message | Eemaldab sõnumi kinnituse. |
| open_one_view_attachment | Avab otsesõnumis ühekordselt vaadatava foto/video. |
| set_typing | Näitab reaalajas indikaatorit „kirjutab…“. |
| stop_typing | Eemaldab kirjutamise indikaatori. |

### Kohalolek otsesõnumites ja kõned

Ole otsesõnumis kohal ja tee päris häälkõnesid: start_dm_call kasutab selle arvuti mikrofoni, täpselt nagu helistamisnupu vajutamine rakenduses.

| Tööriist | Mida see teeb |
| --- | --- |
| enter_dm_chat | Näitab sind otsesõnumis kohalolevana. |
| leave_dm_chat | Lõpetab sinu kohaloleku näitamise otsesõnumis. |
| start_dm_call | Alustab otsesõnumis häälkõnet (kasutab selle arvuti mikrofoni). |
| answer_dm_call | Vastab helisevale otsesõnumi kõnele. |
| decline_dm_call | Keeldub helisevast otsesõnumi kõnest. |
| end_dm_call | Lõpetab või tühistab otsesõnumi kõne. |
| get_call_status | Häälkõne praegune olek ja võimalik sissetulev kõne. |

### Mängud

Liitu mssgs’i sisseehitatud minimängudega ja mängi neid otse oma assistendist.

| Tööriist | Mida see teeb |
| --- | --- |
| list_game_invites | Sulle saadetud avatud mängukutsed. |
| list_active_games | Mängutoad, kus sa parasjagu mängid. |
| accept_game_invite | Võtab kutse vastu room_id või liitumiskoodi järgi. |
| get_game_state | Mängu, milles osaled, reaalajas laud/olek. |
| game_move | Teeb mängus käigu. |
| resign_game | Annab mängu alla või lahkub sellest. |

### Watch party

Alusta ja juhi ühiseid vaatamisseansse, liitu ruumiga ja reageeri koos reaalajas.

| Tööriist | Mida see teeb |
| --- | --- |
| list_watch_parties | Loetleb aktiivsed watch party seansid, millele sul on ligipääs. |
| get_watch_party | Toob ühe watch party seansi täieliku oleku. |
| start_watch_party | Alustab kanalis watch party seansi. |
| join_watch_party | Liitub aktiivse watch party seansiga. |
| leave_watch_party | Lahkub watch party seansist. |
| control_watch_party | Esitab, peatab või kerib kogu ruumi jaoks. |
| end_watch_party | Lõpetab watch party seansi kõigi jaoks. |
| send_watch_party_emote | Saadab watch party seansile reaalajas emotikoni. |

### Otsesõnumi taotlused

Otsusta, kes tohib sinuga vestlust alustada.

| Tööriist | Mida see teeb |
| --- | --- |
| view_dm_requests | Sinu avatud sissetulevad otsesõnumi taotlused. |
| accept_dm_request | Võtab otsesõnumi taotluse vastu. |
| deny_dm_request | Lükkab otsesõnumi taotluse tagasi. |

### Sotsiaalne: profiilid, lood, kaart

Vaata profiile, lugusid ja oma esitatud kaardifiltreid.

| Tööriist | Mida see teeb |
| --- | --- |
| get_profile | Kasutaja avalik profiil user_guid järgi. |
| list_story_users | Inimesed, kellel on vaatamata lugu, mida saad vaadata. |
| view_story | Vaatab kasutaja aktiivseid lugusid. |
| list_map_filters | Selle konto esitatud kaardifiltrid koos nende modereerimisolekuga. |

### Häälkanalid

Vaata ja juhi selle arvuti käimasolevat häälkanali seanssi.

| Tööriist | Mida see teeb |
| --- | --- |
| list_voice_channels | Loetleb serveri häälkanalid. |
| get_voice_state | Toob praeguse häälseansi ja osalejad. |
| join_voice_channel | Liitub selles arvutis häälkanaliga. |
| leave_voice_channel | Lahkub praegusest häälkanalist. |
| set_voice_muted | Vaigistab selle arvuti mikrofoni või lülitab selle uuesti sisse. |

### Konto ja privaatsus

Halda sõpru, blokeeringuid, vaigistusi, loetud olekut ja klippe, ilma konto saladusi paljastamata.

| Tööriist | Mida see teeb |
| --- | --- |
| list_friends | Loetleb sinu sõbrad. |
| list_blocked | Loetleb kontod, mille oled blokeerinud. |
| block_user | Blokeerib konto. |
| unblock_user | Eemaldab konto blokeeringu. |
| list_mutes | Loetleb vaigistatud kanalid ja serverid. |
| mute_channel | Vaigistab kanali. |
| unmute_channel | Eemaldab kanali vaigistuse. |
| mute_server | Vaigistab serveri. |
| unmute_server | Eemaldab serveri vaigistuse. |
| mark_channel_read | Märgib kanali loetuks. |
| list_clips | Loetleb sinu loodud klipid. |
| share_clip | Muudab ühe sinu klippidest jagatavaks. |
| unshare_clip | Lõpetab klipi jagamise. |
| rename_clip | Nimetab ühe sinu klippidest ümber. |
| list_stickers | Loetleb sulle saadaolevad kleebised. |
| list_friend_locations | Loetleb sõbrad, kes praegu sinuga oma asukohta jagavad. |
| list_location_viewers | Loetleb, kes praegu sinu asukohta näevad. |

### Botikonto tööriistad

Postita interaktiivseid embed-kaarte ja loe nendega tehtud toiminguid. Saadaval, kui oled botikontoga sisse logitud.

| Tööriist | Mida see teeb |
| --- | --- |
| send_bot_message | Postitab rikkaliku embed-kaardi valikuliste nuppudega (ainult botikontod). |
| get_bot_events | Pärib nupuvajutusi, reaktsioone ja vastuseid sinu botisõnumitele. |
| set_bot_status | Määrab või eemaldab kohandatud kohalolekuoleku (ainult botikontod). |

### Agentide juhtimine

Seadista kanali agente, lisa projekte, jälgi käimasolevaid ülesandeid ja juhi tööd vestlusest. Haldustoimingud nõuavad endiselt kanali õigusi.

| Tööriist | Mida see teeb |
| --- | --- |
| list_agent_channels | Loetleb jagatud kanalid ja nende agentide seadistuse. |
| get_channel_agents | Toob kanali agentide täieliku seadistuse. |
| set_channel_agents | Lülitab agendid sisse ja uuendab kanali agendireegleid. |
| add_channel_agent | Lisab kanalisse saadaoleva agendi. |
| remove_channel_agent | Eemaldab agendi kanalist. |
| set_agent_project | Lisab kanali agendile projekti ja juhised. |
| remove_agent_project | Eemaldab kanali agendilt projekti. |
| list_agent_tasks | Loetleb praegused ja hiljutised agendi ülesanded. |
| get_agent_task | Toob ühe agendi ülesande reaalajas oleku ja väljundi. |
| steer_agent_task | Saadab käimasolevale agendi ülesandele täiendava juhise. |

### Serverihaldus

Kujunda serverit, mida haldad: kanalid, kategooriad, õiguste grupid, webhookid ja triggerid. Iga päring kontrollib endiselt sinu tegelikke haldusõigusi selles serveris.

| Tööriist | Mida see teeb |
| --- | --- |
| list_manageable_servers | Serverid, mida saad hallata, ja millised õigused sul on. |
| get_server_structure | Serveri kanalite ja kategooriate täielik ülesehitus. |
| create_channel | Loob kanali. |
| update_channel | Nimetab kanali ümber, muudab selle tüüpi või teisaldab selle. |
| delete_channel | Kustutab kanali (pöördumatu). |
| create_category | Loob kanalikategooria. |
| update_category | Nimetab kategooria ümber. |
| delete_category | Kustutab kategooria (selle kanalid jäävad alles). |
| list_server_groups | Serveri õiguste grupid. |
| create_server_group | Loob õiguste grupi. |
| update_server_group | Muudab õiguste grupi nime, värvi või ulatust. |
| delete_server_group | Kustutab õiguste grupi. |
| list_members | Loetleb serveri liikmed ja nende õiguste grupid. |
| add_member_to_group | Lisab serveri liikme õiguste gruppi. |
| remove_member_from_group | Eemaldab serveri liikme õiguste grupist. |
| list_invites | Loetleb serveri aktiivsed kutsed. |
| create_invite | Loob serveri kutse. |
| delete_invite | Tühistab serveri kutse. |
| list_custom_emojis | Loetleb serveri kohandatud emojid. |
| list_webhooks | Serveri sissetulevad webhookid. |
| create_webhook | Loob sissetuleva webhooki. |
| get_webhook_url | Toob webhooki URL-i, kuhu postitada. |
| update_webhook | Uuendab webhooki seadeid. |
| delete_webhook | Kustutab webhooki (selle URL lakkab töötamast). |
| list_triggers | Serveri väljuvad triggerid. |
| create_trigger | Loob triggeri (sobivad sõnumid saadetakse POST-päringuga URL-ile). |
| update_trigger | Uuendab triggerit. |
| delete_trigger | Kustutab triggeri. |

### Kogukonna modereerimine

Samad ülevaatusjärjekorrad, mille rakenduses kilbinupp avab. Hääled ja vetod nõuavad endiselt päris moderaatori (või mssgs’i meeskonna) kontot.

| Tööriist | Mida see teeb |
| --- | --- |
| get_moderation_stats | Sinu modereerimisolek ja kui palju ootab. |
| list_moderation_queue | Kaardifiltrid, mis ootavad moderaatori häält. |
| approve_map_filter | Hääletab esitatud kaardifiltri heakskiitmise poolt. |
| deny_map_filter | Hääletab esitatud kaardifiltri tagasilükkamise poolt. |
| list_report_queue | Teavitatud sisu, mis ootab moderaatori häält. |
| approve_report | Hääletab, et teavitatud sisu rikub reegleid. |
| deny_report | Hääletab, et teavitatud sisu on korras. |
| community_map_propose_filter | Esitab uue kaardifiltri ülevaatamiseks. |
| veto_map_filter | Ainult mssgs’i meeskonnale: eemaldab kaardifiltri kohe (pöördumatu). |

### Abitööriistad

Väikesed abilised pikalt töötavatele assistentidele.

| Tööriist | Mida see teeb |
| --- | --- |
| keep_computer_awake | Hoiab selle arvuti sinu töö ajal ärkvel või vabastab selle. |

## Ehita edasi