Desarrolladores MCP

Conecta un asistente de IA

La app de escritorio de mssgs lleva integrado un servidor MCP. Conecta Claude, Cursor o Codex y podrán leer, resumir y responder en los canales que elijas, directamente desde tu propio ordenador.

Qué puedes hacer

Lee y resumeCanales, MD, menciones y mensajes fijados, solo en los canales que compartas con la IA.
Escribe cuando lo permitesEnvía, responde, reacciona, edita y fija mensajes en cuanto activas el envío.
JuegaAcepta una invitación, lee el tablero y hace jugadas de verdad.
Tú tienes el controlDesactivado por defecto, primero solo lectura, solo en local y con un token revocable por cada herramienta de IA.

En la app

> Resume #general en tres puntos y publícalo en #daily

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

● send_message (channel: "daily")

Publicado en #daily.

daily

maya09:31

Resumen de #general de hoy:
• El lanzamiento pasa al viernes.
• Dani se encarga de las notas de la versión.
• A partir de ahora, el standup es a las 09:30.

Lo pides en tu herramienta de IA; esta lee #general a través del servidor MCP y publica el resumen en tu nombre, porque has permitido el envío.

Descripción general

La app de escritorio de mssgs incluye un servidor MCP (Model Context Protocol) integrado, para que asistentes de IA como Claude o Cursor puedan leer y actuar en tu espacio de trabajo. Se ejecuta en local en tu ordenador y se comunica con tu sesión iniciada de mssgs; no necesitas una cuenta de bot aparte ni alojamiento.

Tú decides lo que ve

El servidor solo funciona en localhost, mientras mssgs está abierto y tienes la sesión iniciada. Tú eliges qué canales compartes y activas, grupo por grupo, lo que puede hacer el asistente. Ahora mismo hay 127 herramientas en 14 grupos.

Conexión

MCP http://127.0.0.1:7444/mcp

Se autentica con un token Bearer de la página de ajustes AI / MCP de la app: activa el servidor, elige los canales que quieres compartir y pulsa “Copy config”; el bloque copiado ya contiene tu puerto y tu token. El servidor solo escucha en localhost (puerto 7444 por defecto) y funciona mientras mssgs está abierto y tienes la sesión iniciada.

Conecta Claude Code

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

Para Claude Desktop o Cursor: pega el bloque de “Copy config” en los ajustes MCP de tu herramienta de IA. Consulta la guía paso a paso en el centro de ayuda.

Permisos y tokens

Las herramientas que ve un asistente dependen de los interruptores que actives. Las de solo lectura están siempre activas; todo lo demás queda detrás del interruptor de su grupo. La gestión de servidores y la moderación comprueban además tus permisos reales en la cuenta.

Grupo	Desbloquea
Lectura	Siempre activo: leer mensajes, presencia, menciones y mensajes fijados en los canales compartidos
Envío e interacción	Enviar, responder, reaccionar, editar, borrar, fijar e indicador de escritura, además de presencia en MD, llamadas de voz y juegos
Watch parties	Iniciar sesiones para ver algo juntos, unirse a ellas y controlarlas
Solicitudes de MD	Ver, aceptar y rechazar las solicitudes de MD entrantes
Social	Perfiles, historias y tus filtros del mapa
Canales de voz	Unirse a canales de voz, ver a los participantes y controlar tu micrófono
Cuenta y privacidad	Amigos, bloqueos, silencios, estado de lectura, clips y ubicación compartida
Control de agentes	Configurar los agentes del canal, los proyectos y las tareas en curso
Gestión del servidor	Canales, categorías, grupos de permisos, miembros, invitaciones, emojis, webhooks y triggers (se siguen aplicando los permisos reales de gestión)
Moderación de la comunidad	Colas de revisión y votaciones (sigue siendo necesaria una cuenta de moderador o del equipo de mssgs)
Evitar la suspensión del ordenador	Impide que el ordenador entre en suspensión mientras el asistente trabaja
Herramientas de cuentas de bot	Tarjetas embed interactivas y sus eventos (solo cuentas de bot)

Tokens

Los tokens tienen nombre, van por herramienta de IA y se revocan con un clic, y cada uno tiene un minigráfico de actividad para que veas exactamente cuándo se usó. Buena práctica: un token por herramienta, con un nombre claro. ¿Has perdido el portátil? Revoca su token y ya no sirve para nada.

Eventos en tiempo real por SSE

