---
title: "MCP: połącz Claude i innych asystentów AI z mssgs"
description: "Połącz Claude, Cursor i inne narzędzia AI z mssgs przez MCP. Lokalny serwer z uprawnieniami i 127 narzędziami: kanały, wiadomości, boty, serwery i moderacja."
canonical: https://docs.mss.gs/pl/mcp
language: pl
---

# 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 podsumowuje** Kanały, DM-y, wzmianki i przypięte wiadomości, tylko na kanałach, które udostępnisz.

- **Pisze, gdy pozwolisz** Wysyła, odpowiada, reaguje, edytuje i przypina, kiedy włączysz wysyłanie.

- **Gra w gry** Przyjmuje zaproszenie, odczytuje planszę i wykonuje prawdziwe ruchy.

- **Kontrola po twojej stronie** Domyś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](#overview)

- [Połączenie](#connect)

- [Uprawnienia i tokeny](#permissions)

- [Zdarzenia na żywo](#events)

- [Narzędzia](#tools)

## 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

Uwierzytelnianie tokenem Bearer ze [strony ustawień AI / MCP](https://mss.gs/pl/help/bots-mcp/connect-your-ai) 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.

```bash
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](https://mss.gs/pl/help/bots-mcp/connect-your-ai) 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](https://docs.mss.gs/pl/bots).

## 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

Narzę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

Publikowanie 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

Obecność 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

Dołą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

Rozpoczynanie 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

Decyduj, 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. |

### Społecznościowe: profile, relacje, mapa

Sprawdzaj profile, oglądaj relacje i przeglądaj filtry mapy zgłoszone z twojego konta.

| Narzędzie | Co robi |
| --- | --- |
| get_profile | Publiczny profil użytkownika po user_guid. |
| list_story_users | Osoby z nieobejrzaną relacją, którą możesz zobaczyć. |
| view_story | Wyświetla aktywne relacje użytkownika. |
| list_map_filters | Filtry mapy zgłoszone z tego konta, ze stanem moderacji. |

### Kanały głosowe

Podglą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ść

Zarzą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

Publikuj 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

Konfiguruj 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

Kształ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

Te 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

Drobne 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ę. |

## Buduj dalej