Développeurs MCP

Connecter un assistant IA

L’application de bureau mssgs intègre un serveur MCP. Connecte Claude, Cursor ou Codex et ils peuvent lire, résumer et répondre dans les salons que tu choisis, directement depuis ton propre ordinateur.

Ce que vous pouvez faire

Lire et résumerSalons, messages privés, mentions et messages épinglés, uniquement dans les salons que tu exposes.
Écrire quand tu l’autorisesEnvoyer, répondre, réagir, modifier et épingler, une fois l’envoi activé.
JouerAccepter une invitation, lire le plateau et jouer de vrais coups.
Garder le contrôleDésactivé par défaut, d’abord en lecture seule, uniquement en local, un jeton révocable par outil d’IA.

Dans l'app

> Résume #general en trois points et publie-le dans #daily

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

● send_message (channel: "daily")

Publié dans #daily.

daily

maya09:31

Résumé de #general aujourd’hui :
• Le lancement est repoussé à vendredi.
• Dani s’occupe des notes de version.
• Le standup est désormais à 9 h 30.

Tu demandes dans ton outil d’IA ; il lit #general via le serveur MCP et publie le résumé en ton nom, parce que tu as autorisé l’envoi.

Présentation

L’application de bureau mssgs intègre un serveur MCP (Model Context Protocol), pour que des assistants IA comme Claude ou Cursor puissent lire et agir dans ton espace. Il tourne en local sur ta machine et dialogue avec ta session mssgs connectée ; pas besoin de compte de bot séparé ni d’hébergement.

Tu décides de ce qu’il voit

Le serveur tourne uniquement sur localhost, tant que mssgs est ouvert et que tu es connecté. Tu choisis les salons à exposer, et tu actives ce que l’assistant peut faire, groupe par groupe. Il y a actuellement 127 outils répartis en 14 groupes.

Connexion

MCP http://127.0.0.1:7444/mcp

Authentifié avec un jeton Bearer issu de la page de réglages IA / MCP de l’application : active le serveur, choisis les salons à exposer et appuie sur « Copier la config » ; le bloc copié contient déjà ton port et ton jeton. Le serveur écoute uniquement sur localhost (port 7444 par défaut) et tourne tant que mssgs est ouvert et que tu es connecté.

Connecter Claude Code

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

Pour Claude Desktop ou Cursor : colle le bloc « Copier la config » dans les réglages MCP de ton outil d’IA. Consulte le guide pas à pas dans le centre d’aide.

Permissions et jetons

Les outils qu’un assistant voit dépendent des interrupteurs que tu actives. Les outils en lecture seule sont toujours actifs ; tout le reste se trouve derrière un interrupteur de groupe. La gestion des serveurs et la modération vérifient en plus tes vraies permissions sur le compte.

Groupe	Débloque
Lecture	Toujours actif : lire les messages, la présence, les mentions et les épingles dans les salons exposés
Envoi et interaction	Envoyer, répondre, réagir, modifier, supprimer, épingler, indicateur de saisie, plus la présence en message privé, les appels vocaux et les jeux
Watch parties	Lancer, rejoindre et contrôler des séances de visionnage partagées
Demandes de message	Voir, accepter et refuser les demandes de message entrantes
Social	Profils, stories et tes filtres de carte
Salons vocaux	Rejoindre un salon vocal, voir les participants et contrôler ton micro
Compte et confidentialité	Amis, blocages, sourdines, état de lecture, clips et partage de position
Pilotage des agents	Configurer les agents d’un salon, les projets et les tâches en direct
Gestion des serveurs	Salons, catégories, groupes de permissions, membres, invitations, emoji, webhooks et déclencheurs (tes vraies permissions de gestion restent appliquées)
Modération communautaire	Files d’examen et votes (un compte de modérateur ou de l’équipe reste nécessaire)
Garder l’ordinateur éveillé	Empêcher la machine de se mettre en veille pendant que l’assistant travaille
Outils des comptes de bot	Cartes d’embed interactives et leurs événements (comptes de bot uniquement)

Jetons

Les jetons sont nommés, un par outil d’IA, et révocables en un clic, avec un graphe d’activité par jeton pour voir exactement quand chacun a servi. Bonne hygiène : un jeton par outil, clairement nommé. Portable perdu ? Révoque son jeton et il ne sert plus à rien.

Événements en temps réel via SSE