Abre el endpoint MCP como stream (GET /mcp con Accept: text/event-stream) y recibirás las notificaciones JSON-RPC en el momento en que ocurren:

Notificación	Se emite con
`notifications/mssgs/message`	Mensajes nuevos en los canales que puedes ver
`notifications/mssgs/bot_event`	Pulsaciones de botones, reacciones y respuestas a los mensajes que tu asistente publicó mediante send_bot_message
`notifications/mssgs/presence`	Cambios de presencia
`notifications/mssgs/typing`	Indicadores de escritura
`notifications/mssgs/call`	Eventos de llamadas de voz

Tarjetas de bot interactivas

Tarjetas de bot interactivas desde tu asistente

Publica una tarjeta embed con botones mediante send_bot_message, escucha bot_event en el stream (o consulta get_bot_events) y actualiza la tarjeta en el mismo sitio con edit_message. Es el mismo modelo de tarjeta que en la documentación de mensajes de bot.

Referencia de herramientas (127)

Cada herramienta de abajo es una acción real en mssgs. Los nombres son los identificadores MCP exactos. Las herramientas solo aparecen cuando su grupo está activado.

Lectura

Siempre activo

Herramientas de solo lectura, disponibles en cuanto el servidor está activo. Solo ven los canales que has compartido.

Herramienta	Qué hace
`list_channels`	Lista los canales que has compartido con las herramientas de IA.
`read_channel`	Lee los mensajes recientes de un canal compartido.
`get_new_messages`	Obtiene los mensajes posteriores a una marca de tiempo en todos los canales compartidos.
`get_channel_stamp`	El estado de lectura de un canal, con el número de mensajes sin leer y de menciones.
`get_presence`	Quién está presente en un canal y con qué estado.
`get_message`	Obtiene un mensaje completo por su id, con embeds y vistas previas de enlaces.
`search_messages`	Busca texto en los mensajes de los canales compartidos de un servidor.
`get_message_context`	Lee los mensajes que rodean a un resultado de búsqueda.
`get_account`	Muestra la cuenta con la sesión iniciada y las capacidades de las que dispone.
`get_typing`	Quién está escribiendo ahora mismo en un canal.
`list_mentions`	Mensajes recientes en los que te @mencionan.
`list_pinned_messages`	Los mensajes fijados de un canal.
`subscribe_channel`	Se suscribe a un canal para recibir actualizaciones en tiempo real.
`unsubscribe_channel`	Deja de recibir actualizaciones en tiempo real de un canal.
`list_subscriptions`	Lista los canales a los que estás suscrito en tiempo real.

Envío e interacción

Interruptor de envío

Publica y actúa como el usuario con la sesión iniciada. Todo lo que hay aquí escribe en un canal, así que queda detrás de un único interruptor.

Herramienta	Qué hace
`send_message`	Envía un mensaje a un canal en tu nombre.
`reply_message`	Responde a un mensaje concreto, vinculado a él.
`add_reaction`	Añade una reacción con emoji a un mensaje.
`remove_reaction`	Quita una de tus reacciones con emoji.
`edit_message`	Edita uno de tus propios mensajes.
`delete_message`	Borra uno de tus propios mensajes.
`pin_message`	Fija un mensaje (requiere permiso para fijar).
`unpin_message`	Deja de fijar un mensaje fijado.
`open_one_view_attachment`	Abre una foto o un vídeo de visualización única en un MD.
`set_typing`	Muestra en directo el indicador “escribiendo…”.
`stop_typing`	Quita el indicador de escritura.

Presencia y llamadas en MD

Interruptor de envío

Estar presente en un MD y hacer llamadas de voz reales: start_dm_call usa el micrófono de este ordenador, exactamente igual que pulsar llamar en la app.

Herramienta	Qué hace
`enter_dm_chat`	Te muestra como presente en un MD.
`leave_dm_chat`	Deja de mostrarte como presente en un MD.
`start_dm_call`	Inicia una llamada de voz en un MD (usa el micrófono de este ordenador).
`answer_dm_call`	Contesta una llamada entrante en un MD.
`decline_dm_call`	Rechaza una llamada entrante en un MD.
`end_dm_call`	Cuelga o cancela una llamada en un MD.
`get_call_status`	El estado actual de la llamada de voz y cualquier llamada entrante.

Juegos

Interruptor de envío

Únete a los minijuegos integrados de mssgs y juega directamente desde tu asistente.

