Podłącz asystenta AI
Aplikacja desktopowa mssgs ma wbudowany serwer MCP. Podłącz Claude, Cursor albo Codex, a będą czytać, podsumowywać i odpowiadać na wybranych przez ciebie kanałach, prosto z twojego komputera.
Co możesz z tym zrobić
- Czyta i podsumowujeKanały, DM-y, wzmianki i przypięte wiadomości, tylko na kanałach, które udostępnisz.
- Pisze, gdy pozwoliszWysyła, odpowiada, reaguje, edytuje i przypina, kiedy włączysz wysyłanie.
- Gra w gryPrzyjmuje zaproszenie, odczytuje planszę i wykonuje prawdziwe ruchy.
- Kontrola po twojej stronieDomyślnie wyłączone, najpierw tylko odczyt, wyłącznie lokalnie, osobny token do odwołania dla każdego narzędzia AI.
W aplikacji
Pytasz w swoim narzędziu AI; ono czyta #general przez serwer MCP i publikuje podsumowanie w twoim imieniu, bo masz włączone wysyłanie.
Przegląd
Aplikacja desktopowa mssgs ma wbudowany serwer MCP (Model Context Protocol), dzięki któremu asystenci AI, tacy jak Claude czy Cursor, mogą czytać i działać w twojej przestrzeni roboczej. Serwer działa lokalnie na twoim komputerze i komunikuje się z twoją zalogowaną sesją mssgs; nie potrzebujesz osobnego konta bota ani hostingu.
Ty decydujesz, co widzi
Serwer działa tylko na localhost, gdy mssgs jest otwarty, a twoje konto zalogowane. Wybierasz, które kanały udostępnić, i grupa po grupie włączasz, co asystent może robić. Obecnie serwer oferuje 127 narzędzi w 14 grupach.
Połączenie
http://127.0.0.1:7444/mcp
Uwierzytelnianie tokenem Bearer ze strony ustawień AI / MCP w aplikacji: włącz serwer, wybierz kanały do udostępnienia i naciśnij „Copy config”; skopiowany blok zawiera już twój port i token. Serwer nasłuchuje tylko na localhost (domyślny port 7444) i działa, gdy mssgs jest otwarty, a twoje konto zalogowane.
claude mcp add --transport http mssgs http://127.0.0.1:7444/mcp \
--header "Authorization: Bearer <your-token>"
W Claude Desktop albo Cursorze: wklej blok z „Copy config” do ustawień MCP swojego narzędzia AI. Zobacz przewodnik krok po kroku w Centrum pomocy.
Uprawnienia i tokeny
To, jakie narzędzia widzi asystent, zależy od włączonych przez ciebie przełączników. Narzędzia tylko do odczytu są zawsze włączone; wszystko inne jest za przełącznikiem grupy. Zarządzanie serwerem i moderacja dodatkowo sprawdzają twoje rzeczywiste uprawnienia na koncie.
| Grupa | Odblokowuje |
|---|---|
| Odczyt | Zawsze włączone: odczyt wiadomości, obecności, wzmianek i przypięć na udostępnionych kanałach |
| Wysyłanie i interakcje | Wysyłanie, odpowiedzi, reakcje, edycja, usuwanie, przypinanie, wskaźnik pisania, a także obecność w DM-ach, rozmowy głosowe i gry |
| Watch party | Rozpoczynanie wspólnych seansów, dołączanie do nich i sterowanie nimi |
| Prośby o DM | Przeglądanie, akceptowanie i odrzucanie przychodzących próśb o DM |
| Społecznościowe | Profile, relacje i twoje filtry mapy |
| Kanały głosowe | Dołączanie do kanałów głosowych, podgląd uczestników i sterowanie mikrofonem |
| Konto i prywatność | Znajomi, blokady, wyciszenia, stan przeczytania, klipy i udostępnianie lokalizacji |
| Sterowanie agentami | Konfiguracja agentów kanałów, projektów i bieżących zadań |
| Zarządzanie serwerem | Kanały, kategorie, grupy uprawnień, członkowie, zaproszenia, emoji, webhooki i triggery (rzeczywiste uprawnienia do zarządzania nadal obowiązują) |
| Moderacja społeczności | Kolejki weryfikacji i głosowania (nadal wymagane konto moderatora lub zespołu mssgs) |
| Blokada uśpienia komputera | Komputer nie zasypia, gdy asystent pracuje |
| Narzędzia kont botów | Interaktywne karty embed i ich zdarzenia (tylko konta botów) |
Tokeny
Tokeny mają nazwy, są osobne dla każdego narzędzia AI i można je odwołać jednym kliknięciem; wykres aktywności przy każdym tokenie pokazuje dokładnie, kiedy go użyto. Dobra praktyka: jeden token na narzędzie, z czytelną nazwą. Zgubiony laptop? Odwołaj jego token, a stanie się bezużyteczny.
Zdarzenia na żywo przez SSE
Otwórz endpoint MCP jako strumień (GET /mcp z Accept: text/event-stream), a powiadomienia JSON-RPC będą przychodzić na bieżąco:
| Powiadomienie | Czego dotyczy |
|---|---|
notifications/mssgs/message | Nowe wiadomości na kanałach, które widzisz |
notifications/mssgs/bot_event | Naciśnięcia przycisków, reakcje i odpowiedzi na wiadomości, które asystent opublikował przez send_bot_message |
notifications/mssgs/presence | Zmiany obecności |
notifications/mssgs/typing | Wskaźniki pisania |
notifications/mssgs/call | Zdarzenia rozmów głosowych |
Interaktywne karty botów
Interaktywne karty botów od twojego asystenta
Opublikuj kartę embed z przyciskami przez send_bot_message, nasłuchuj bot_event w strumieniu (albo odpytuj get_bot_events) i aktualizuj kartę w miejscu przez edit_message. Ten sam model kart co w dokumentacji wiadomości botów.
Spis narzędzi (127)
Każde narzędzie poniżej to prawdziwa akcja w mssgs. Nazwy to dokładne identyfikatory MCP. Narzędzia pojawiają się dopiero po włączeniu ich grupy.
Odczyt
Zawsze włączoneNarzędzia tylko do odczytu, dostępne od chwili włączenia serwera. Widzą wyłącznie kanały, które udostępniasz.
| Narzędzie | Co robi |
|---|---|
list_channels |
Lista kanałów udostępnionych narzędziom AI. |
read_channel |
Odczytuje ostatnie wiadomości z udostępnionego kanału. |
get_new_messages |
Pobiera wiadomości nowsze niż podany znacznik czasu ze wszystkich udostępnionych kanałów. |
get_channel_stamp |
Stan przeczytania kanału z liczbą nieprzeczytanych wiadomości i wzmianek. |
get_presence |
Kto jest obecny na kanale i z jakim statusem. |
get_message |
Pobiera jedną pełną wiadomość po id, z embedami i podglądami linków. |
search_messages |
Przeszukuje tekst wiadomości na udostępnionych kanałach serwera. |
get_message_context |
Odczytuje wiadomości tuż przed i po jednym wyniku wyszukiwania. |
get_account |
Pokazuje zalogowane konto i dostępne dla niego możliwości. |
get_typing |
Kto właśnie pisze na kanale. |
list_mentions |
Ostatnie wiadomości z @wzmianką o tobie. |
list_pinned_messages |
Przypięte wiadomości na kanale. |
subscribe_channel |
Subskrybuje kanał, aby dostawać aktualizacje na żywo. |
unsubscribe_channel |
Wyłącza aktualizacje na żywo dla kanału. |
list_subscriptions |
Lista kanałów, które subskrybujesz na żywo. |
Wysyłanie i interakcje
Przełącznik: wysyłaniePublikowanie i działanie jako zalogowany użytkownik. Wszystko tutaj zapisuje coś na kanale, więc całość jest za jednym przełącznikiem.
| Narzędzie | Co robi |
|---|---|
send_message |
Wysyła wiadomość na kanał w twoim imieniu. |
reply_message |
Odpowiada na konkretną wiadomość, w wątku. |
add_reaction |
Dodaje reakcję emoji do wiadomości. |
remove_reaction |
Usuwa jedną z twoich reakcji emoji. |
edit_message |
Edytuje jedną z twoich wiadomości. |
delete_message |
Usuwa jedną z twoich wiadomości. |
pin_message |
Przypina wiadomość (wymaga uprawnienia do przypinania). |
unpin_message |
Odpina przypiętą wiadomość. |
open_one_view_attachment |
Otwiera w DM-ie zdjęcie lub film do jednorazowego obejrzenia. |
set_typing |
Pokazuje na żywo wskaźnik „pisze…”. |
stop_typing |
Usuwa wskaźnik pisania. |
Obecność w DM-ach i rozmowy
Przełącznik: wysyłanieObecność w DM-ie i prawdziwe rozmowy głosowe: start_dm_call używa mikrofonu tego komputera, dokładnie tak jak przycisk połączenia w aplikacji.
| Narzędzie | Co robi |
|---|---|
enter_dm_chat |
Oznacza twoją obecność w DM-ie. |
leave_dm_chat |
Przestaje oznaczać twoją obecność w DM-ie. |
start_dm_call |
Rozpoczyna rozmowę głosową w DM-ie (używa mikrofonu tego komputera). |
answer_dm_call |
Odbiera przychodzące połączenie w DM-ie. |
decline_dm_call |
Odrzuca przychodzące połączenie w DM-ie. |
end_dm_call |
Rozłącza lub anuluje rozmowę w DM-ie. |
get_call_status |
Bieżący stan rozmowy głosowej i ewentualne połączenie przychodzące. |
Gry
Przełącznik: wysyłanieDołączaj do wbudowanych minigier mssgs i graj w nie prosto z asystenta.
| Narzędzie | Co robi |
|---|---|
list_game_invites |
Otwarte zaproszenia do gier skierowane do ciebie. |
list_active_games |
Pokoje gier, w których właśnie grasz. |
accept_game_invite |
Przyjmuje zaproszenie po room_id albo kodzie pokoju. |
get_game_state |
Bieżąca plansza i stan gry, w której bierzesz udział. |
game_move |
Wykonuje ruch w grze. |
resign_game |
Poddaje grę albo ją opuszcza. |
Watch party
Przełącznik: watch partyRozpoczynanie wspólnych seansów i sterowanie nimi, dołączanie do pokoju i wspólne reakcje na żywo.
| Narzędzie | Co robi |
|---|---|
list_watch_parties |
Lista aktywnych watch party, do których masz dostęp. |
get_watch_party |
Pełny stan jednego watch party. |
start_watch_party |
Rozpoczyna watch party na kanale. |
join_watch_party |
Dołącza do aktywnego watch party. |
leave_watch_party |
Opuszcza watch party. |
control_watch_party |
Odtwarza, pauzuje lub przewija dla całego pokoju. |
end_watch_party |
Kończy watch party dla wszystkich. |
send_watch_party_emote |
Wysyła emotkę na żywo do watch party. |
Prośby o DM
Przełącznik: prośby o DMDecyduj, kto może zacząć z tobą rozmowę.
| Narzędzie | Co robi |
|---|---|
view_dm_requests |
Twoje otwarte przychodzące prośby o DM. |
accept_dm_request |
Akceptuje prośbę o DM. |
deny_dm_request |
Odrzuca prośbę o DM. |
Kanały głosowe
Przełącznik: kanały głosowePodgląd bieżącej sesji kanału głosowego na tym komputerze i sterowanie nią.
| Narzędzie | Co robi |
|---|---|
list_voice_channels |
Lista kanałów głosowych na serwerze. |
get_voice_state |
Bieżąca sesja głosowa i jej uczestnicy. |
join_voice_channel |
Dołącza do kanału głosowego na tym komputerze. |
leave_voice_channel |
Opuszcza bieżący kanał głosowy. |
set_voice_muted |
Wycisza lub włącza mikrofon tego komputera. |
Konto i prywatność
Przełącznik: kontoZarządzaj znajomymi, blokadami, wyciszeniami, stanem przeczytania i klipami bez ujawniania sekretów konta.
| Narzędzie | Co robi |
|---|---|
list_friends |
Lista twoich znajomych. |
list_blocked |
Lista kont, które blokujesz. |
block_user |
Blokuje konto. |
unblock_user |
Odblokowuje konto. |
list_mutes |
Lista wyciszonych kanałów i serwerów. |
mute_channel |
Wycisza kanał. |
unmute_channel |
Wyłącza wyciszenie kanału. |
mute_server |
Wycisza serwer. |
unmute_server |
Wyłącza wyciszenie serwera. |
mark_channel_read |
Oznacza kanał jako przeczytany. |
list_clips |
Lista utworzonych przez ciebie klipów. |
share_clip |
Udostępnia jeden z twoich klipów. |
unshare_clip |
Przestaje udostępniać klip. |
rename_clip |
Zmienia nazwę jednego z twoich klipów. |
list_stickers |
Lista dostępnych dla ciebie naklejek. |
list_friend_locations |
Lista znajomych, którzy teraz udostępniają ci swoją lokalizację. |
list_location_viewers |
Lista osób, które teraz widzą twoją lokalizację. |
Narzędzia kont botów
Przełącznik: bot · tylko konta botówPublikuj interaktywne karty embed i odczytuj interakcje z nimi. Dostępne po zalogowaniu na konto bota.
| Narzędzie | Co robi |
|---|---|
send_bot_message |
Publikuje rozbudowaną kartę embed z opcjonalnymi przyciskami (tylko konta botów). |
get_bot_events |
Odpytuje o naciśnięcia przycisków, reakcje i odpowiedzi na wiadomości twojego bota. |
set_bot_status |
Ustawia lub usuwa własny status obecności (tylko konta botów). |
Sterowanie agentami
Przełącznik: sterowanie agentamiKonfiguruj agentów kanałów, dołączaj projekty, podglądaj bieżące zadania i steruj pracą z czatu. Działania administracyjne nadal wymagają uprawnień do kanału.
| Narzędzie | Co robi |
|---|---|
list_agent_channels |
Lista udostępnionych kanałów i konfiguracji ich agentów. |
get_channel_agents |
Pełna konfiguracja agentów kanału. |
set_channel_agents |
Włącza agentów i aktualizuje reguły agentów kanału. |
add_channel_agent |
Dodaje dostępnego agenta do kanału. |
remove_channel_agent |
Usuwa agenta z kanału. |
set_agent_project |
Dołącza projekt i instrukcje do agenta kanału. |
remove_agent_project |
Odłącza projekt od agenta kanału. |
list_agent_tasks |
Lista bieżących i ostatnich zadań agentów. |
get_agent_task |
Bieżący stan i wynik jednego zadania agenta. |
steer_agent_task |
Wysyła kolejną instrukcję do trwającego zadania agenta. |
Zarządzanie serwerem
Przełącznik: zarządzanie serwerem · wymaga uprawnień do zarządzaniaKształtuj serwer, którym zarządzasz: kanały, kategorie, grupy uprawnień, webhooki i triggery. Każde wywołanie nadal sprawdza twoje rzeczywiste uprawnienia do zarządzania tym serwerem.
| Narzędzie | Co robi |
|---|---|
list_manageable_servers |
Serwery, którymi możesz zarządzać, i uprawnienia, które na nich masz. |
get_server_structure |
Pełny układ kanałów i kategorii serwera. |
create_channel |
Tworzy kanał. |
update_channel |
Zmienia nazwę, typ lub położenie kanału. |
delete_channel |
Usuwa kanał (nieodwracalnie). |
create_category |
Tworzy kategorię kanałów. |
update_category |
Zmienia nazwę kategorii. |
delete_category |
Usuwa kategorię (jej kanały zostają). |
list_server_groups |
Grupy uprawnień serwera. |
create_server_group |
Tworzy grupę uprawnień. |
update_server_group |
Zmienia nazwę, kolor lub zakres grupy uprawnień. |
delete_server_group |
Usuwa grupę uprawnień. |
list_members |
Lista członków serwera i ich grup uprawnień. |
add_member_to_group |
Dodaje członka serwera do grupy uprawnień. |
remove_member_from_group |
Usuwa członka serwera z grupy uprawnień. |
list_invites |
Lista aktywnych zaproszeń na serwer. |
create_invite |
Tworzy zaproszenie na serwer. |
delete_invite |
Unieważnia zaproszenie na serwer. |
list_custom_emojis |
Lista własnych emoji serwera. |
list_webhooks |
Przychodzące webhooki serwera. |
create_webhook |
Tworzy przychodzący webhook. |
get_webhook_url |
Pobiera URL webhooka, na który można publikować. |
update_webhook |
Aktualizuje ustawienia webhooka. |
delete_webhook |
Usuwa webhook (jego URL przestaje działać). |
list_triggers |
Wychodzące triggery serwera. |
create_trigger |
Tworzy trigger (pasujące wiadomości są wysyłane POST-em na URL). |
update_trigger |
Aktualizuje trigger. |
delete_trigger |
Usuwa trigger. |
Moderacja społeczności
Przełącznik: moderacja · tylko moderatorzy i zespół mssgsTe same kolejki weryfikacji, które w aplikacji otwiera przycisk z tarczą. Głosy i weta nadal wymagają prawdziwego konta moderatora (lub zespołu mssgs).
| Narzędzie | Co robi |
|---|---|
get_moderation_stats |
Twój status moderatora i ile czeka na decyzję. |
list_moderation_queue |
Filtry mapy czekające na głos moderatora. |
approve_map_filter |
Głosuje za zatwierdzeniem zgłoszonego filtra mapy. |
deny_map_filter |
Głosuje za odrzuceniem zgłoszonego filtra mapy. |
list_report_queue |
Zgłoszone treści czekające na głos moderatora. |
approve_report |
Głosuje, że zgłoszona treść łamie zasady. |
deny_report |
Głosuje, że zgłoszona treść jest w porządku. |
community_map_propose_filter |
Zgłasza nowy filtr mapy do weryfikacji. |
veto_map_filter |
Tylko zespół mssgs: natychmiast usuwa filtr mapy (nieodwracalnie). |
Narzędzia pomocnicze
Przełącznik: blokada uśpieniaDrobne pomoce dla asystentów, które pracują długo.
| Narzędzie | Co robi |
|---|---|
keep_computer_awake |
Nie pozwala komputerowi zasnąć, gdy pracujesz, albo zwalnia tę blokadę. |