Підключіть ШІ-асистента
Настільний застосунок mssgs має вбудований MCP-сервер. Підключіть Claude, Cursor чи Codex, і вони зможуть читати, підсумовувати й відповідати у вибраних вами каналах просто з вашого комп’ютера.
Що можна зробити
- Читає й підсумовуєКанали, особисті повідомлення, згадки й закріплені повідомлення, лише в тих каналах, які ви відкрили.
- Пише, коли ви дозволитеНадсилає, відповідає, реагує, редагує й закріплює, щойно ви ввімкнете надсилання.
- Грає в ігриПриймає запрошення, читає ігрове поле й робить справжні ходи.
- Контроль у ваших рукахВимкнено за замовчуванням, спершу лише читання, тільки локально, окремий токен для кожного ШІ-інструмента, який можна відкликати.
У застосунку
Ви просите у своєму ШІ-інструменті; він читає #general через MCP-сервер і публікує підсумок від вашого імені, бо ви дозволили надсилання.
Огляд
Настільний застосунок mssgs має вбудований MCP-сервер (Model Context Protocol), тож ШІ-асистенти, як-от Claude чи Cursor, можуть читати ваш робочий простір і діяти в ньому. Сервер працює локально на вашому комп’ютері та спілкується з вашою сесією mssgs, у яку ви ввійшли; окремий обліковий запис бота чи хостинг не потрібні.
Ви вирішуєте, що він бачить
Сервер працює лише на localhost, поки mssgs відкрито і ви ввійшли в обліковий запис. Ви вибираєте, які канали відкрити, і вмикаєте, що асистенту дозволено робити, група за групою. Зараз доступно 127 інструментів у 14 групах.
Підключення
http://127.0.0.1:7444/mcp
Автентифікація відбувається за Bearer-токеном зі сторінки налаштувань AI / MCP застосунку: увімкніть сервер, виберіть канали, які хочете відкрити, і натисніть «Copy config»; скопійований блок уже містить ваш порт і токен. Сервер слухає лише localhost (типовий порт 7444) і працює, поки mssgs відкрито і ви ввійшли в обліковий запис.
claude mcp add --transport http mssgs http://127.0.0.1:7444/mcp \
--header "Authorization: Bearer <your-token>"
Для Claude Desktop або Cursor: вставте блок із «Copy config» у налаштування MCP вашого ШІ-інструмента. Див. покрокову інструкцію в довідковому центрі.
Дозволи й токени
Які інструменти бачить асистент, залежить від перемикачів, які ви ввімкнули. Інструменти лише для читання ввімкнено завжди; усе інше захищено перемикачем групи. Керування серверами та модерація додатково перевіряють ваші справжні дозволи в обліковому записі.
| Група | Що відкриває |
|---|---|
| Читання | Завжди ввімкнено: читання повідомлень, присутності, згадок і закріплень у відкритих каналах |
| Надсилання та взаємодія | Надсилання, відповіді, реакції, редагування, видалення, закріплення, індикатор набору, а також присутність в особистих чатах, голосові дзвінки та ігри |
| Спільні перегляди | Запуск спільних переглядів, приєднання до них і керування ними |
| Запити на особисті повідомлення | Перегляд, прийняття та відхилення вхідних запитів на особисті повідомлення |
| Соціальне | Профілі, історії та ваші фільтри карти |
| Голосові канали | Приєднання до голосу, перегляд учасників і керування мікрофоном |
| Обліковий запис і приватність | Друзі, блокування, вимкнені сповіщення, стан прочитання, кліпи та поширення геопозиції |
| Скерування агентів | Налаштування агентів каналу, проєктів і живих завдань |
| Керування сервером | Канали, категорії, групи дозволів, учасники, запрошення, емодзі, вебхуки й тригери (справжні дозволи на керування однаково перевіряються) |
| Модерація спільноти | Черги перевірки та голосування (однаково потрібен обліковий запис модератора або персоналу) |
| Не давати комп’ютеру заснути | Не дає машині засинати, поки асистент працює |
| Інструменти облікового запису бота | Інтерактивні embed-картки та їхні події (лише облікові записи ботів) |
Токени
Токени мають назви, створюються для кожного ШІ-інструмента окремо й відкликаються одним клацанням, а графік активності кожного токена показує, коли саме його використовували. Добра звичка: один токен на інструмент, із зрозумілою назвою. Загубили ноутбук? Відкличте його токен, і той стане марним.
Події в реальному часі через 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 | Події голосових дзвінків |
Інтерактивні картки ботів
Інтерактивні картки ботів від вашого асистента
Опублікуйте embed-картку з кнопками через 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 |
Відхиляє запит на особисті повідомлення. |
Голосові канали
Перемикач «Голос»Переглядайте поточну сесію голосового каналу на цьому комп’ютері та керуйте нею.
| Інструмент | Що він робить |
|---|---|
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 |
Список тих, хто зараз бачить вашу геопозицію. |
Інструменти облікового запису бота
Перемикач «Бот» · лише облікові записи ботівПублікуйте інтерактивні embed-картки та зчитуйте взаємодії з ними. Доступно, коли ви ввійшли як обліковий запис бота.
| Інструмент | Що він робить |
|---|---|
send_bot_message |
Публікує багату embed-картку з необов’язковими кнопками (лише облікові записи ботів). |
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 |
Не дає цьому комп’ютеру заснути, поки ви працюєте, або знімає це обмеження. |