---
title: "MCP: propoj Claude a další AI asistenty s mssgs"
description: "Propoj Claude, Cursor a další AI nástroje s mssgs přes MCP. Lokální server s oprávněními a 127 nástroji: kanály, zprávy, boti, servery a moderace."
canonical: https://docs.mss.gs/cs/mcp
language: cs
---

# Připoj AI asistenta

Desktopová aplikace mssgs má vestavěný MCP server. Připoj Claude, Cursor nebo Codex a budou číst, shrnovat a odpovídat v kanálech, které vybereš, přímo z tvého počítače.

## Co s tím můžeš dělat

- **Čte a shrnuje** Kanály, přímé zprávy, zmínky a připnuté zprávy, jen v kanálech, které zpřístupníš.

- **Píše, když to povolíš** Posílá, odpovídá, reaguje, upravuje a připíná, jakmile zapneš odesílání.

- **Hraje hry** Přijme pozvánku, přečte si herní plochu a hraje skutečné tahy.

- **Kontrolu máš ty** Ve výchozím stavu vypnuto, nejdřív jen čtení, pouze lokálně, pro každý AI nástroj vlastní token, který jde zrušit.

V aplikaci

Zeptáš se ve svém AI nástroji; ten přes MCP server přečte #general a zveřejní shrnutí tvým jménem, protože máš odesílání povolené.

