---
title: "MCP: conecta Claude y otros asistentes de IA a mssgs"
description: "Conecta Claude, Cursor y otras herramientas de IA a mssgs por MCP. Servidor local con permisos y 127 herramientas: canales, mensajes, bots y moderación."
canonical: https://docs.mss.gs/es/mcp
language: es
---

# 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 resume** Canales, MD, menciones y mensajes fijados, solo en los canales que compartas con la IA.

- **Escribe cuando lo permites** Envía, responde, reacciona, edita y fija mensajes en cuanto activas el envío.

- **Juega** Acepta una invitación, lee el tablero y hace jugadas de verdad.

- **Tú tienes el control** Desactivado por defecto, primero solo lectura, solo en local y con un token revocable por cada herramienta de IA.

En la app

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](#overview)

- [Conexión](#connect)

- [Permisos y tokens](#permissions)

- [Eventos en tiempo real](#events)

- [Herramientas](#tools)

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

Se autentica con un token Bearer de la [página de ajustes AI / MCP](https://mss.gs/es/help/bots-mcp/connect-your-ai) 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.

```bash
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](https://mss.gs/es/help/bots-mcp/connect-your-ai) 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](https://docs.mss.gs/es/bots).

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

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

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

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

Ú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

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

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

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

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

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

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

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

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

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

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