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 tu peux 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
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
http://127.0.0.1:7444/mcp
L’authentification se fait avec un jeton Bearer, que tu obtiens sur la page de réglages Accès 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é.
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 les permissions réelles de ton compte.
| Groupe | Débloque |
|---|---|
| Lecture | Toujours actif : lire les messages, la présence, les mentions et les messages épinglés dans les salons exposés |
| Envoi et interaction | Envoyer, répondre, réagir, modifier, supprimer, épingler, indicateur de saisie, ainsi que la présence en message privé, les appels vocaux et les jeux |
| Sessions de visionnage | Lancer, rejoindre et contrôler des sessions de visionnage |
| Demandes de message | Voir, accepter et refuser les demandes de message entrantes |
| Social | Profils, stories et tes filtres photo de la 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 enrichies 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 mini-graphique d’activité par jeton pour voir exactement quand chacun a servi. Bonne pratique : un jeton par outil, clairement nommé. Ordinateur portable perdu ? Révoque son jeton et il ne sert plus à rien.
Événements en temps réel via SSE
Ouvre le point d’accès MCP en flux (GET /mcp avec Accept: text/event-stream) et tu reçois les notifications JSON-RPC en temps réel :
| 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 enrichie avec des boutons via send_bot_message, écoute bot_event sur le flux (ou interroge get_bot_events), et mets la carte à jour directement 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 actifDes outils en lecture seule, disponibles dès que le serveur est lancé. Ils ne voient que les salons que tu as exposés, rien d’autre.
| 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, cartes enrichies 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 EnvoiPublie et agis en tant qu’utilisateur connecté. Tous ces outils écrivent dans un salon : c’est pourquoi ils passent par 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 EnvoiSois présent dans un message privé et passe de vrais appels vocaux : start_dm_call utilise le micro de cet ordinateur, exactement comme le bouton d’appel dans l’application.
| Outil | Ce qu’il fait |
|---|---|
enter_dm_chat |
Indique que tu es présent dans une conversation privée. |
leave_dm_chat |
N’indique plus que tu es 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 EnvoiRejoins des parties et joue aux mini-jeux de mssgs directement depuis ton assistant.
| Outil | Ce qu’il fait |
|---|---|
list_game_invites |
Les invitations de jeu en attente 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. |
Sessions de visionnage
Interrupteur Sessions de visionnageLance et contrôle des sessions de visionnage, rejoins la salle et réagis en temps réel avec les autres.
| Outil | Ce qu’il fait |
|---|---|
list_watch_parties |
Liste les sessions de visionnage actives auxquelles tu as accès. |
get_watch_party |
Récupère l’état complet d’une session de visionnage. |
start_watch_party |
Lance une session de visionnage dans un salon. |
join_watch_party |
Rejoint une session de visionnage active. |
leave_watch_party |
Quitte une session de visionnage. |
control_watch_party |
Lance la lecture, met en pause ou se déplace dans la vidéo pour toute la salle. |
end_watch_party |
Termine une session de visionnage pour tout le monde. |
send_watch_party_emote |
Envoie une emote en temps réel dans la session de visionnage. |
Demandes de message
Interrupteur Demandes de messageFais le tri parmi les personnes qui veulent 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. |
Salons vocaux
Interrupteur VocalConsulte et contrôle la session vocale en cours sur 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 CompteGè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 les personnes qui peuvent voir ta position en ce moment. |
Outils des comptes de bot
Interrupteur Bot · comptes de bot uniquementPublie des cartes enrichies interactives et récupère 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 enrichie avec des boutons facultatifs (comptes de bot uniquement). |
get_bot_events |
Récupère à la demande 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 agentsConfigure les agents d’un salon, associe des projets, suis les tâches en direct et oriente le travail depuis la conversation. 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 |
Associe un projet et des instructions à un agent de salon. |
remove_agent_project |
Dissocie 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 requisesOrganise 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 uniquementLes mêmes files d’attente que celles qu’ouvre le bouton bouclier 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 photo de la carte en attente d’un vote de modérateur. |
approve_map_filter |
Vote pour approuver un filtre photo proposé. |
deny_map_filter |
Vote pour refuser un filtre photo proposé. |
list_report_queue |
Les contenus signalés en attente d’un vote de modérateur. |
approve_report |
Vote pour indiquer que le contenu signalé enfreint les règles. |
deny_report |
Vote pour indiquer que le contenu signalé est acceptable. |
community_map_propose_filter |
Soumet un nouveau filtre photo à l’examen des modérateurs. |
veto_map_filter |
Réservé à l’équipe : retire immédiatement un filtre photo (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 laisse à nouveau se mettre en veille. |