---
title: "MCP: подключите Claude и других ИИ-ассистентов к mssgs"
description: "Подключите Claude, Cursor и другие ИИ-инструменты к mssgs через MCP. Локальный сервер с разрешениями и 127 инструментами: чтение каналов, сообщения и другое."
canonical: https://docs.mss.gs/ru/mcp
language: ru
---

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

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

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

- **Чтение и сводки** Каналы, личные сообщения, упоминания и закреплённые сообщения, только в тех каналах, которые вы открыли.

- **Запись, когда вы разрешите** Отправка, ответы, реакции, правка и закрепление, после того как вы включите отправку.

- **Игры** Принять приглашение, прочитать доску и сделать настоящие ходы.

- **Всё под вашим контролем** Выключено по умолчанию, сначала только чтение, только локально, отдельный отзываемый токен для каждого ИИ-инструмента.

В приложении

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

- [Обзор](#overview)

- [Подключение](#connect)

- [Разрешения и токены](#permissions)

- [События в реальном времени](#events)

- [Инструменты](#tools)

## Обзор

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

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

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

## Подключение

Аутентификация выполняется Bearer-токеном со страницы настроек приложения [Доступ ИИ / MCP](https://mss.gs/ru/help/bots-mcp/connect-your-ai): включите сервер, выберите каналы, которые нужно открыть, и нажмите «Копировать конфиг»; в скопированном блоке уже есть ваш порт и токен. Сервер слушает только localhost (порт по умолчанию 7444) и работает, пока mssgs открыт и вы вошли в аккаунт.

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

Для Claude Desktop или Cursor: вставьте блок из «Копировать конфиг» в настройки MCP вашего ИИ-инструмента. Подробнее в [пошаговом руководстве](https://mss.gs/ru/help/bots-mcp/connect-your-ai) в справочном центре.

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

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

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

### Токены

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

## События в реальном времени через 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 . Модель карточек та же, что в документации по [сообщениям ботов](https://docs.mss.gs/ru/bots).

## Справочник инструментов (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 | Не давать этому компьютеру засыпать, пока вы работаете, или снова разрешить сон. |

## Что дальше