Herramienta	Qué hace
`list_game_invites`	Invitaciones a partidas pendientes dirigidas a ti.
`list_active_games`	Las salas de juego en las que estás jugando ahora.
`accept_game_invite`	Acepta una invitación por room_id o por código para unirse.
`get_game_state`	El tablero o el estado en directo de una partida en la que estás.
`game_move`	Juega un turno en una partida.
`resign_game`	Se rinde o abandona una partida.

Watch parties

Interruptor de watch parties

Inicia y controla sesiones para ver algo juntos, únete a la sala y reacciona con los demás en tiempo real.

Herramienta	Qué hace
`list_watch_parties`	Lista las watch parties activas a las que tienes acceso.
`get_watch_party`	Obtiene el estado completo de una watch party.
`start_watch_party`	Inicia una watch party en un canal.
`join_watch_party`	Se une a una watch party activa.
`leave_watch_party`	Sale de una watch party.
`control_watch_party`	Reproduce, pausa o salta a otro punto para toda la sala.
`end_watch_party`	Termina una watch party para todos.
`send_watch_party_emote`	Envía un emote en tiempo real a la watch party.

Solicitudes de MD

Interruptor de solicitudes de MD

Decide quién puede empezar una conversación contigo.

Herramienta	Qué hace
`view_dm_requests`	Tus solicitudes de MD entrantes pendientes.
`accept_dm_request`	Acepta una solicitud de MD.
`deny_dm_request`	Rechaza una solicitud de MD.

Social: perfiles, historias, mapa

Interruptor social

Consulta perfiles, mira historias y revisa los filtros del mapa que has enviado.

Herramienta	Qué hace
`get_profile`	El perfil público de un usuario por su user_guid.
`list_story_users`	Personas con una historia sin ver que puedes ver.
`view_story`	Muestra las historias activas de un usuario.
`list_map_filters`	Los filtros del mapa enviados desde esta cuenta, con su estado de moderación.

Canales de voz

Interruptor de voz

Consulta y controla la sesión de canal de voz en curso en este ordenador.

Herramienta	Qué hace
`list_voice_channels`	Lista los canales de voz de un servidor.
`get_voice_state`	Obtiene la sesión de voz actual y sus participantes.
`join_voice_channel`	Se une a un canal de voz en este ordenador.
`leave_voice_channel`	Sale del canal de voz actual.
`set_voice_muted`	Silencia o activa el micrófono de este ordenador.

Cuenta y privacidad

Interruptor de cuenta

Gestiona amigos, bloqueos, silencios, estado de lectura y clips sin exponer los secretos de la cuenta.

Herramienta	Qué hace
`list_friends`	Lista tus amigos.
`list_blocked`	Lista las cuentas que has bloqueado.
`block_user`	Bloquea una cuenta.
`unblock_user`	Desbloquea una cuenta.
`list_mutes`	Lista los canales y servidores silenciados.
`mute_channel`	Silencia un canal.
`unmute_channel`	Deja de silenciar un canal.
`mute_server`	Silencia un servidor.
`unmute_server`	Deja de silenciar un servidor.
`mark_channel_read`	Marca un canal como leído.
`list_clips`	Lista los clips que has creado.
`share_clip`	Hace que uno de tus clips se pueda compartir.
`unshare_clip`	Deja de compartir un clip.
`rename_clip`	Cambia el nombre de uno de tus clips.
`list_stickers`	Lista los stickers que tienes disponibles.
`list_friend_locations`	Lista los amigos que ahora mismo comparten su ubicación contigo.
`list_location_viewers`	Lista quién puede ver ahora mismo tu ubicación.

Herramientas de cuentas de bot

Interruptor de bot · solo cuentas de bot

Publica tarjetas embed interactivas y lee las interacciones que reciben. Disponible con la sesión iniciada en una cuenta de bot.

Herramienta	Qué hace
`send_bot_message`	Publica una tarjeta embed enriquecida con botones opcionales (solo cuentas de bot).
`get_bot_events`	Consulta las pulsaciones de botones, las reacciones y las respuestas a los mensajes de tu bot.
`set_bot_status`	Pone o quita un estado de presencia personalizado (solo cuentas de bot).

Control de agentes

Interruptor de control de agentes

Configura los agentes de un canal, asigna proyectos, consulta las tareas en curso y dirige el trabajo desde el chat. Las acciones de gestión siguen requiriendo permisos en el canal.

