Разработчикам MCP

Подключите ИИ-ассистента

В настольное приложение mssgs встроен MCP-сервер. Подключите Claude, Cursor или Codex, и они смогут читать выбранные вами каналы, делать по ним сводки и отвечать в них прямо с вашего компьютера.

Что можно сделать

Чтение и сводкиКаналы, личные сообщения, упоминания и закреплённые сообщения, только в тех каналах, которые вы открыли.
Запись, когда вы разрешитеОтправка, ответы, реакции, правка и закрепление, после того как вы включите отправку.
ИгрыПринять приглашение, прочитать доску и сделать настоящие ходы.
Всё под вашим контролемВыключено по умолчанию, сначала только чтение, только локально, отдельный отзываемый токен для каждого ИИ-инструмента.

В приложении

> Кратко перескажи #general в трёх пунктах и опубликуй в #daily

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

● send_message (channel: "daily")

Опубликовано в #daily.

daily

maya09:31

Сводка по #general за сегодня:
• Запуск перенесли на пятницу.
• За заметки о выпуске отвечает Dani.
• Стендап теперь в 09:30.

Вы просите в своём ИИ-инструменте; он читает #general через MCP-сервер и публикует сводку от вашего имени, потому что вы разрешили отправку.

Обзор

В настольное приложение mssgs встроен MCP-сервер (Model Context Protocol), так что ИИ-ассистенты вроде Claude или Cursor могут читать ваше пространство и действовать в нём. Сервер работает локально на вашем компьютере и обращается к сессии mssgs, в которой вы вошли; отдельный аккаунт бота или хостинг не нужны.

Вы решаете, что он видит

Сервер работает только на localhost, пока mssgs открыт и вы вошли в аккаунт. Вы выбираете, какие каналы открыть, и по группам включаете то, что ассистенту разрешено делать. Сейчас это 127 инструментов в 14 группах.

Подключение

MCP http://127.0.0.1:7444/mcp

Аутентификация выполняется Bearer-токеном со страницы настроек приложения Доступ ИИ / MCP: включите сервер, выберите каналы, которые нужно открыть, и нажмите «Копировать конфиг»; в скопированном блоке уже есть ваш порт и токен. Сервер слушает только localhost (порт по умолчанию 7444) и работает, пока mssgs открыт и вы вошли в аккаунт.

Подключение Claude Code

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

Для Claude Desktop или Cursor: вставьте блок из «Копировать конфиг» в настройки MCP вашего ИИ-инструмента. Подробнее в пошаговом руководстве в справочном центре.

Разрешения и токены

Какие инструменты видит ассистент, зависит от включённых вами переключателей. Инструменты только для чтения включены всегда; всё остальное скрыто за переключателем группы. Управление сервером и модерация дополнительно проверяют ваши реальные права в аккаунте.

Группа	Что открывает
Чтение	Всегда включено: чтение сообщений, присутствия, упоминаний и закреплённых сообщений в открытых каналах
Отправка и взаимодействие	Отправка, ответы, реакции, изменение, удаление, закрепление, индикатор набора, а также присутствие в личных сообщениях, голосовые звонки и игры
Совместные просмотры	Запуск совместных просмотров, вход в них и управление ими
Запросы в личку	Просмотр, принятие и отклонение входящих запросов в личку
Соцфункции	Профили, истории и ваши фильтры карты
Голосовые каналы	Вход в голосовые каналы, просмотр участников и управление микрофоном
Аккаунт и конфиденциальность	Друзья, блокировки, отключённые уведомления, состояние прочтения, клипы и передача местоположения
Управление агентами	Настройка агентов канала, проектов и текущих задач
Управление сервером	Каналы, категории, группы прав, участники, приглашения, эмодзи, вебхуки и триггеры (реальные права на управление по-прежнему проверяются)
Модерация сообщества	Очереди проверки и голосования (по-прежнему нужен аккаунт модератора или сотрудника)
Не давать компьютеру засыпать	Компьютер не уходит в сон, пока ассистент работает
Инструменты аккаунта бота	Интерактивные карточки и их события (только аккаунты ботов)

Токены

Токены именуются отдельно для каждого ИИ-инструмента и отзываются одним нажатием, а мини-график активности у каждого токена показывает, когда именно он использовался. Хорошая привычка: один токен на инструмент, с понятным именем. Потеряли ноутбук? Отзовите его токен, и он станет бесполезен.

События в реальном времени через SSE

