MCP: AI-assistenten

Geef Claude en andere AI-tools een veilige, gecontroleerde toegang tot je mssgs-workspace — lokaal, via je ingelogde sessie.

Overzicht Verbinden Rechten & tokens Realtime events Tools

Webhooks & Integraties

Berichten sturen en interactieve bots bouwen met webhooks en triggers.

Bot-berichten

Rijke embed-kaarten, interactieve knoppen en live-updatende berichten.

Overzicht

De mssgs desktop-app heeft een ingebouwde MCP-server (Model Context Protocol), zodat AI-assistenten zoals Claude of Cursor in je workspace kunnen meelezen en handelen. Hij draait lokaal op je machine en werkt via je ingelogde mssgs-sessie; geen apart botaccount of hosting nodig.

Jij bepaalt wat het ziet

De server draait alleen op localhost terwijl mssgs open is en je bent ingelogd. Je kiest per kanaal wat je vrijgeeft, en je zet per groep aan wat de assistent mag doen. Op dit moment zijn er 77 tools, verdeeld over 10 groepen.

Verbinden

MCP http://127.0.0.1:7444/mcp

Geauthenticeerd met een Bearer-token van de AI / MCP-instellingenpagina in de app: zet de server aan, kies de kanalen die je vrijgeeft en klik "Copy config"; het gekopieerde blok bevat al je poort en token. De server luistert alleen op localhost (standaardpoort 7444) en draait terwijl mssgs open is en je bent ingelogd.

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

Voor Claude Desktop of Cursor: plak het "Copy config"-blok in de MCP-instellingen van je AI-tool. Zie de stapsgewijze handleiding in de helpdesk.

Rechten & tokens

De tools die de assistent ziet, hangen af van de schakelaars die je aanzet. Alleen-lezen tools staan altijd aan; al het andere zit achter een groepsschakelaar. Serverbeheer en moderatie controleren daarbovenop nog steeds je echte rechten op het account.

Groep Ontgrendelt
Lezen Altijd aan — lees berichten, aanwezigheid, vermeldingen en pins in vrijgegeven kanalen
Verzenden & interactie Verzenden, reageren, reacties, bewerken, verwijderen, pinnen, typen — plus DM-aanwezigheid, spraakoproepen en games
DM-verzoeken Bekijk, accepteer en weiger inkomende DM-verzoeken
Sociaal Profielen, stories en je kaartfilters
Serverbeheer Kanalen, categorieën, rechtengroepen, webhooks en triggers — echte beheerrechten blijven vereist
Communitymoderatie Beoordelingswachtrijen en stemmen — moderator- of staff-account blijft vereist
Computer wakker houden Voorkom dat de machine slaapt terwijl de assistent werkt
Bot-account tools Interactieve embed-kaarten en hun events — alleen botaccounts

Tokens

Tokens zijn benoemd, per AI-tool en met één klik intrekbaar — met een activiteits-sparkline per token, zodat je precies ziet wanneer elk token is gebruikt. Goede hygiëne: één token per tool, duidelijk benoemd. Laptop kwijt? Trek het token in en het is waardeloos.

Realtime events over SSE

Open het MCP-endpoint als stream (GET /mcp met Accept: text/event-stream) en je ontvangt JSON-RPC-notificaties zodra ze gebeuren:

Notificatie Vuurt bij
notifications/mssgs/messageNieuwe berichten in kanalen die je kunt zien
notifications/mssgs/bot_eventKnopdrukken, reacties en replies op berichten die je assistent plaatste via send_bot_message
notifications/mssgs/presenceAanwezigheidswijzigingen
notifications/mssgs/typingTypindicatoren
notifications/mssgs/callSpraakoproep-gebeurtenissen

Interactieve bot-kaarten

Interactieve kaarten vanuit je assistent

Plaats een embed-kaart met knoppen via send_bot_message, luister naar bot_event op de stream (of poll get_bot_events) en werk de kaart ter plekke bij met edit_message. Zelfde kaartmodel als de bot-berichten-docs.

Tool-referentie (77)

Elke tool hieronder is een echte actie in mssgs. Namen zijn de exacte MCP-identifiers. Tools verschijnen pas als de bijbehorende groep is ingeschakeld.

Lezen

Altijd aan

Alleen-lezen tools, beschikbaar zodra de server aanstaat. Ze zien alleen de kanalen die jij hebt vrijgegeven.

Tool Wat het doet
list_channels Toont de kanalen die je voor AI-tools hebt vrijgegeven.
read_channel Lees recente berichten uit een vrijgegeven kanaal.
get_new_messages Haal berichten op die nieuwer zijn dan een tijdstempel, over alle vrijgegeven kanalen.
get_channel_stamp De lees/ongelezen-status van een kanaal, met ongelezen- en vermeldingsaantallen.
get_presence Wie er aanwezig is in een kanaal en hun status.
get_message Haal één volledig bericht op via id, inclusief embeds en linkpreviews.
get_typing Wie er op dit moment typt in een kanaal.
list_mentions Recente berichten die jou @vermelden.
list_pinned_messages De vastgemaakte berichten in een kanaal.
subscribe_channel Abonneer op een kanaal voor realtime updates.
unsubscribe_channel Stop realtime updates voor een kanaal.
list_subscriptions Toont de kanalen waarop je realtime bent geabonneerd.

Verzenden & interactie

Verzend-schakelaar

Plaats en handel als de ingelogde gebruiker. Alles hier schrijft naar een kanaal en zit dus achter één schakelaar.