Herramienta	Qué hace
`list_agent_channels`	Lista los canales compartidos y la configuración de sus agentes.
`get_channel_agents`	Obtiene la configuración completa de agentes de un canal.
`set_channel_agents`	Activa los agentes y actualiza las reglas de agentes de un canal.
`add_channel_agent`	Añade un agente disponible a un canal.
`remove_channel_agent`	Quita un agente de un canal.
`set_agent_project`	Asigna un proyecto e instrucciones a un agente del canal.
`remove_agent_project`	Desvincula un proyecto de un agente del canal.
`list_agent_tasks`	Lista las tareas de agentes actuales y recientes.
`get_agent_task`	Obtiene el estado en directo y la salida de una tarea de agente.
`steer_agent_task`	Envía una instrucción adicional a una tarea de agente en curso.

Gestión del servidor

Interruptor de gestión del servidor · requiere permisos de gestión

Da forma a un servidor que gestionas: canales, categorías, grupos de permisos, webhooks y triggers. Cada llamada sigue comprobando tus permisos reales de gestión en ese servidor.

Herramienta	Qué hace
`list_manageable_servers`	Los servidores que puedes gestionar y los permisos que tienes en ellos.
`get_server_structure`	La estructura completa de canales y categorías de un servidor.
`create_channel`	Crea un canal.
`update_channel`	Cambia el nombre, el tipo o la posición de un canal.
`delete_channel`	Borra un canal (irreversible).
`create_category`	Crea una categoría de canales.
`update_category`	Cambia el nombre de una categoría.
`delete_category`	Borra una categoría (sus canales se quedan).
`list_server_groups`	Los grupos de permisos de un servidor.
`create_server_group`	Crea un grupo de permisos.
`update_server_group`	Cambia el nombre, el color o el alcance de un grupo de permisos.
`delete_server_group`	Borra un grupo de permisos.
`list_members`	Lista los miembros del servidor y sus grupos de permisos.
`add_member_to_group`	Añade a un miembro del servidor a un grupo de permisos.
`remove_member_from_group`	Quita a un miembro del servidor de un grupo de permisos.
`list_invites`	Lista las invitaciones activas al servidor.
`create_invite`	Crea una invitación al servidor.
`delete_invite`	Revoca una invitación al servidor.
`list_custom_emojis`	Lista los emojis personalizados de un servidor.
`list_webhooks`	Los webhooks entrantes de un servidor.
`create_webhook`	Crea un webhook entrante.
`get_webhook_url`	Obtiene la URL de un webhook a la que se puede publicar.
`update_webhook`	Actualiza los ajustes de un webhook.
`delete_webhook`	Borra un webhook (su URL deja de funcionar).
`list_triggers`	Los triggers salientes de un servidor.
`create_trigger`	Crea un trigger (los mensajes que coinciden se envían por POST a una URL).
`update_trigger`	Actualiza un trigger.
`delete_trigger`	Borra un trigger.

Moderación de la comunidad

Interruptor de moderación · solo moderadores y equipo de mssgs

Las mismas colas de revisión que abre el botón del escudo en la app. Los votos y los vetos siguen requiriendo una cuenta real de moderador (o del equipo de mssgs).

Herramienta	Qué hace
`get_moderation_stats`	Tu estado como moderador y cuánto hay pendiente.
`list_moderation_queue`	Filtros del mapa que esperan el voto de un moderador.
`approve_map_filter`	Vota a favor de aprobar un filtro del mapa enviado.
`deny_map_filter`	Vota a favor de rechazar un filtro del mapa enviado.
`list_report_queue`	Contenido denunciado que espera el voto de un moderador.
`approve_report`	Vota que el contenido denunciado incumple las normas.
`deny_report`	Vota que el contenido denunciado está bien.
`community_map_propose_filter`	Envía un nuevo filtro del mapa para su revisión.
`veto_map_filter`	Solo equipo de mssgs: retira un filtro del mapa de inmediato (irreversible).

Utilidades

Interruptor de evitar la suspensión

Pequeñas ayudas para asistentes que trabajan durante mucho tiempo.

Herramienta	Qué hace
`keep_computer_awake`	Evita que este ordenador entre en suspensión mientras trabajas, o deja de hacerlo.

Sigue construyendo

AgentesDeja que una IA asuma tareas dentro de un canal. WebhooksPublica en un canal desde un script. Conecta tu IALa configuración, paso a paso, en el centro de ayuda. Tarjetas de mensajeLo que puede mostrar un mensaje de bot.