Откройте эндпоинт MCP как поток (GET /mcp с Accept: text/event-stream), и вы будете получать уведомления JSON-RPC по мере того, как всё происходит:

Уведомление	Когда приходит
`notifications/mssgs/message`	Новые сообщения в каналах, которые вы видите
`notifications/mssgs/bot_event`	Нажатия кнопок, реакции и ответы на сообщения, которые ваш ассистент опубликовал через send_bot_message
`notifications/mssgs/presence`	Изменения присутствия
`notifications/mssgs/typing`	Индикаторы набора текста
`notifications/mssgs/call`	События голосовых звонков

Интерактивные карточки ботов

Интерактивные карточки ботов от вашего ассистента

Опубликуйте карточку с кнопками через send_bot_message, слушайте bot_event в потоке (или опрашивайте get_bot_events) и обновляйте карточку на месте через edit_message. Модель карточек та же, что в документации по сообщениям ботов.

Справочник инструментов (127)

Каждый инструмент ниже выполняет реальное действие в mssgs. Имена совпадают с точными идентификаторами MCP. Инструменты появляются только после включения их группы.

Чтение

Всегда включено

Инструменты только для чтения, доступные сразу после включения сервера. Они видят только те каналы, которые вы открыли.

Инструмент	Что делает
`list_channels`	Список каналов, открытых вами для ИИ-инструментов.
`read_channel`	Прочитать последние сообщения из открытого канала.
`get_new_messages`	Получить сообщения новее заданной метки времени во всех открытых каналах.
`get_channel_stamp`	Состояние прочтения канала с числом непрочитанных сообщений и упоминаний.
`get_presence`	Кто присутствует в канале и какой у них статус.
`get_message`	Получить одно сообщение целиком по id, включая embed-карточки и превью ссылок.
`search_messages`	Поиск по тексту сообщений в открытых каналах сервера.
`get_message_context`	Прочитать сообщения непосредственно вокруг одного результата поиска.
`get_account`	Показать аккаунт, в который выполнен вход, и его доступные возможности.
`get_typing`	Кто сейчас печатает в канале.
`list_mentions`	Недавние сообщения, в которых вас упомянули через @.
`list_pinned_messages`	Закреплённые сообщения канала.
`subscribe_channel`	Подписаться на канал для обновлений в реальном времени.
`unsubscribe_channel`	Прекратить обновления канала в реальном времени.
`list_subscriptions`	Список каналов, на которые вы подписаны для обновлений в реальном времени.

Отправка и взаимодействие

Переключатель «Разрешить отправку сообщений»

Публикуйте и действуйте от имени пользователя, который вошёл в аккаунт. Всё здесь пишет в канал, поэтому находится за одним переключателем.

Инструмент	Что делает
`send_message`	Отправить сообщение в канал от вашего имени.
`reply_message`	Ответить на конкретное сообщение в ветке.
`add_reaction`	Добавить к сообщению реакцию эмодзи.
`remove_reaction`	Убрать одну из ваших реакций эмодзи.
`edit_message`	Изменить одно из ваших сообщений.
`delete_message`	Удалить одно из ваших сообщений.
`pin_message`	Закрепить сообщение (нужно право на закрепление).
`unpin_message`	Открепить закреплённое сообщение.
`open_one_view_attachment`	Открыть одноразовое фото или видео в личных сообщениях.
`set_typing`	Показать живой индикатор «печатает…».
`stop_typing`	Убрать индикатор набора текста.

Присутствие и звонки в личных сообщениях

Переключатель «Разрешить отправку сообщений»

Присутствуйте в личной переписке и совершайте настоящие голосовые звонки: start_dm_call использует микрофон этого компьютера, точно так же, как кнопка звонка в приложении.

Инструмент	Что делает
`enter_dm_chat`	Показать, что вы присутствуете в личной переписке.
`leave_dm_chat`	Перестать показываться присутствующим в личной переписке.
`start_dm_call`	Начать голосовой звонок в личных сообщениях (использует микрофон этого компьютера).
`answer_dm_call`	Ответить на входящий звонок в личных сообщениях.
`decline_dm_call`	Отклонить входящий звонок в личных сообщениях.
`end_dm_call`	Положить трубку или отменить звонок в личных сообщениях.
`get_call_status`	Текущее состояние голосового звонка и входящий звонок, если он есть.

Игры

Переключатель «Разрешить отправку сообщений»