Ouvre l’endpoint MCP en flux (GET /mcp avec Accept: text/event-stream) et tu reçois des notifications JSON-RPC au moment où elles se produisent :

Notification	Déclenchée par
`notifications/mssgs/message`	Nouveaux messages dans les salons que tu peux voir
`notifications/mssgs/bot_event`	Appuis sur les boutons, réactions et réponses aux messages que ton assistant a publiés via send_bot_message
`notifications/mssgs/presence`	Changements de présence
`notifications/mssgs/typing`	Indicateurs de saisie
`notifications/mssgs/call`	Événements d’appel vocal

Cartes de bot interactives

Des cartes de bot interactives depuis ton assistant

Publie une carte d’embed avec des boutons via send_bot_message, écoute bot_event sur le flux (ou interroge get_bot_events), et mets la carte à jour sur place avec edit_message. Même modèle de carte que dans la doc des messages de bot.

Référence des outils (127)

Chaque outil ci-dessous est une vraie action dans mssgs. Les noms sont les identifiants MCP exacts. Les outils n’apparaissent qu’une fois leur groupe activé.

Lecture

Toujours actif

Des outils en lecture seule, disponibles dès que le serveur est lancé. Ils ne voient jamais que les salons que tu as exposés.

Outil	Ce qu’il fait
`list_channels`	Liste les salons que tu as exposés aux outils d’IA.
`read_channel`	Lit les messages récents d’un salon exposé.
`get_new_messages`	Récupère les messages plus récents qu’un horodatage dans tous les salons exposés.
`get_channel_stamp`	L’état lu/non lu d’un salon, avec le nombre de messages non lus et de mentions.
`get_presence`	Qui est présent dans un salon, et son statut.
`get_message`	Récupère un message complet par son id, embeds et aperçus de liens compris.
`search_messages`	Recherche dans le texte des messages des salons exposés d’un serveur.
`get_message_context`	Lit les messages juste autour d’un résultat de recherche.
`get_account`	Affiche le compte connecté et ses capacités disponibles.
`get_typing`	Qui est en train d’écrire dans un salon.
`list_mentions`	Les messages récents qui te @mentionnent.
`list_pinned_messages`	Les messages épinglés d’un salon.
`subscribe_channel`	S’abonne à un salon pour les mises à jour en temps réel.
`unsubscribe_channel`	Arrête les mises à jour en temps réel d’un salon.
`list_subscriptions`	Liste les salons auxquels tu es abonné en temps réel.

Envoi et interaction

Interrupteur Envoi

Publie et agis en tant qu’utilisateur connecté. Tout ici écrit dans un salon, donc tout se trouve derrière un seul interrupteur.

Outil	Ce qu’il fait
`send_message`	Envoie un message dans un salon en ton nom.
`reply_message`	Répond à un message précis, en fil.
`add_reaction`	Ajoute une réaction emoji à un message.
`remove_reaction`	Retire l’une de tes réactions emoji.
`edit_message`	Modifie l’un de tes propres messages.
`delete_message`	Supprime l’un de tes propres messages.
`pin_message`	Épingle un message (nécessite la permission d’épingler).
`unpin_message`	Désépingle un message épinglé.
`open_one_view_attachment`	Ouvre une photo/vidéo à vue unique dans un message privé.
`set_typing`	Affiche un indicateur « écrit… » en direct.
`stop_typing`	Efface l’indicateur de saisie.

Présence et appels en message privé

Interrupteur Envoi

Sois présent dans un message privé et passe de vrais appels vocaux : start_dm_call utilise le micro de cet ordinateur, exactement comme quand tu appuies sur appeler dans l’application.

Outil	Ce qu’il fait
`enter_dm_chat`	Te montre présent dans une conversation privée.
`leave_dm_chat`	Arrête de te montrer présent dans une conversation privée.
`start_dm_call`	Lance un appel vocal en message privé (utilise le micro de cet ordinateur).
`answer_dm_call`	Répond à un appel privé qui sonne.
`decline_dm_call`	Refuse un appel privé qui sonne.
`end_dm_call`	Raccroche ou annule un appel privé.
`get_call_status`	L’état actuel de l’appel vocal et un éventuel appel entrant.

Jeux

Interrupteur Envoi

Rejoins et joue aux mini-jeux intégrés de mssgs directement depuis ton assistant.

