---
title: "MCP: koppel Claude en andere AI-assistenten aan mssgs"
description: "Verbind Claude, Cursor en andere AI-tools met mssgs via MCP. Een lokale server met rechten en 127 tools: kanalen lezen, berichten sturen, bots draaien en meer."
canonical: https://docs.mss.gs/nl/mcp
language: nl
---

# Een AI-assistent koppelen

De desktop-app van mssgs heeft een ingebouwde MCP-server. Koppel Claude, Cursor of Codex en ze kunnen lezen, samenvatten en antwoorden in de kanalen die jij kiest, rechtstreeks vanaf je eigen computer.

## Wat je kunt doen

- **Lezen en samenvatten** Kanalen, DM's, vermeldingen en vastgezette berichten, alleen in de kanalen die je vrijgeeft.

- **Schrijven als jij het toestaat** Sturen, antwoorden, reageren, bewerken en vastzetten, zodra je verzenden aanzet.

- **Games spelen** Een uitnodiging accepteren, het bord lezen en echte zetten doen.

- **De controle houden** Standaard uit, eerst alleen-lezen, alleen lokaal, een intrekbaar token per AI-tool.

In de app

Je vraagt het in je AI-tool; die leest #general via de MCP-server en post de samenvatting als jou, omdat je verzenden hebt toegestaan.

- [Overzicht](#overview)

- [Verbinden](#connect)

- [Rechten & tokens](#permissions)

- [Realtime events](#events)

- [Tools](#tools)

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

Geauthenticeerd met een Bearer-token van de [AI / MCP-instellingenpagina](https://mss.gs/nl/help/bots-mcp/connect-your-ai) 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.

```bash
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](https://mss.gs/nl/help/bots-mcp/connect-your-ai) 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/message | Nieuwe berichten in kanalen die je kunt zien |
| notifications/mssgs/bot_event | Knopdrukken, reacties en replies op berichten die je assistent plaatste via send_bot_message |
| notifications/mssgs/presence | Aanwezigheidswijzigingen |
| notifications/mssgs/typing | Typindicatoren |
| notifications/mssgs/call | Spraakoproep-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](https://docs.mss.gs/nl/bots)-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

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

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

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

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

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

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

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

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

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

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

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

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

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

Kleine hulpmiddelen voor langlopende assistenten.

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

## Verder bouwen