Tool Wat het doet
send_message Stuur een bericht naar een kanaal als jezelf.
reply_message Reageer op een specifiek bericht, als reply.
add_reaction Voeg een emoji-reactie toe aan een bericht.
remove_reaction Verwijder een van je emoji-reacties.
edit_message Bewerk een van je eigen berichten.
delete_message Verwijder een van je eigen berichten.
pin_message Maak een bericht vast (vereist pin-rechten).
unpin_message Maak een vastgemaakt bericht los.
open_one_view_attachment Open een view-once foto/video in een DM.
set_typing Toon een live 'typt…'-indicator.
stop_typing Wis de typindicator.

DM-aanwezigheid & bellen

Verzend-schakelaar

Wees aanwezig in een DM en plaats echte spraakoproepen — start_dm_call gebruikt de microfoon van deze computer, net alsof je op bellen drukt in de app.

Tool Wat het doet
enter_dm_chat Laat jezelf als aanwezig zien in een DM.
leave_dm_chat Stop met aanwezig tonen in een DM.
start_dm_call Start een spraakoproep in een DM (gebruikt de microfoon van deze computer).
answer_dm_call Beantwoord een rinkelende DM-oproep.
decline_dm_call Weiger een rinkelende DM-oproep.
end_dm_call Hang op of annuleer een DM-oproep.
get_call_status Huidige spraakoproepstatus en eventuele inkomende oproep.

Games

Verzend-schakelaar

Doe mee en speel de ingebouwde mini-games van mssgs rechtstreeks vanuit je assistent.

Tool Wat het doet
list_game_invites Open game-uitnodigingen die aan jou gericht zijn.
list_active_games Gamekamers waarin je momenteel speelt.
accept_game_invite Accepteer een uitnodiging via room_id of join-code.
get_game_state Het live bord/de status van een game waarin je zit.
game_move Speel een zet in een game.
resign_game Geef op of verlaat een game.

DM-verzoeken

DM-verzoeken-schakelaar

Bepaal wie een gesprek met je mag beginnen.

Tool Wat het doet
view_dm_requests Je openstaande inkomende DM-verzoeken.
accept_dm_request Accepteer een DM-verzoek.
deny_dm_request Weiger een DM-verzoek.

Sociaal: profielen, stories, kaart

Sociaal-schakelaar

Zoek profielen op, bekijk stories en zie je ingediende kaartfilters.

Tool Wat het doet
get_profile Het openbare profiel van een gebruiker via user_guid.
list_story_users Mensen met een ongeziene story die je kunt bekijken.
view_story Bekijk de actieve stories van een gebruiker.
list_map_filters Kaartfilters die dit account heeft ingediend, met hun moderatiestatus.

Bot-account tools

Bot-schakelaar · alleen botaccounts

Plaats interactieve embed-kaarten en lees de interacties erop terug. Beschikbaar als je bent ingelogd als botaccount.

Tool Wat het doet
send_bot_message Plaats een rich embed-kaart met optionele knoppen (alleen botaccounts).
get_bot_events Poll knopdrukken, reacties en replies op je botberichten.
set_bot_status Stel een aangepaste status in of wis hem (alleen botaccounts).

Serverbeheer

Serverbeheer-schakelaar · vereist beheerrechten

Geef vorm aan een server die je beheert: kanalen, categorieën, rechtengroepen, webhooks en triggers. Elke aanroep controleert nog steeds je echte beheerrechten op die server.

Tool Wat het doet
list_manageable_servers Servers die je kunt beheren en welke rechten je hebt.
get_server_structure De volledige kanaal- en categorie-indeling van een server.
create_channel Maak een kanaal aan.
update_channel Hernoem, wijzig type of verplaats een kanaal.
delete_channel Verwijder een kanaal (onomkeerbaar).
create_category Maak een kanaalcategorie aan.
update_category Hernoem een categorie.
delete_category Verwijder een categorie (de kanalen blijven).
list_server_groups De rechtengroepen van een server.
create_server_group Maak een rechtengroep aan.
update_server_group Hernoem, verkleur of herzie het bereik van een rechtengroep.
delete_server_group Verwijder een rechtengroep.
list_webhooks De inkomende webhooks van een server.
create_webhook Maak een inkomende webhook aan.
get_webhook_url Haal de post-URL van een webhook op.
update_webhook Wijzig de instellingen van een webhook.
delete_webhook Verwijder een webhook (de URL werkt niet meer).
list_triggers De uitgaande triggers van een server.
create_trigger Maak een trigger aan (overeenkomende berichten POST naar een URL).
update_trigger Wijzig een trigger.
delete_trigger Verwijder een trigger.

Communitymoderatie

Moderatie-schakelaar · alleen moderators/staff

Dezelfde beoordelingswachtrijen die de schildknop in de app opent. Stemmen en vetos vereisen nog steeds een echt moderator- (of staff-)account.

Tool Wat het doet
get_moderation_stats Je moderatiestatus en hoeveel er wacht.
list_moderation_queue Kaartfilters die op een moderatorstem wachten.
approve_map_filter Stem om een ingediend kaartfilter goed te keuren.
deny_map_filter Stem om een ingediend kaartfilter af te keuren.
list_report_queue Gerapporteerde content die op een moderatorstem wacht.
approve_report Stem dat een melding de regels schendt.
deny_report Stem dat gerapporteerde content in orde is.
community_map_propose_filter Dien een nieuw kaartfilter in ter beoordeling.
veto_map_filter Alleen staff: haal een kaartfilter direct offline (onomkeerbaar).

Overig

Wakker-houden-schakelaar

Kleine hulpmiddelen voor langlopende assistenten.

Tool Wat het doet
keep_computer_awake Houd deze computer wakker terwijl je werkt, of geef hem vrij.

Vragen?

We helpen je graag met je integratie.

developers@mss.gs