Outil	Ce qu’il fait
`list_game_invites`	Les invitations de jeu ouvertes qui te sont adressées.
`list_active_games`	Les salles de jeu où tu joues en ce moment.
`accept_game_invite`	Accepte une invitation par room_id ou code d’accès.
`get_game_state`	Le plateau/l’état en direct d’une partie où tu joues.
`game_move`	Joue un coup dans une partie.
`resign_game`	Abandonne ou quitte une partie.

Watch parties

Interrupteur Watch parties

Lance et contrôle des séances de visionnage partagées, rejoins la salle et réagissez ensemble en temps réel.

Outil	Ce qu’il fait
`list_watch_parties`	Liste les watch parties actives auxquelles tu as accès.
`get_watch_party`	Récupère l’état complet d’une watch party.
`start_watch_party`	Lance une watch party dans un salon.
`join_watch_party`	Rejoint une watch party active.
`leave_watch_party`	Quitte une watch party.
`control_watch_party`	Lecture, pause ou avance pour toute la salle.
`end_watch_party`	Termine une watch party pour tout le monde.
`send_watch_party_emote`	Envoie un emote en temps réel à la watch party.

Demandes de message

Interrupteur Demandes de message

Trie qui a le droit de démarrer une conversation avec toi.

Outil	Ce qu’il fait
`view_dm_requests`	Tes demandes de message entrantes en attente.
`accept_dm_request`	Accepte une demande de message.
`deny_dm_request`	Refuse une demande de message.

Social : profils, stories, carte

Interrupteur Social

Consulte des profils, regarde des stories et vois les filtres de carte que tu as soumis.

Outil	Ce qu’il fait
`get_profile`	Le profil public d’un utilisateur, par user_guid.
`list_story_users`	Les personnes avec une story non vue que tu peux regarder.
`view_story`	Regarde les stories actives d’un utilisateur.
`list_map_filters`	Les filtres de carte soumis par ce compte, avec leur état de modération.

Salons vocaux

Interrupteur Vocal

Inspecte et contrôle la session vocale en direct de cet ordinateur.

Outil	Ce qu’il fait
`list_voice_channels`	Liste les salons vocaux d’un serveur.
`get_voice_state`	Récupère la session vocale en cours et ses participants.
`join_voice_channel`	Rejoint un salon vocal sur cet ordinateur.
`leave_voice_channel`	Quitte le salon vocal en cours.
`set_voice_muted`	Coupe ou réactive le micro de cet ordinateur.

Compte et confidentialité

Interrupteur Compte

Gère tes amis, tes blocages, tes mises en sourdine, l’état de lecture et tes clips sans exposer les secrets du compte.

Outil	Ce qu’il fait
`list_friends`	Liste tes amis.
`list_blocked`	Liste les comptes que tu as bloqués.
`block_user`	Bloque un compte.
`unblock_user`	Débloque un compte.
`list_mutes`	Liste les salons et serveurs en sourdine.
`mute_channel`	Met un salon en sourdine.
`unmute_channel`	Réactive un salon mis en sourdine.
`mute_server`	Met un serveur en sourdine.
`unmute_server`	Réactive un serveur mis en sourdine.
`mark_channel_read`	Marque un salon comme lu.
`list_clips`	Liste les clips que tu as créés.
`share_clip`	Rend l’un de tes clips partageable.
`unshare_clip`	Arrête de partager un clip.
`rename_clip`	Renomme l’un de tes clips.
`list_stickers`	Liste tes stickers disponibles.
`list_friend_locations`	Liste les amis qui partagent en ce moment leur position avec toi.
`list_location_viewers`	Liste qui peut voir ta position en ce moment.

Outils des comptes de bot

Interrupteur Bot · comptes de bot uniquement

Publie des cartes d’embed interactives et relis les interactions qu’elles reçoivent. Disponible quand tu es connecté avec un compte de bot.

Outil	Ce qu’il fait
`send_bot_message`	Publie une carte d’embed enrichie avec des boutons facultatifs (comptes de bot uniquement).
`get_bot_events`	Interroge les appuis sur les boutons, les réactions et les réponses à tes messages de bot.
`set_bot_status`	Définit ou efface un statut de présence personnalisé (comptes de bot uniquement).

Pilotage des agents

Interrupteur Pilotage des agents

Configure les agents d’un salon, attache des projets, inspecte les tâches en direct et oriente le travail depuis le chat. Les actions de gestion exigent toujours les permissions du salon.