Присоединяйтесь к встроенным мини-играм mssgs и играйте в них прямо из ассистента.

Инструмент	Что делает
`list_game_invites`	Открытые приглашения в игру, адресованные вам.
`list_active_games`	Игровые комнаты, в которых вы сейчас играете.
`accept_game_invite`	Принять приглашение по room_id или коду входа.
`get_game_state`	Текущее поле или состояние игры, в которой вы участвуете.
`game_move`	Сделать ход в игре.
`resign_game`	Сдаться или выйти из игры.

Совместные просмотры

Переключатель «Разрешить совместные просмотры»

Запускайте совместные просмотры и управляйте ими, заходите в комнату и реагируйте вместе в реальном времени.

Инструмент	Что делает
`list_watch_parties`	Список активных совместных просмотров, к которым у вас есть доступ.
`get_watch_party`	Получить полное состояние одного совместного просмотра.
`start_watch_party`	Начать совместный просмотр в канале.
`join_watch_party`	Присоединиться к активному совместному просмотру.
`leave_watch_party`	Выйти из совместного просмотра.
`control_watch_party`	Воспроизведение, пауза или перемотка для всей комнаты.
`end_watch_party`	Завершить совместный просмотр для всех.
`send_watch_party_emote`	Отправить эмоцию в совместный просмотр в реальном времени.

Запросы в личку

Переключатель «Разрешить запросы в личку»

Решайте, кому можно начать с вами переписку.

Инструмент	Что делает
`view_dm_requests`	Ваши открытые входящие запросы в личку.
`accept_dm_request`	Принять запрос в личку.
`deny_dm_request`	Отклонить запрос в личку.

Соцфункции: профили, истории, карта

Переключатель «Разрешить доступ к профилям и историям»

Находите профили, смотрите истории и видите отправленные вами фильтры карты.

Инструмент	Что делает
`get_profile`	Публичный профиль пользователя по user_guid.
`list_story_users`	Люди с непросмотренной историей, которую вы можете посмотреть.
`view_story`	Посмотреть активные истории пользователя.
`list_map_filters`	Фильтры карты, отправленные этим аккаунтом, с их статусом модерации.

Голосовые каналы

Переключатель «Разрешить голосовые каналы»

Просматривайте текущую сессию голосового канала на этом компьютере и управляйте ею.

Инструмент	Что делает
`list_voice_channels`	Список голосовых каналов на сервере.
`get_voice_state`	Текущая голосовая сессия и её участники.
`join_voice_channel`	Войти в голосовой канал на этом компьютере.
`leave_voice_channel`	Выйти из текущего голосового канала.
`set_voice_muted`	Выключить или включить микрофон этого компьютера.

Аккаунт и конфиденциальность

Переключатель «Разрешить настройки аккаунта»

Управляйте друзьями, блокировками, отключёнными уведомлениями, состоянием прочтения и клипами, не раскрывая секретов аккаунта.

Инструмент	Что делает
`list_friends`	Список ваших друзей.
`list_blocked`	Список заблокированных вами аккаунтов.
`block_user`	Заблокировать аккаунт.
`unblock_user`	Разблокировать аккаунт.
`list_mutes`	Список каналов и серверов с отключёнными уведомлениями.
`mute_channel`	Отключить уведомления канала.
`unmute_channel`	Включить уведомления канала.
`mute_server`	Отключить уведомления сервера.
`unmute_server`	Включить уведомления сервера.
`mark_channel_read`	Отметить канал как прочитанный.
`list_clips`	Список созданных вами клипов.
`share_clip`	Открыть доступ к одному из ваших клипов по ссылке.
`unshare_clip`	Закрыть доступ к клипу.
`rename_clip`	Переименовать один из ваших клипов.
`list_stickers`	Список доступных вам стикеров.
`list_friend_locations`	Список друзей, которые сейчас делятся с вами местоположением.
`list_location_viewers`	Список тех, кто сейчас видит ваше местоположение.

Инструменты аккаунта бота

Переключатель для ботов · только аккаунты ботов

Публикуйте интерактивные карточки и получайте взаимодействия с ними. Доступно, когда вы вошли в аккаунт бота.

Инструмент	Что делает
`send_bot_message`	Опубликовать карточку с необязательными кнопками (только аккаунты ботов).
`get_bot_events`	Опрашивать нажатия кнопок, реакции и ответы на сообщения вашего бота.
`set_bot_status`	Задать или убрать пользовательский статус присутствия (только аккаунты ботов).

