---
title: "MCP: prepoj Claude a ďalších AI asistentov s mssgs"
description: "Prepoj Claude, Cursor a ďalšie nástroje AI s mssgs cez MCP. Lokálny server s povoleniami a 127 nástrojmi: čítaj kanály, posielaj správy, spúšťaj boty a viac."
canonical: https://docs.mss.gs/sk/mcp
language: sk
---

# Pripoj AI asistenta

Desktopová aplikácia mssgs má zabudovaný MCP server. Pripoj Claude, Cursor alebo Codex a budú čítať, zhŕňať a odpovedať v kanáloch, ktoré vyberieš, priamo z tvojho počítača.

## Čo s tým môžeš robiť

- **Číta a zhŕňa** Kanály, súkromné správy, zmienky a pripnuté správy, iba v kanáloch, ktoré sprístupníš.

- **Píše, keď to povolíš** Posiela, odpovedá, reaguje, upravuje a pripína, keď zapneš posielanie.

- **Hrá hry** Prijme pozvánku, prečíta hraciu plochu a robí skutočné ťahy.

- **Kontrolu máš ty** Predvolene vypnuté, najprv iba na čítanie, len lokálne, pre každý AI nástroj vlastný token, ktorý môžeš zrušiť.

V aplikácii

Opýtaš sa vo svojom AI nástroji; ten prečíta #general cez MCP server a uverejní zhrnutie v tvojom mene, pretože máš zapnuté posielanie.

