---
title: "MCP: Claude und andere KI-Assistenten mit mssgs verbinden"
description: "Verbinde Claude, Cursor und andere KI-Tools über MCP mit mssgs. Ein lokaler Server mit Berechtigungen und 127 Tools: Kanäle lesen, Nachrichten senden und mehr."
canonical: https://docs.mss.gs/de/mcp
language: de
---

# Einen KI-Assistenten verbinden

In die mssgs-Desktop-App ist ein MCP-Server eingebaut. Verbinde Claude, Cursor oder Codex, und sie können in den Kanälen, die du auswählst, lesen, zusammenfassen und antworten, direkt von deinem eigenen Computer aus.

## Was du damit machen kannst

- **Lesen und zusammenfassen** Kanäle, DMs, Erwähnungen und angepinnte Nachrichten, nur in den Kanälen, die du freigibst.

- **Schreiben, wenn du es erlaubst** Senden, antworten, reagieren, bearbeiten und anpinnen, sobald du das Senden einschaltest.

- **Spiele spielen** Eine Einladung annehmen, das Spielfeld lesen und echte Züge machen.

- **Die Kontrolle behalten** Standardmäßig aus, zuerst nur lesend, nur lokal, ein widerrufbares Token pro KI-Tool.

In der App

Du fragst in deinem KI-Tool; es liest #general über den MCP-Server und postet die Zusammenfassung in deinem Namen, weil du das Senden erlaubt hast.