Управление агентами

Переключатель «Разрешить управление агентами»

Настраивайте агентов канала, подключайте проекты, просматривайте текущие задачи и направляйте работу из чата. Для действий по управлению по-прежнему нужны права в канале.

Инструмент	Что делает
`list_agent_channels`	Список открытых каналов и настройка агентов в них.
`get_channel_agents`	Полная конфигурация агентов канала.
`set_channel_agents`	Включить агентов и обновить правила агентов канала.
`add_channel_agent`	Добавить доступного агента в канал.
`remove_channel_agent`	Удалить агента из канала.
`set_agent_project`	Подключить к агенту канала проект и инструкции.
`remove_agent_project`	Отключить проект от агента канала.
`list_agent_tasks`	Список текущих и недавних задач агентов.
`get_agent_task`	Текущее состояние и вывод одной задачи агента.
`steer_agent_task`	Отправить дополнительную инструкцию выполняющейся задаче агента.

Управление сервером

Переключатель «Разрешить управление серверами» · нужны права на управление

Настраивайте сервер, которым вы управляете: каналы, категории, группы прав, вебхуки и триггеры. Каждый вызов по-прежнему проверяет ваши реальные права на управление этим сервером.

Инструмент	Что делает
`list_manageable_servers`	Серверы, которыми вы можете управлять, и ваши права на них.
`get_server_structure`	Полная структура каналов и категорий сервера.
`create_channel`	Создать канал.
`update_channel`	Переименовать канал, сменить его тип или переместить.
`delete_channel`	Удалить канал (необратимо).
`create_category`	Создать категорию каналов.
`update_category`	Переименовать категорию.
`delete_category`	Удалить категорию (её каналы остаются).
`list_server_groups`	Группы прав сервера.
`create_server_group`	Создать группу прав.
`update_server_group`	Переименовать группу прав, сменить её цвет или набор прав.
`delete_server_group`	Удалить группу прав.
`list_members`	Список участников сервера и их групп прав.
`add_member_to_group`	Добавить участника сервера в группу прав.
`remove_member_from_group`	Убрать участника сервера из группы прав.
`list_invites`	Список активных приглашений на сервер.
`create_invite`	Создать приглашение на сервер.
`delete_invite`	Отозвать приглашение на сервер.
`list_custom_emojis`	Список собственных эмодзи сервера.
`list_webhooks`	Входящие вебхуки сервера.
`create_webhook`	Создать входящий вебхук.
`get_webhook_url`	Получить URL вебхука для отправки.
`update_webhook`	Изменить настройки вебхука.
`delete_webhook`	Удалить вебхук (его URL перестаёт работать).
`list_triggers`	Исходящие триггеры сервера.
`create_trigger`	Создать триггер (подходящие сообщения отправляются POST-запросом на URL).
`update_trigger`	Изменить триггер.
`delete_trigger`	Удалить триггер.

Модерация сообщества

Переключатель «Инструменты модерации сообщества» · только модераторы и сотрудники

Те же очереди проверки, что открывает кнопка со щитом в приложении. Для голосов и вето по-прежнему нужен настоящий аккаунт модератора (или сотрудника).

Инструмент	Что делает
`get_moderation_stats`	Ваш статус модератора и сколько всего ждёт проверки.
`list_moderation_queue`	Фильтры карты, ожидающие голоса модератора.
`approve_map_filter`	Проголосовать за одобрение отправленного фильтра карты.
`deny_map_filter`	Проголосовать за отклонение отправленного фильтра карты.
`list_report_queue`	Контент с жалобами, ожидающий голоса модератора.
`approve_report`	Проголосовать за то, что жалоба обоснована и правила нарушены.
`deny_report`	Проголосовать за то, что контент с жалобой в порядке.
`community_map_propose_filter`	Отправить новый фильтр карты на проверку.
`veto_map_filter`	Только для сотрудников: немедленно снять фильтр карты (необратимо).

Утилиты

Переключатель «Разрешить не давать компьютеру засыпать»

Небольшие помощники для ассистентов, которые работают долго.

Инструмент	Что делает
`keep_computer_awake`	Не давать этому компьютеру засыпать, пока вы работаете, или снова разрешить сон.

Что дальше

АгентыПусть ИИ берёт задачи прямо в канале. ВебхукиПубликуйте в канал из скрипта. Подключение ИИПошаговая настройка в справочном центре. Карточки сообщенийЧто может показать сообщение бота.