Entwickler MCP

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 zusammenfassenKanäle, DMs, Erwähnungen und angepinnte Nachrichten, nur in den Kanälen, die du freigibst.
Schreiben, wenn du es erlaubstSenden, antworten, reagieren, bearbeiten und anpinnen, sobald du das Senden einschaltest.
Spiele spielenEine Einladung annehmen, das Spielfeld lesen und echte Züge machen.
Die Kontrolle behaltenStandardmäßig aus, zuerst nur lesend, nur lokal, ein widerrufbares Token pro KI-Tool.

In der App

> Fass #general in drei Punkten zusammen und poste es in #daily

● read_channel (channel: "general", limit: 50)

● send_message (channel: "daily")

In #daily gepostet.

daily

maya09:31

Zusammenfassung von #general heute:
• Der Launch wurde auf Freitag verschoben.
• Dani kümmert sich um die Release Notes.
• Das Standup ist ab jetzt um 09:30.

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

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

MCP http://127.0.0.1:7444/mcp

Authentifiziert mit einem Bearer-Token von der KI-/MCP-Einstellungsseite 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.

Claude Code verbinden

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

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

Immer aktiv

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

Schalter: Senden

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

Schalter: Senden

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

Schalter: Senden

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

Schalter: 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

Schalter: 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

Schalter: Social

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

Schalter: 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

Schalter: Konto

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

Schalter: Bot · nur Bot-Konten

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

Schalter: 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

Schalter: Serververwaltung · braucht Verwaltungsrechte

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

Schalter: Moderation · nur Moderatoren/Staff

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

Schalter: Wach halten

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

AgentenLass eine KI Aufgaben in einem Kanal übernehmen. WebhooksPoste aus einem Skript in einen Kanal. Deine KI verbindenDie Einrichtung Schritt für Schritt im Hilfe-Center. NachrichtenkartenWas eine Bot-Nachricht zeigen kann.