- [Prehľad](#overview)

- [Pripojenie](#connect)

- [Oprávnenia a tokeny](#permissions)

- [Udalosti v reálnom čase](#events)

- [Nástroje](#tools)

## Prehľad

Desktopová aplikácia mssgs obsahuje zabudovaný **MCP server** (Model Context Protocol), vďaka ktorému AI asistenti ako Claude alebo Cursor môžu čítať a konať v tvojom pracovnom priestore. Beží lokálne na tvojom počítači a komunikuje s tvojou prihlásenou reláciou mssgs; nepotrebuješ samostatný účet bota ani hosting.

### Ty rozhoduješ, čo vidí

Server beží iba na localhost , kým je aplikácia mssgs otvorená a tvoj účet prihlásený. Vyberieš, ktoré kanály sprístupníš, a skupinu po skupine zapneš, čo asistent smie robiť. Server momentálne ponúka **127 nástrojov** v 14 skupinách.

## Pripojenie

Overenie prebieha tokenom Bearer zo [stránky nastavení AI / MCP](https://mss.gs/sk/help/bots-mcp/connect-your-ai) v aplikácii: zapni server, vyber kanály, ktoré chceš sprístupniť, a stlač „Copy config“; skopírovaný blok už obsahuje tvoj port a token. Server počúva iba na localhost (predvolený port 7444) a beží, kým je aplikácia mssgs otvorená a tvoj účet prihlásený.

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

Pre Claude Desktop alebo Cursor: vlož blok z „Copy config“ do nastavení MCP svojho AI nástroja. Pozri [návod krok za krokom](https://mss.gs/sk/help/bots-mcp/connect-your-ai) v Centre pomoci.

## Oprávnenia a tokeny

Ktoré nástroje asistent vidí, závisí od prepínačov, ktoré zapneš. Nástroje iba na čítanie sú vždy zapnuté; všetko ostatné je za prepínačom skupiny. Správa servera a moderovanie navyše kontrolujú tvoje skutočné oprávnenia na účte.

| Skupina | Odomyká |
| --- | --- |
| **Čítanie** | Vždy zapnuté: čítanie správ, prítomnosti, zmienok a pripnutí v sprístupnených kanáloch |
| **Posielanie a interakcie** | Posielanie, odpovede, reakcie, úpravy, mazanie, pripínanie, indikátor písania, plus prítomnosť v DM, hlasové hovory a hry |
| **Watch party** | Spúšťanie spoločného sledovania, pripájanie sa k nemu a jeho ovládanie |
| **Žiadosti o DM** | Prezeranie, prijímanie a odmietanie prichádzajúcich žiadostí o DM |
| **Sociálne** | Profily, príbehy a tvoje filtre mapy |
| **Hlasové kanály** | Pripojenie k hlasovým kanálom, prehľad účastníkov a ovládanie mikrofónu |
| **Účet a súkromie** | Priatelia, blokovania, stlmenia, stav prečítania, klipy a zdieľanie polohy |
| **Riadenie agentov** | Nastavenie agentov v kanáloch, projektov a živých úloh |
| **Správa servera** | Kanály, kategórie, skupiny oprávnení, členovia, pozvánky, emoji, webhooky a triggery (skutočné oprávnenia na správu stále platia) |
| **Moderovanie komunity** | Fronty na posúdenie a hlasovanie (stále treba účet moderátora alebo tímu mssgs) |
| **Počítač bez spánku** | Počítač neprejde do režimu spánku, kým asistent pracuje |
| **Nástroje pre účty botov** | Interaktívne karty (embed) a ich udalosti (iba účty botov) |

### Tokeny

Tokeny majú názvy, sú zvlášť pre každý AI nástroj a zrušíš ich jedným kliknutím; graf aktivity pri každom tokene presne ukáže, kedy bol použitý. Dobrý zvyk: jeden token na nástroj, s jasným názvom. Stratil sa ti laptop? Zruš jeho token a bude nepoužiteľný.

## Udalosti v reálnom čase cez SSE

Otvor MCP endpoint ako stream ( GET /mcp s Accept: text/event-stream ) a notifikácie JSON-RPC budú prichádzať priebežne:

| Notifikácia | Kedy príde |
| --- | --- |
| notifications/mssgs/message | Nové správy v kanáloch, ktoré vidíš |
| notifications/mssgs/bot_event | Stlačenia tlačidiel, reakcie a odpovede na správy, ktoré tvoj asistent uverejnil cez send_bot_message |
| notifications/mssgs/presence | Zmeny prítomnosti |
| notifications/mssgs/typing | Indikátory písania |
| notifications/mssgs/call | Udalosti hlasových hovorov |

## Interaktívne karty botov

### Interaktívne karty botov od tvojho asistenta

Uverejni kartu (embed) s tlačidlami cez send_bot_message , počúvaj bot_event v streame (alebo sa pravidelne pýtaj cez get_bot_events ) a kartu aktualizuj na mieste cez edit_message . Rovnaký model kariet ako v dokumentácii [správ botov](https://docs.mss.gs/sk/bots).

## Prehľad nástrojov (127)

Každý nástroj nižšie je skutočná akcia v mssgs. Názvy sú presné identifikátory MCP. Nástroje sa zobrazia, až keď zapneš ich skupinu.

### Čítanie

Nástroje iba na čítanie, dostupné hneď, ako je server zapnutý. Vidia vždy len kanály, ktoré sprístupníš.

| Nástroj | Čo robí |
| --- | --- |
| list_channels | Zoznam kanálov sprístupnených AI nástrojom. |
| read_channel | Prečíta posledné správy zo sprístupneného kanála. |
| get_new_messages | Načíta správy novšie ako zadaná časová pečiatka zo všetkých sprístupnených kanálov. |
| get_channel_stamp | Stav prečítania kanála s počtom neprečítaných správ a zmienok. |
| get_presence | Kto je prítomný v kanáli a s akým stavom. |
| get_message | Načíta jednu celú správu podľa id vrátane embedov a náhľadov odkazov. |
| search_messages | Vyhľadá text správ v sprístupnených kanáloch servera. |
| get_message_context | Prečíta správy tesne pred jedným výsledkom vyhľadávania a po ňom. |
| get_account | Ukáže prihlásený účet a jeho dostupné možnosti. |
| get_typing | Kto práve píše v kanáli. |
| list_mentions | Posledné správy, ktoré ťa @zmieňujú. |
| list_pinned_messages | Pripnuté správy v kanáli. |
| subscribe_channel | Prihlási odber kanála pre aktualizácie v reálnom čase. |
| unsubscribe_channel | Zastaví aktualizácie kanála v reálnom čase. |
| list_subscriptions | Zoznam kanálov, ktoré odoberáš v reálnom čase. |

### Posielanie a interakcie

Uverejňovanie a konanie v mene prihláseného používateľa. Všetko tu zapisuje do kanála, preto je to celé za jedným prepínačom.

| Nástroj | Čo robí |
| --- | --- |
| send_message | Pošle správu do kanála v tvojom mene. |
| reply_message | Odpovie na konkrétnu správu a prepojí odpoveď s ňou. |
| add_reaction | Pridá k správe emoji reakciu. |
| remove_reaction | Odstráni jednu z tvojich emoji reakcií. |
| edit_message | Upraví jednu z tvojich vlastných správ. |
| delete_message | Zmaže jednu z tvojich vlastných správ. |
| pin_message | Pripne správu (vyžaduje oprávnenie na pripínanie). |
| unpin_message | Odopne pripnutú správu. |
| open_one_view_attachment | Otvorí v DM fotku alebo video na jedno zobrazenie. |
| set_typing | Zobrazí živý indikátor „píše…“. |
| stop_typing | Zruší indikátor písania. |

### Prítomnosť v DM a hovory

Prítomnosť v súkromných správach a skutočné hlasové hovory: start_dm_call používa mikrofón tohto počítača, presne ako tlačidlo hovoru v aplikácii.

| Nástroj | Čo robí |
| --- | --- |
| enter_dm_chat | Označí tvoju prítomnosť v DM. |
| leave_dm_chat | Prestane označovať tvoju prítomnosť v DM. |
| start_dm_call | Začne hlasový hovor v DM (používa mikrofón tohto počítača). |
| answer_dm_call | Prijme zvoniaci hovor v DM. |
| decline_dm_call | Odmietne zvoniaci hovor v DM. |
| end_dm_call | Zavesí alebo zruší hovor v DM. |
| get_call_status | Aktuálny stav hlasového hovoru a prípadný prichádzajúci hovor. |

### Hry

Pripájaj sa k zabudovaným minihrám mssgs a hraj ich priamo zo svojho asistenta.

| Nástroj | Čo robí |
| --- | --- |
| list_game_invites | Otvorené pozvánky do hier adresované tebe. |
| list_active_games | Herné miestnosti, v ktorých práve hráš. |
| accept_game_invite | Prijme pozvánku podľa room_id alebo kódu miestnosti. |
| get_game_state | Aktuálna hracia plocha a stav hry, ktorej sa zúčastňuješ. |
| game_move | Urobí ťah v hre. |
| resign_game | Vzdá hru alebo ju opustí. |

### Watch party

Spúšťanie a ovládanie spoločného sledovania, pripojenie do miestnosti a spoločné reakcie v reálnom čase.

| Nástroj | Čo robí |
| --- | --- |
| list_watch_parties | Zoznam aktívnych watch party, ku ktorým máš prístup. |
| get_watch_party | Celý stav jednej watch party. |
| start_watch_party | Spustí watch party v kanáli. |
| join_watch_party | Pripojí sa k aktívnej watch party. |
| leave_watch_party | Opustí watch party. |
| control_watch_party | Prehrá, pozastaví alebo pretočí pre celú miestnosť. |
| end_watch_party | Ukončí watch party pre všetkých. |
| send_watch_party_emote | Pošle do watch party emotikon v reálnom čase. |

### Žiadosti o DM

Rozhoduj, kto s tebou smie začať konverzáciu.

| Nástroj | Čo robí |
| --- | --- |
| view_dm_requests | Tvoje otvorené prichádzajúce žiadosti o DM. |
| accept_dm_request | Prijme žiadosť o DM. |
| deny_dm_request | Odmietne žiadosť o DM. |

### Sociálne: profily, príbehy, mapa

Vyhľadávaj profily, pozeraj príbehy a prezri si filtre mapy odoslané z tvojho účtu.

| Nástroj | Čo robí |
| --- | --- |
| get_profile | Verejný profil používateľa podľa user_guid. |
| list_story_users | Ľudia s nevideným príbehom, ktorý si môžeš pozrieť. |
| view_story | Zobrazí aktívne príbehy používateľa. |
| list_map_filters | Filtre mapy odoslané z tohto účtu, so stavom moderovania. |

### Hlasové kanály

Prehľad a ovládanie živej relácie hlasového kanála na tomto počítači.

| Nástroj | Čo robí |
| --- | --- |
| list_voice_channels | Zoznam hlasových kanálov na serveri. |
| get_voice_state | Aktuálna hlasová relácia a jej účastníci. |
| join_voice_channel | Pripojí sa k hlasovému kanálu na tomto počítači. |
| leave_voice_channel | Opustí aktuálny hlasový kanál. |
| set_voice_muted | Stlmí alebo zapne mikrofón tohto počítača. |

### Účet a súkromie

Spravuj priateľov, blokovania, stlmenia, stav prečítania a klipy bez odhalenia tajomstiev účtu.

| Nástroj | Čo robí |
| --- | --- |
| list_friends | Zoznam tvojich priateľov. |
| list_blocked | Zoznam účtov, ktoré blokuješ. |
| block_user | Zablokuje účet. |
| unblock_user | Odblokuje účet. |
| list_mutes | Zoznam stlmených kanálov a serverov. |
| mute_channel | Stlmí kanál. |
| unmute_channel | Zruší stlmenie kanála. |
| mute_server | Stlmí server. |
| unmute_server | Zruší stlmenie servera. |
| mark_channel_read | Označí kanál ako prečítaný. |
| list_clips | Zoznam tvojich klipov. |
| share_clip | Sprístupní jeden z tvojich klipov na zdieľanie. |
| unshare_clip | Zastaví zdieľanie klipu. |
| rename_clip | Premenuje jeden z tvojich klipov. |
| list_stickers | Zoznam nálepiek, ktoré máš k dispozícii. |
| list_friend_locations | Zoznam priateľov, ktorí s tebou práve zdieľajú polohu. |
| list_location_viewers | Zoznam ľudí, ktorí práve vidia tvoju polohu. |

### Nástroje pre účty botov

Uverejňuj interaktívne karty (embed) a čítaj interakcie na nich. Dostupné po prihlásení na účet bota.

| Nástroj | Čo robí |
| --- | --- |
| send_bot_message | Uverejní bohatú kartu (embed) s voliteľnými tlačidlami (iba účty botov). |
| get_bot_events | Zisťuje stlačenia tlačidiel, reakcie a odpovede na správy tvojho bota. |
| set_bot_status | Nastaví alebo zruší vlastný stav prítomnosti (iba účty botov). |

### Riadenie agentov

Nastavuj agentov v kanáloch, pripájaj projekty, sleduj živé úlohy a riaď prácu z chatu. Správcovské akcie stále vyžadujú oprávnenia v kanáli.

| Nástroj | Čo robí |
| --- | --- |
| list_agent_channels | Zoznam sprístupnených kanálov a nastavenia ich agentov. |
| get_channel_agents | Úplná konfigurácia agentov kanála. |
| set_channel_agents | Zapne agentov a aktualizuje pravidlá agentov kanála. |
| add_channel_agent | Pridá do kanála dostupného agenta. |
| remove_channel_agent | Odstráni agenta z kanála. |
| set_agent_project | Pripojí k agentovi kanála projekt a pokyny. |
| remove_agent_project | Odpojí projekt od agenta kanála. |
| list_agent_tasks | Zoznam aktuálnych a nedávnych úloh agentov. |
| get_agent_task | Živý stav a výstup jednej úlohy agenta. |
| steer_agent_task | Pošle bežiacej úlohe agenta ďalší pokyn. |

### Správa servera

Uprav server, ktorý spravuješ: kanály, kategórie, skupiny oprávnení, webhooky a triggery. Každé volanie stále kontroluje tvoje skutočné oprávnenia na správu daného servera.

| Nástroj | Čo robí |
| --- | --- |
| list_manageable_servers | Servery, ktoré môžeš spravovať, a oprávnenia, ktoré na nich máš. |
| get_server_structure | Úplné rozloženie kanálov a kategórií servera. |
| create_channel | Vytvorí kanál. |
| update_channel | Premenuje kanál, zmení jeho typ alebo ho presunie. |
| delete_channel | Zmaže kanál (nevratne). |
| create_category | Vytvorí kategóriu kanálov. |
| update_category | Premenuje kategóriu. |
| delete_category | Zmaže kategóriu (jej kanály zostanú). |
| list_server_groups | Skupiny oprávnení servera. |
| create_server_group | Vytvorí skupinu oprávnení. |
| update_server_group | Premenuje skupinu oprávnení, zmení jej farbu alebo rozsah. |
| delete_server_group | Zmaže skupinu oprávnení. |
| list_members | Zoznam členov servera a ich skupín oprávnení. |
| add_member_to_group | Pridá člena servera do skupiny oprávnení. |
| remove_member_from_group | Odoberie člena servera zo skupiny oprávnení. |
| list_invites | Zoznam aktívnych pozvánok na server. |
| create_invite | Vytvorí pozvánku na server. |
| delete_invite | Zruší pozvánku na server. |
| list_custom_emojis | Zoznam vlastných emoji servera. |
| list_webhooks | Prichádzajúce webhooky servera. |
| create_webhook | Vytvorí prichádzajúci webhook. |
| get_webhook_url | Získa URL webhooku, na ktorú sa dá posielať. |
| update_webhook | Aktualizuje nastavenia webhooku. |
| delete_webhook | Zmaže webhook (jeho URL prestane fungovať). |
| list_triggers | Odchádzajúce triggery servera. |
| create_trigger | Vytvorí trigger (zodpovedajúce správy sa cez POST pošlú na URL). |
| update_trigger | Aktualizuje trigger. |
| delete_trigger | Zmaže trigger. |

### Moderovanie komunity

Tie isté fronty na posúdenie, ktoré v aplikácii otvára tlačidlo so štítom. Hlasovanie a vetá stále vyžadujú skutočný účet moderátora (alebo tímu mssgs).

| Nástroj | Čo robí |
| --- | --- |
| get_moderation_stats | Tvoj stav moderátora a koľko toho čaká. |
| list_moderation_queue | Filtre mapy, ktoré čakajú na hlas moderátora. |
| approve_map_filter | Hlasuje za schválenie odoslaného filtra mapy. |
| deny_map_filter | Hlasuje za zamietnutie odoslaného filtra mapy. |
| list_report_queue | Nahlásený obsah, ktorý čaká na hlas moderátora. |
| approve_report | Hlasuje, že nahlásený obsah porušuje pravidlá. |
| deny_report | Hlasuje, že nahlásený obsah je v poriadku. |
| community_map_propose_filter | Pošle nový filter mapy na posúdenie. |
| veto_map_filter | Iba tím mssgs: okamžite stiahne filter mapy (nevratne). |

### Pomôcky

Drobné pomôcky pre asistentov, ktorí pracujú dlho.

| Nástroj | Čo robí |
| --- | --- |
| keep_computer_awake | Nenechá počítač zaspať, kým pracuješ, alebo ho znova uvoľní. |

## Tvor ďalej