- [Überblick](#overview)

- [Verbinden](#connect)

- [Berechtigungen & Tokens](#permissions)

- [Echtzeit-Events](#events)

- [Tools](#tools)

## Überblick

Die mssgs-Desktop-App bringt einen eingebauten **MCP-Server** (Model Context Protocol) mit, sodass KI-Assistenten wie Claude oder Cursor in deinem Workspace lesen und handeln können. Er läuft lokal auf deinem Rechner und spricht mit deiner angemeldeten mssgs-Session; kein separates Bot-Konto und kein Hosting nötig.

### Du entscheidest, was er sieht

Der Server läuft nur auf localhost , solange mssgs geöffnet ist und du angemeldet bist. Du wählst, welche Kanäle du freigibst, und schaltest Gruppe für Gruppe ein, was der Assistent tun darf. Aktuell gibt es **127 Tools** in 14 Gruppen.

## Verbinden

Authentifiziert mit einem Bearer-Token von der [KI-/MCP-Einstellungsseite](https://mss.gs/de/help/bots-mcp/connect-your-ai) der App: Aktiviere den Server, wähle die Kanäle, die du freigeben willst, und drück auf „Konfig kopieren“; der kopierte Block enthält bereits deinen Port und dein Token. Der Server lauscht nur auf localhost (Standardport 7444) und läuft, solange mssgs geöffnet ist und du angemeldet bist.

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

Für Claude Desktop oder Cursor: Füge den Block aus „Konfig kopieren“ in die MCP-Einstellungen deines KI-Tools ein. Siehe die [Schritt-für-Schritt-Anleitung](https://mss.gs/de/help/bots-mcp/connect-your-ai) im Hilfe-Center.

## Berechtigungen & Tokens

Welche Tools ein Assistent sieht, hängt von den Schaltern ab, die du einschaltest. Lese-Tools sind immer aktiv; alles andere liegt hinter einem Gruppenschalter. Serververwaltung und Moderation prüfen zusätzlich deine echten Berechtigungen auf dem Konto.

| Gruppe | Schaltet frei |
| --- | --- |
| **Lesen** | Immer aktiv: Nachrichten, Anwesenheit, Erwähnungen und angepinnte Nachrichten in freigegebenen Kanälen lesen |
| **Senden & Interagieren** | Senden, antworten, reagieren, bearbeiten, löschen, anpinnen, tippen, dazu DM-Anwesenheit, Sprachanrufe und Spiele |
| **Watch-Partys** | Gemeinsame Anschauen-Sessions starten, ihnen beitreten und sie steuern |
| **DM-Anfragen** | Eingehende DM-Anfragen ansehen, annehmen und ablehnen |
| **Social** | Profile, Storys und deine Kartenfilter |
| **Sprachkanäle** | Sprachkanälen beitreten, Teilnehmer einsehen und dein Mikrofon steuern |
| **Konto & Privatsphäre** | Freunde, Blockierungen, Stummschaltungen, Lesestatus, Clips und Standortfreigabe |
| **Agentensteuerung** | Kanal-Agenten, Projekte und laufende Aufgaben konfigurieren |
| **Serververwaltung** | Kanäle, Kategorien, Berechtigungsgruppen, Mitglieder, Einladungen, Emojis, Webhooks und Trigger (echte Verwaltungsrechte werden weiterhin geprüft) |
| **Community-Moderation** | Prüf-Warteschlangen und Abstimmungen (Moderatoren- oder Staff-Konto weiterhin nötig) |
| **Computer wach halten** | Verhindern, dass der Rechner einschläft, während der Assistent arbeitet |
| **Bot-Konto-Tools** | Interaktive Embed-Karten und ihre Events (nur Bot-Konten) |

### Tokens

Tokens haben einen Namen, gelten pro KI-Tool und lassen sich mit einem Klick widerrufen, mit einer Aktivitätskurve pro Token, damit du genau siehst, wann welches benutzt wurde. Gute Praxis: ein Token pro Tool, klar benannt. Laptop verloren? Widerrufe sein Token, und es ist nutzlos.

## Echtzeit-Events über SSE

Öffne den MCP-Endpoint als Stream ( GET /mcp mit Accept: text/event-stream ), und du bekommst JSON-RPC-Notifications, sobald etwas passiert:

| Notification | Wird ausgelöst bei |
| --- | --- |
| notifications/mssgs/message | Neue Nachrichten in Kanälen, die du sehen kannst |
| notifications/mssgs/bot_event | Button-Klicks, Reaktionen und Antworten auf Nachrichten, die dein Assistent über send_bot_message gepostet hat |
| notifications/mssgs/presence | Änderungen der Anwesenheit |
| notifications/mssgs/typing | Tipp-Anzeigen |
| notifications/mssgs/call | Ereignisse bei Sprachanrufen |

## Interaktive Bot-Karten

### Interaktive Bot-Karten von deinem Assistenten

Poste eine Embed-Karte mit Buttons über send_bot_message , lausche auf bot_event im Stream (oder frag get_bot_events ab) und aktualisiere die Karte an Ort und Stelle mit edit_message . Dasselbe Kartenmodell wie in der Doku zu [Bot-Nachrichten](https://docs.mss.gs/de/bots).

## Tool-Referenz (127)

Jedes Tool unten ist eine echte Aktion in mssgs. Die Namen sind die exakten MCP-Bezeichner. Tools erscheinen erst, wenn ihre Gruppe eingeschaltet ist.

### Lesen

Nur-Lese-Tools, verfügbar, sobald der Server läuft. Sie sehen immer nur die Kanäle, die du freigegeben hast.

| Tool | Was es tut |
| --- | --- |
| list_channels | Die Kanäle auflisten, die du für KI-Tools freigegeben hast. |
| read_channel | Neueste Nachrichten aus einem freigegebenen Kanal lesen. |
| get_new_messages | Nachrichten, die neuer als ein Zeitstempel sind, aus allen freigegebenen Kanälen abrufen. |
| get_channel_stamp | Gelesen/ungelesen-Status eines Kanals, mit Zahl der ungelesenen Nachrichten und Erwähnungen. |
| get_presence | Wer in einem Kanal anwesend ist, und mit welchem Status. |
| get_message | Eine vollständige Nachricht per ID abrufen, inklusive Embeds und Link-Vorschauen. |
| search_messages | Nachrichtentext in den freigegebenen Kanälen eines Servers durchsuchen. |
| get_message_context | Die Nachrichten direkt um ein Suchergebnis herum lesen. |
| get_account | Das angemeldete Konto und seine verfügbaren Fähigkeiten anzeigen. |
| get_typing | Wer gerade in einem Kanal tippt. |
| list_mentions | Neueste Nachrichten, die dich @erwähnen. |
| list_pinned_messages | Die angepinnten Nachrichten in einem Kanal. |
| subscribe_channel | Einen Kanal für Echtzeit-Updates abonnieren. |
| unsubscribe_channel | Echtzeit-Updates für einen Kanal beenden. |
| list_subscriptions | Die Kanäle auflisten, die du für Echtzeit-Updates abonniert hast. |

### Senden & Interagieren

Als angemeldeter Nutzer posten und handeln. Alles hier schreibt in einen Kanal, deshalb liegt es hinter einem Schalter.

| Tool | Was es tut |
| --- | --- |
| send_message | Eine Nachricht als du in einen Kanal senden. |
| reply_message | Auf eine bestimmte Nachricht antworten, als Thread. |
| add_reaction | Einer Nachricht eine Emoji-Reaktion hinzufügen. |
| remove_reaction | Eine deiner Emoji-Reaktionen entfernen. |
| edit_message | Eine deiner eigenen Nachrichten bearbeiten. |
| delete_message | Eine deiner eigenen Nachrichten löschen. |
| pin_message | Eine Nachricht anpinnen (braucht die Anpinn-Berechtigung). |
| unpin_message | Eine angepinnte Nachricht lösen. |
| open_one_view_attachment | Ein Einmal-Foto oder -Video in einer DM öffnen. |
| set_typing | Eine Live-Anzeige „tippt…“ zeigen. |
| stop_typing | Die Tipp-Anzeige entfernen. |

### DM-Anwesenheit & Anrufe

In einer DM anwesend sein und echte Sprachanrufe führen: start_dm_call nutzt das Mikrofon dieses Computers, genau wie ein Druck auf Anrufen in der App.

| Tool | Was es tut |
| --- | --- |
| enter_dm_chat | Dich in einer DM als anwesend zeigen. |
| leave_dm_chat | Dich in einer DM nicht mehr als anwesend zeigen. |
| start_dm_call | Einen Sprachanruf in einer DM starten (nutzt das Mikrofon dieses Computers). |
| answer_dm_call | Einen klingelnden DM-Anruf annehmen. |
| decline_dm_call | Einen klingelnden DM-Anruf ablehnen. |
| end_dm_call | Einen DM-Anruf auflegen oder abbrechen. |
| get_call_status | Aktueller Zustand des Sprachanrufs und eingehende Anrufe. |

### Spiele

Den eingebauten Minispielen von mssgs direkt aus deinem Assistenten beitreten und sie spielen.

| Tool | Was es tut |
| --- | --- |
| list_game_invites | Offene Spieleinladungen an dich. |
| list_active_games | Spielräume, in denen du gerade spielst. |
| accept_game_invite | Eine Einladung per room_id oder Beitrittscode annehmen. |
| get_game_state | Das Live-Brett bzw. den Zustand eines Spiels, in dem du bist. |
| game_move | Einen Zug in einem Spiel machen. |
| resign_game | Ein Spiel aufgeben oder verlassen. |

### Watch-Partys

Gemeinsame Anschauen-Sessions starten und steuern, dem Raum beitreten und zusammen in Echtzeit reagieren.

| Tool | Was es tut |
| --- | --- |
| list_watch_parties | Aktive Watch-Partys auflisten, auf die du Zugriff hast. |
| get_watch_party | Den vollständigen Zustand einer Watch-Party abrufen. |
| start_watch_party | Eine Watch-Party in einem Kanal starten. |
| join_watch_party | Einer aktiven Watch-Party beitreten. |
| leave_watch_party | Eine Watch-Party verlassen. |
| control_watch_party | Für den ganzen Raum abspielen, pausieren oder spulen. |
| end_watch_party | Eine Watch-Party für alle beenden. |
| send_watch_party_emote | Ein Echtzeit-Emote an die Watch-Party senden. |

### DM-Anfragen

Sortieren, wer eine Unterhaltung mit dir beginnen darf.

| Tool | Was es tut |
| --- | --- |
| view_dm_requests | Deine offenen eingehenden DM-Anfragen. |
| accept_dm_request | Eine DM-Anfrage annehmen. |
| deny_dm_request | Eine DM-Anfrage ablehnen. |

### Social: Profile, Storys, Karte

Profile nachschlagen, Storys ansehen und deine eingereichten Kartenfilter sehen.

| Tool | Was es tut |
| --- | --- |
| get_profile | Das öffentliche Profil eines Nutzers per user_guid. |
| list_story_users | Leute mit einer ungesehenen Story, die du ansehen kannst. |
| view_story | Die aktiven Storys eines Nutzers ansehen. |
| list_map_filters | Kartenfilter, die dieses Konto eingereicht hat, mit ihrem Moderationsstatus. |

### Sprachkanäle

Die laufende Sprachkanal-Session dieses Computers einsehen und steuern.

| Tool | Was es tut |
| --- | --- |
| list_voice_channels | Sprachkanäle in einem Server auflisten. |
| get_voice_state | Die aktuelle Sprach-Session und ihre Teilnehmer abrufen. |
| join_voice_channel | Auf diesem Computer einem Sprachkanal beitreten. |
| leave_voice_channel | Den aktuellen Sprachkanal verlassen. |
| set_voice_muted | Das Mikrofon dieses Computers stumm- oder wieder einschalten. |

### Konto & Privatsphäre

Freunde, Blockierungen, Stummschaltungen, Lesestatus und Clips verwalten, ohne Kontogeheimnisse preiszugeben.

| Tool | Was es tut |
| --- | --- |
| list_friends | Deine Freunde auflisten. |
| list_blocked | Konten auflisten, die du blockiert hast. |
| block_user | Ein Konto blockieren. |
| unblock_user | Die Blockierung eines Kontos aufheben. |
| list_mutes | Stummgeschaltete Kanäle und Server auflisten. |
| mute_channel | Einen Kanal stummschalten. |
| unmute_channel | Die Stummschaltung eines Kanals aufheben. |
| mute_server | Einen Server stummschalten. |
| unmute_server | Die Stummschaltung eines Servers aufheben. |
| mark_channel_read | Einen Kanal als gelesen markieren. |
| list_clips | Clips auflisten, die du erstellt hast. |
| share_clip | Einen deiner Clips teilbar machen. |
| unshare_clip | Einen Clip nicht mehr teilen. |
| rename_clip | Einen deiner Clips umbenennen. |
| list_stickers | Deine verfügbaren Sticker auflisten. |
| list_friend_locations | Freunde auflisten, die gerade ihren Standort mit dir teilen. |
| list_location_viewers | Auflisten, wer gerade deinen Standort sehen kann. |

### Bot-Konto-Tools

Interaktive Embed-Karten posten und die Interaktionen darauf zurücklesen. Verfügbar, wenn du als Bot-Konto angemeldet bist.

| Tool | Was es tut |
| --- | --- |
| send_bot_message | Eine reichhaltige Embed-Karte mit optionalen Buttons posten (nur Bot-Konten). |
| get_bot_events | Button-Klicks, Reaktionen und Antworten auf deine Bot-Nachrichten abfragen. |
| set_bot_status | Einen eigenen Anwesenheitsstatus setzen oder löschen (nur Bot-Konten). |

### Agentensteuerung

Kanal-Agenten konfigurieren, Projekte anhängen, laufende Aufgaben einsehen und Arbeit aus dem Chat steuern. Verwaltungsaktionen brauchen weiterhin Kanalberechtigungen.

| Tool | Was es tut |
| --- | --- |
| list_agent_channels | Freigegebene Kanäle und ihre Agenten-Einrichtung auflisten. |
| get_channel_agents | Die vollständige Agenten-Konfiguration eines Kanals abrufen. |
| set_channel_agents | Agenten aktivieren und die Agentenregeln eines Kanals aktualisieren. |
| add_channel_agent | Einem Kanal einen verfügbaren Agenten hinzufügen. |
| remove_channel_agent | Einen Agenten aus einem Kanal entfernen. |
| set_agent_project | Einem Kanal-Agenten ein Projekt und Anweisungen anhängen. |
| remove_agent_project | Ein Projekt von einem Kanal-Agenten lösen. |
| list_agent_tasks | Aktuelle und kürzliche Agentenaufgaben auflisten. |
| get_agent_task | Den Live-Zustand und die Ausgabe einer Agentenaufgabe abrufen. |
| steer_agent_task | Einer laufenden Agentenaufgabe eine weitere Anweisung senden. |

### Serververwaltung

Einen Server gestalten, den du verwaltest: Kanäle, Kategorien, Berechtigungsgruppen, Webhooks und Trigger. Jeder Aufruf prüft weiterhin deine echten Verwaltungsrechte auf diesem Server.

| Tool | Was es tut |
| --- | --- |
| list_manageable_servers | Server, die du verwalten kannst, und welche Berechtigungen du hast. |
| get_server_structure | Der vollständige Aufbau eines Servers aus Kanälen und Kategorien. |
| create_channel | Einen Kanal erstellen. |
| update_channel | Einen Kanal umbenennen, seinen Typ ändern oder ihn verschieben. |
| delete_channel | Einen Kanal löschen (unwiderruflich). |
| create_category | Eine Kanalkategorie erstellen. |
| update_category | Eine Kategorie umbenennen. |
| delete_category | Eine Kategorie löschen (ihre Kanäle bleiben). |
| list_server_groups | Die Berechtigungsgruppen eines Servers. |
| create_server_group | Eine Berechtigungsgruppe erstellen. |
| update_server_group | Eine Berechtigungsgruppe umbenennen, umfärben oder ihren Umfang ändern. |
| delete_server_group | Eine Berechtigungsgruppe löschen. |
| list_members | Servermitglieder und ihre Berechtigungsgruppen auflisten. |
| add_member_to_group | Ein Servermitglied einer Berechtigungsgruppe hinzufügen. |
| remove_member_from_group | Ein Servermitglied aus einer Berechtigungsgruppe entfernen. |
| list_invites | Aktive Servereinladungen auflisten. |
| create_invite | Eine Servereinladung erstellen. |
| delete_invite | Eine Servereinladung widerrufen. |
| list_custom_emojis | Die eigenen Emojis eines Servers auflisten. |
| list_webhooks | Die eingehenden Webhooks eines Servers. |
| create_webhook | Einen eingehenden Webhook erstellen. |
| get_webhook_url | Die URL eines Webhooks abrufen, an die gepostet werden kann. |
| update_webhook | Die Einstellungen eines Webhooks aktualisieren. |
| delete_webhook | Einen Webhook löschen (seine URL funktioniert nicht mehr). |
| list_triggers | Die ausgehenden Trigger eines Servers. |
| create_trigger | Einen Trigger erstellen (passende Nachrichten werden per POST an eine URL gesendet). |
| update_trigger | Einen Trigger aktualisieren. |
| delete_trigger | Einen Trigger löschen. |

### Community-Moderation

Dieselben Prüf-Warteschlangen, die der Schild-Button in der App öffnet. Stimmen und Vetos brauchen weiterhin ein echtes Moderatoren- (oder Staff-)Konto.

| Tool | Was es tut |
| --- | --- |
| get_moderation_stats | Dein Moderationsstatus und wie viel wartet. |
| list_moderation_queue | Kartenfilter, die auf eine Moderatorenstimme warten. |
| approve_map_filter | Dafür stimmen, einen eingereichten Kartenfilter zu genehmigen. |
| deny_map_filter | Dafür stimmen, einen eingereichten Kartenfilter abzulehnen. |
| list_report_queue | Gemeldete Inhalte, die auf eine Moderatorenstimme warten. |
| approve_report | Dafür stimmen, dass eine Meldung gegen die Regeln verstößt. |
| deny_report | Dafür stimmen, dass gemeldeter Inhalt in Ordnung ist. |
| community_map_propose_filter | Einen neuen Kartenfilter zur Prüfung einreichen. |
| veto_map_filter | Nur Staff: einen Kartenfilter sofort entfernen (unwiderruflich). |

### Hilfsmittel

Kleine Helfer für Assistenten, die lange laufen.

| Tool | Was es tut |
| --- | --- |
| keep_computer_awake | Diesen Computer wach halten, während du arbeitest, oder ihn wieder freigeben. |

## Weiterbauen