- [Přehled](#overview)

- [Připojení](#connect)

- [Oprávnění a tokeny](#permissions)

- [Události v reálném čase](#events)

- [Nástroje](#tools)

## Přehled

Desktopová aplikace mssgs má vestavěný **MCP server** (Model Context Protocol), díky kterému můžou AI asistenti jako Claude nebo Cursor číst a jednat v tvém pracovním prostoru. Běží lokálně na tvém počítači a komunikuje s tvou přihlášenou relací mssgs; nepotřebuješ žádný zvláštní účet bota ani hosting.

### Ty rozhoduješ, co vidí

Server běží jen na localhost , a jen dokud je aplikace mssgs otevřená a tvůj účet přihlášený. Vybereš, které kanály zpřístupníš, a skupinu po skupině zapneš, co asistent smí dělat. Celkem teď jde o **127 nástrojů** rozdělených do 14 skupin.

## Připojení

Ověření probíhá tokenem Bearer ze [stránky nastavení AI / MCP](https://mss.gs/cs/help/bots-mcp/connect-your-ai) v aplikaci: zapni server, vyber kanály, které chceš zpřístupnit, a stiskni „Copy config“; zkopírovaný blok už obsahuje tvůj port i token. Server naslouchá jen na localhost (výchozí port 7444) a běží, dokud je aplikace mssgs otevřená a tvůj účet přihlášený.

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

V Claude Desktop nebo Cursoru: vlož blok z „Copy config“ do nastavení MCP svého AI nástroje. Podívej se na [návod krok za krokem](https://mss.gs/cs/help/bots-mcp/connect-your-ai) v Centru nápovědy.

## Oprávnění a tokeny

Které nástroje asistent vidí, závisí na přepínačích, které zapneš. Nástroje jen pro čtení jsou zapnuté vždy; všechno ostatní je za přepínačem skupiny. Správa serveru a moderace navíc kontrolují tvá skutečná oprávnění na účtu.

| Skupina | Odemyká |
| --- | --- |
| **Čtení** | Vždy zapnuto: čtení zpráv, přítomnosti, zmínek a připnutých zpráv ve zpřístupněných kanálech |
| **Odesílání a interakce** | Posílání, odpovědi, reakce, úpravy, mazání, připínání, indikátor psaní a k tomu přítomnost v DM, hlasové hovory a hry |
| **Watch party** | Spouštění společného sledování, připojování a jeho ovládání |
| **Žádosti o DM** | Prohlížení, přijímání a odmítání příchozích žádostí o DM |
| **Sociální** | Profily, příběhy a tvoje filtry mapy |
| **Hlasové kanály** | Připojení k hlasovému kanálu, přehled účastníků a ovládání mikrofonu |
| **Účet a soukromí** | Přátelé, blokování, ztlumení, stav přečtení, klipy a sdílení polohy |
| **Řízení agentů** | Nastavení agentů kanálů, projektů a běžících úkolů |
| **Správa serveru** | Kanály, kategorie, skupiny oprávnění, členové, pozvánky, emoji, webhooky a triggery (skutečná oprávnění ke správě dál platí) |
| **Moderace komunity** | Fronty ke kontrole a hlasování (dál je potřeba účet moderátora nebo týmu mssgs) |
| **Nespánek počítače** | Počítač neusne, zatímco asistent pracuje |
| **Nástroje pro účty botů** | Interaktivní embed karty a jejich události (jen účty botů) |

### Tokeny

Tokeny mají jména, jsou zvlášť pro každý AI nástroj a zrušíš je jedním kliknutím; u každého tokenu graf aktivity ukazuje, kdy přesně byl použit. Dobrý zvyk: jeden token na nástroj, se srozumitelným jménem. Ztratil se notebook? Zruš jeho token a je k ničemu.

## Události v reálném čase přes SSE

Otevři MCP endpoint jako stream ( GET /mcp s Accept: text/event-stream ) a notifikace JSON-RPC ti budou chodit hned, jak se něco stane:

| Notifikace | Kdy přijde |
| --- | --- |
| notifications/mssgs/message | Nové zprávy v kanálech, které vidíš |
| notifications/mssgs/bot_event | Stisky tlačítek, reakce a odpovědi na zprávy, které tvůj asistent zveřejnil přes send_bot_message |
| notifications/mssgs/presence | Změny přítomnosti |
| notifications/mssgs/typing | Indikátory psaní |
| notifications/mssgs/call | Události hlasových hovorů |

## Interaktivní karty botů

### Interaktivní karty botů od tvého asistenta

Zveřejni embed kartu s tlačítky přes send_bot_message , poslouchej bot_event ve streamu (nebo se ptej přes get_bot_events ) a uprav kartu na místě pomocí edit_message . Stejný model karet jako v dokumentaci [zpráv botů](https://docs.mss.gs/cs/bots).

## Přehled nástrojů (127)

Každý nástroj níže je skutečná akce v mssgs. Názvy jsou přesné identifikátory MCP. Nástroje se objeví, až když zapneš jejich skupinu.

### Čtení

Nástroje jen pro čtení, dostupné hned po zapnutí serveru. Vidí jen kanály, které zpřístupníš.

| Nástroj | Co dělá |
| --- | --- |
| list_channels | Vypíše kanály zpřístupněné AI nástrojům. |
| read_channel | Přečte poslední zprávy ze zpřístupněného kanálu. |
| get_new_messages | Načte zprávy novější než zadané časové razítko ze všech zpřístupněných kanálů. |
| get_channel_stamp | Stav přečtení kanálu s počtem nepřečtených zpráv a zmínek. |
| get_presence | Kdo je v kanálu přítomný a s jakým stavem. |
| get_message | Načte jednu celou zprávu podle id, včetně embedů a náhledů odkazů. |
| search_messages | Hledá v textu zpráv napříč zpřístupněnými kanály serveru. |
| get_message_context | Přečte zprávy těsně před a po jednom výsledku hledání. |
| get_account | Ukáže přihlášený účet a jeho dostupné možnosti. |
| get_typing | Kdo v kanálu právě píše. |
| list_mentions | Poslední zprávy, které tě @zmiňují. |
| list_pinned_messages | Připnuté zprávy v kanálu. |
| subscribe_channel | Odebírá kanál kvůli aktualizacím v reálném čase. |
| unsubscribe_channel | Zastaví aktualizace kanálu v reálném čase. |
| list_subscriptions | Vypíše kanály, které odebíráš v reálném čase. |

### Odesílání a interakce

Zveřejňování a jednání za přihlášeného uživatele. Všechno tady zapisuje do kanálu, proto je to celé za jedním přepínačem.

| Nástroj | Co dělá |
| --- | --- |
| send_message | Pošle zprávu do kanálu tvým jménem. |
| reply_message | Odpoví na konkrétní zprávu, s odkazem na ni. |
| add_reaction | Přidá ke zprávě emoji reakci. |
| remove_reaction | Odebere jednu z tvých emoji reakcí. |
| edit_message | Upraví jednu z tvých zpráv. |
| delete_message | Smaže jednu z tvých zpráv. |
| pin_message | Připne zprávu (vyžaduje oprávnění k připínání). |
| unpin_message | Odepne připnutou zprávu. |
| open_one_view_attachment | Otevře v DM fotku nebo video k jednorázovému zobrazení. |
| set_typing | Zobrazí živý indikátor „píše…“. |
| stop_typing | Skryje indikátor psaní. |

### Přítomnost v DM a hovory

Přítomnost v DM a skutečné hlasové hovory: start_dm_call používá mikrofon tohoto počítače, přesně jako tlačítko volání v aplikaci.

| Nástroj | Co dělá |
| --- | --- |
| enter_dm_chat | Zobrazí v DM tvou přítomnost. |
| leave_dm_chat | Přestane v DM zobrazovat tvou přítomnost. |
| start_dm_call | Zahájí hlasový hovor v DM (používá mikrofon tohoto počítače). |
| answer_dm_call | Přijme vyzvánějící hovor v DM. |
| decline_dm_call | Odmítne vyzvánějící hovor v DM. |
| end_dm_call | Zavěsí nebo zruší hovor v DM. |
| get_call_status | Aktuální stav hlasového hovoru a případný příchozí hovor. |

### Hry

Připoj se k vestavěným minihrám mssgs a hraj je přímo ze svého asistenta.

| Nástroj | Co dělá |
| --- | --- |
| list_game_invites | Otevřené pozvánky do her, které patří tobě. |
| list_active_games | Herní místnosti, ve kterých právě hraješ. |
| accept_game_invite | Přijme pozvánku podle room_id nebo kódu místnosti. |
| get_game_state | Aktuální herní plocha a stav hry, ve které hraješ. |
| game_move | Zahraje tah ve hře. |
| resign_game | Vzdá hru nebo ji opustí. |

### Watch party

Spouštěj společné sledování a ovládej ho, připoj se do místnosti a reaguj spolu s ostatními v reálném čase.

| Nástroj | Co dělá |
| --- | --- |
| list_watch_parties | Vypíše aktivní watch party, ke kterým máš přístup. |
| get_watch_party | Načte celý stav jedné watch party. |
| start_watch_party | Spustí watch party v kanálu. |
| join_watch_party | Připojí se k aktivní watch party. |
| leave_watch_party | Opustí watch party. |
| control_watch_party | Spustí, pozastaví nebo přetočí přehrávání pro celou místnost. |
| end_watch_party | Ukončí watch party pro všechny. |
| send_watch_party_emote | Pošle do watch party emote v reálném čase. |

### Žádosti o DM

Rozhoduj, kdo s tebou smí začít konverzaci.

| Nástroj | Co dělá |
| --- | --- |
| view_dm_requests | Tvoje otevřené příchozí žádosti o DM. |
| accept_dm_request | Přijme žádost o DM. |
| deny_dm_request | Odmítne žádost o DM. |

### Sociální: profily, příběhy, mapa

Prohlížej profily, sleduj příběhy a podívej se na filtry mapy navržené z tvého účtu.

| Nástroj | Co dělá |
| --- | --- |
| get_profile | Veřejný profil uživatele podle user_guid. |
| list_story_users | Lidé s neviděným příběhem, který si můžeš prohlédnout. |
| view_story | Zobrazí aktivní příběhy uživatele. |
| list_map_filters | Filtry mapy navržené z tohoto účtu, se stavem moderace. |

### Hlasové kanály

Sleduj a ovládej živou relaci hlasového kanálu na tomto počítači.

| Nástroj | Co dělá |
| --- | --- |
| list_voice_channels | Vypíše hlasové kanály na serveru. |
| get_voice_state | Načte aktuální hlasovou relaci a její účastníky. |
| join_voice_channel | Připojí se k hlasovému kanálu na tomto počítači. |
| leave_voice_channel | Opustí aktuální hlasový kanál. |
| set_voice_muted | Ztlumí nebo zapne mikrofon tohoto počítače. |

### Účet a soukromí

Spravuj přátele, blokování, ztlumení, stav přečtení a klipy, bez odhalení tajných údajů účtu.

| Nástroj | Co dělá |
| --- | --- |
| list_friends | Vypíše tvé přátele. |
| list_blocked | Vypíše zablokované účty. |
| block_user | Zablokuje účet. |
| unblock_user | Odblokuje účet. |
| list_mutes | Vypíše ztlumené kanály a servery. |
| mute_channel | Ztlumí kanál. |
| unmute_channel | Zruší ztlumení kanálu. |
| mute_server | Ztlumí server. |
| unmute_server | Zruší ztlumení serveru. |
| mark_channel_read | Označí kanál jako přečtený. |
| list_clips | Vypíše klipy, které máš vytvořené. |
| share_clip | Zpřístupní jeden z tvých klipů ke sdílení. |
| unshare_clip | Přestane klip sdílet. |
| rename_clip | Přejmenuje jeden z tvých klipů. |
| list_stickers | Vypíše nálepky, které máš k dispozici. |
| list_friend_locations | Vypíše přátele, kteří s tebou právě sdílejí polohu. |
| list_location_viewers | Vypíše, kdo teď vidí tvou polohu. |

### Nástroje pro účty botů

Zveřejňuj interaktivní embed karty a čti interakce s nimi. Dostupné po přihlášení účtem bota.

| Nástroj | Co dělá |
| --- | --- |
| send_bot_message | Zveřejní bohatou embed kartu s volitelnými tlačítky (jen účty botů). |
| get_bot_events | Zjistí stisky tlačítek, reakce a odpovědi na zprávy tvého bota. |
| set_bot_status | Nastaví nebo smaže vlastní stav přítomnosti (jen účty botů). |

### Řízení agentů

Nastav agenty kanálů, připoj projekty, sleduj běžící úkoly a řiď práci z chatu. Akce správy dál vyžadují oprávnění ke kanálu.

| Nástroj | Co dělá |
| --- | --- |
| list_agent_channels | Vypíše zpřístupněné kanály a nastavení jejich agentů. |
| get_channel_agents | Načte celou konfiguraci agentů kanálu. |
| set_channel_agents | Zapne agenty a aktualizuje pravidla agentů kanálu. |
| add_channel_agent | Přidá do kanálu dostupného agenta. |
| remove_channel_agent | Odebere agenta z kanálu. |
| set_agent_project | Připojí k agentovi kanálu projekt a instrukce. |
| remove_agent_project | Odpojí projekt od agenta kanálu. |
| list_agent_tasks | Vypíše aktuální a nedávné úkoly agentů. |
| get_agent_task | Načte živý stav a výstup jednoho úkolu agenta. |
| steer_agent_task | Pošle běžícímu úkolu agenta další instrukci. |

### Správa serveru

Uprav server, který spravuješ: kanály, kategorie, skupiny oprávnění, webhooky a triggery. Každé volání dál kontroluje tvá skutečná oprávnění ke správě toho serveru.

| Nástroj | Co dělá |
| --- | --- |
| list_manageable_servers | Servery, které můžeš spravovat, a oprávnění, která na nich máš. |
| get_server_structure | Celé rozložení kanálů a kategorií serveru. |
| create_channel | Vytvoří kanál. |
| update_channel | Přejmenuje kanál, změní jeho typ nebo ho přesune. |
| delete_channel | Smaže kanál (nevratně). |
| create_category | Vytvoří kategorii kanálů. |
| update_category | Přejmenuje kategorii. |
| delete_category | Smaže kategorii (její kanály zůstanou). |
| list_server_groups | Skupiny oprávnění serveru. |
| create_server_group | Vytvoří skupinu oprávnění. |
| update_server_group | Přejmenuje skupinu oprávnění, změní její barvu nebo rozsah. |
| delete_server_group | Smaže skupinu oprávnění. |
| list_members | Vypíše členy serveru a jejich skupiny oprávnění. |
| add_member_to_group | Přidá člena serveru do skupiny oprávnění. |
| remove_member_from_group | Odebere člena serveru ze skupiny oprávnění. |
| list_invites | Vypíše aktivní pozvánky na server. |
| create_invite | Vytvoří pozvánku na server. |
| delete_invite | Zruší pozvánku na server. |
| list_custom_emojis | Vypíše vlastní emoji serveru. |
| list_webhooks | Příchozí webhooky serveru. |
| create_webhook | Vytvoří příchozí webhook. |
| get_webhook_url | Načte URL webhooku, na kterou se dá posílat. |
| update_webhook | Aktualizuje nastavení webhooku. |
| delete_webhook | Smaže webhook (jeho URL přestane fungovat). |
| list_triggers | Odchozí triggery serveru. |
| create_trigger | Vytvoří trigger (odpovídající zprávy se pošlou metodou POST na URL). |
| update_trigger | Aktualizuje trigger. |
| delete_trigger | Smaže trigger. |

### Moderace komunity

Stejné fronty ke kontrole, jaké v aplikaci otevře tlačítko se štítem. Hlasování a veta dál vyžadují skutečný účet moderátora (nebo týmu mssgs).

| Nástroj | Co dělá |
| --- | --- |
| get_moderation_stats | Tvůj stav moderátora a kolik toho čeká. |
| list_moderation_queue | Filtry mapy, které čekají na hlas moderátora. |
| approve_map_filter | Hlasuje pro schválení navrženého filtru mapy. |
| deny_map_filter | Hlasuje pro zamítnutí navrženého filtru mapy. |
| list_report_queue | Nahlášený obsah, který čeká na hlas moderátora. |
| approve_report | Hlasuje, že nahlášený obsah porušuje pravidla. |
| deny_report | Hlasuje, že nahlášený obsah je v pořádku. |
| community_map_propose_filter | Navrhne nový filtr mapy ke kontrole. |
| veto_map_filter | Jen tým mssgs: okamžitě stáhne filtr mapy (nevratně). |

### Pomocné nástroje

Drobní pomocníci pro asistenty, kteří pracují dlouho.

| Nástroj | Co dělá |
| --- | --- |
| keep_computer_awake | Nenechá počítač usnout, zatímco pracuješ, nebo ho zase uvolní. |

## Tvoř dál