Outil	Ce qu’il fait
`list_agent_channels`	Liste les salons exposés et leur configuration d’agents.
`get_channel_agents`	Récupère la configuration d’agents complète d’un salon.
`set_channel_agents`	Active les agents et met à jour les règles d’agents d’un salon.
`add_channel_agent`	Ajoute un agent disponible à un salon.
`remove_channel_agent`	Retire un agent d’un salon.
`set_agent_project`	Attache un projet et des instructions à un agent de salon.
`remove_agent_project`	Détache un projet d’un agent de salon.
`list_agent_tasks`	Liste les tâches d’agent en cours et récentes.
`get_agent_task`	Récupère l’état en direct et la sortie d’une tâche d’agent.
`steer_agent_task`	Envoie une instruction complémentaire à une tâche d’agent en cours.

Gestion des serveurs

Interrupteur Gestion des serveurs · permissions de gestion requises

Façonne un serveur que tu gères : salons, catégories, groupes de permissions, webhooks et déclencheurs. Chaque appel vérifie toujours tes vraies permissions de gestion sur ce serveur.

Outil	Ce qu’il fait
`list_manageable_servers`	Les serveurs que tu peux gérer et les permissions que tu y détiens.
`get_server_structure`	L’organisation complète des salons et catégories d’un serveur.
`create_channel`	Crée un salon.
`update_channel`	Renomme un salon, change son type ou le déplace.
`delete_channel`	Supprime un salon (irréversible).
`create_category`	Crée une catégorie de salons.
`update_category`	Renomme une catégorie.
`delete_category`	Supprime une catégorie (ses salons restent).
`list_server_groups`	Les groupes de permissions d’un serveur.
`create_server_group`	Crée un groupe de permissions.
`update_server_group`	Renomme un groupe de permissions, change sa couleur ou sa portée.
`delete_server_group`	Supprime un groupe de permissions.
`list_members`	Liste les membres du serveur et leurs groupes de permissions.
`add_member_to_group`	Ajoute un membre du serveur à un groupe de permissions.
`remove_member_from_group`	Retire un membre du serveur d’un groupe de permissions.
`list_invites`	Liste les invitations actives du serveur.
`create_invite`	Crée une invitation au serveur.
`delete_invite`	Révoque une invitation au serveur.
`list_custom_emojis`	Liste les emoji personnalisés d’un serveur.
`list_webhooks`	Les webhooks entrants d’un serveur.
`create_webhook`	Crée un webhook entrant.
`get_webhook_url`	Récupère l’URL de publication d’un webhook.
`update_webhook`	Met à jour les réglages d’un webhook.
`delete_webhook`	Supprime un webhook (son URL cesse de fonctionner).
`list_triggers`	Les déclencheurs sortants d’un serveur.
`create_trigger`	Crée un déclencheur (les messages correspondants sont envoyés en POST à une URL).
`update_trigger`	Met à jour un déclencheur.
`delete_trigger`	Supprime un déclencheur.

Modération communautaire

Interrupteur Modération · modérateurs/équipe uniquement

Les mêmes files d’examen que le bouton bouclier ouvre dans l’application. Les votes et les vetos exigent toujours un vrai compte de modérateur (ou de l’équipe).

Outil	Ce qu’il fait
`get_moderation_stats`	Ton statut de modération et ce qui est en attente.
`list_moderation_queue`	Les filtres de carte en attente d’un vote de modérateur.
`approve_map_filter`	Vote pour approuver un filtre de carte soumis.
`deny_map_filter`	Vote pour refuser un filtre de carte soumis.
`list_report_queue`	Les contenus signalés en attente d’un vote de modérateur.
`approve_report`	Vote qu’un signalement enfreint les règles.
`deny_report`	Vote que le contenu signalé est correct.
`community_map_propose_filter`	Soumet un nouveau filtre de carte à l’examen.
`veto_map_filter`	Réservé à l’équipe : retire immédiatement un filtre de carte (irréversible).

Utilitaires

Interrupteur Garder éveillé

Petits outils pour les assistants qui travaillent longtemps.

Outil	Ce qu’il fait
`keep_computer_awake`	Garde cet ordinateur éveillé pendant que tu travailles, ou le libère.

Continuer

AgentsLaisse une IA prendre des tâches dans un salon. WebhooksPublie dans un salon depuis un script. Connecter ton IALa configuration pas à pas, dans le centre d’aide. Cartes de messageCe qu’un message de bot peut afficher.