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 127 tools, verdeeld over 14 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
Watchparty’s Start, neem deel aan en bedien gedeelde kijksessies
DM-verzoeken Bekijk, accepteer en weiger inkomende DM-verzoeken
Sociaal Profielen, stories en je kaartfilters
Spraakkanalen Neem deel aan spraak, bekijk deelnemers en bedien je microfoon
Account & privacy Vrienden, blokkades, dempingen, leesstatus, clips en locatiedeling
Agent-aansturing Configureer kanaalagents, projecten en live taken
Serverbeheer Kanalen, categorieën, rechtengroepen, leden, uitnodigingen, emoji, 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 (127)

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.
search_messages Doorzoek berichttekst in vrijgegeven kanalen van een server.
get_message_context Lees de berichten direct rondom één zoekresultaat.
get_account Toon het ingelogde account en de beschikbare mogelijkheden.
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.

Watchparty’s

Watchparty-schakelaar

Start en bedien gedeelde kijksessies, neem deel en reageer samen in realtime.

Tool Wat het doet
list_watch_parties Toon actieve watchparty’s waartoe je toegang hebt.
get_watch_party Haal de volledige status van één watchparty op.
start_watch_party Start een watchparty in een kanaal.
join_watch_party Neem deel aan een actieve watchparty.
leave_watch_party Verlaat een watchparty.
control_watch_party Speel af, pauzeer of spoel voor de hele kamer.
end_watch_party Beëindig een watchparty voor iedereen.
send_watch_party_emote Stuur een realtime emote naar de watchparty.

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.

Spraakkanalen

Spraak-schakelaar

Bekijk en bedien de live spraakkanaalsessie op deze computer.

Tool Wat het doet
list_voice_channels Toon de spraakkanalen in een server.
get_voice_state Haal de huidige spraaksessie en deelnemers op.
join_voice_channel Neem op deze computer deel aan een spraakkanaal.
leave_voice_channel Verlaat het huidige spraakkanaal.
set_voice_muted Demp of activeer de microfoon van deze computer.

Account & privacy

Account-schakelaar

Beheer vrienden, blokkades, dempingen, leesstatus en clips zonder accountgeheimen vrij te geven.

Tool Wat het doet
list_friends Toon je vrienden.
list_blocked Toon accounts die je hebt geblokkeerd.
block_user Blokkeer een account.
unblock_user Deblokkeer een account.
list_mutes Toon gedempte kanalen en servers.
mute_channel Demp een kanaal.
unmute_channel Hef het dempen van een kanaal op.
mute_server Demp een server.
unmute_server Hef het dempen van een server op.
mark_channel_read Markeer een kanaal als gelezen.
list_clips Toon clips die je hebt gemaakt.
share_clip Maak een van je clips deelbaar.
unshare_clip Stop met het delen van een clip.
rename_clip Hernoem een van je clips.
list_stickers Toon je beschikbare stickers.
list_friend_locations Toon vrienden die momenteel een locatie met je delen.
list_location_viewers Toon wie momenteel je locatie kan zien.

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

Agent-aansturing

Agent-aansturing-schakelaar

Configureer kanaalagents, koppel projecten, bekijk live taken en stuur werk aan vanuit de chat. Beheeracties vereisen nog steeds kanaalrechten.

Tool Wat het doet
list_agent_channels Toon vrijgegeven kanalen en hun agentconfiguratie.
get_channel_agents Haal de volledige agentconfiguratie van een kanaal op.
set_channel_agents Schakel agents in en wijzig de agentregels van een kanaal.
add_channel_agent Voeg een beschikbare agent toe aan een kanaal.
remove_channel_agent Verwijder een agent uit een kanaal.
set_agent_project Koppel een project en instructies aan een kanaalagent.
remove_agent_project Ontkoppel een project van een kanaalagent.
list_agent_tasks Toon huidige en recente agenttaken.
get_agent_task Haal de live status en uitvoer van één agenttaak op.
steer_agent_task Stuur een vervolginstructie naar een actieve agenttaak.

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_members Toon serverleden en hun rechtengroepen.
add_member_to_group Voeg een serverlid toe aan een rechtengroep.
remove_member_from_group Verwijder een serverlid uit een rechtengroep.
list_invites Toon actieve serveruitnodigingen.
create_invite Maak een serveruitnodiging aan.
delete_invite Trek een serveruitnodiging in.
list_custom_emojis Toon de aangepaste emoji van een server.
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