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

# Підключіть ШІ-асистента

Настільний застосунок 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-токеном зі [сторінки налаштувань AI / MCP](https://mss.gs/uk/help/bots-mcp/connect-your-ai) застосунку: увімкніть сервер, виберіть канали, які хочете відкрити, і натисніть «Copy config»; скопійований блок уже містить ваш порт і токен. Сервер слухає лише 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: вставте блок із «Copy config» у налаштування MCP вашого ШІ-інструмента. Див. [покрокову інструкцію](https://mss.gs/uk/help/bots-mcp/connect-your-ai) в довідковому центрі.

## Дозволи й токени

Які інструменти бачить асистент, залежить від перемикачів, які ви ввімкнули. Інструменти лише для читання ввімкнено завжди; усе інше захищено перемикачем групи. Керування серверами та модерація додатково перевіряють ваші справжні дозволи в обліковому записі.

| Група | Що відкриває |
| --- | --- |
| **Читання** | Завжди ввімкнено: читання повідомлень, присутності, згадок і закріплень у відкритих каналах |
| **Надсилання та взаємодія** | Надсилання, відповіді, реакції, редагування, видалення, закріплення, індикатор набору, а також присутність в особистих чатах, голосові дзвінки та ігри |
| **Спільні перегляди** | Запуск спільних переглядів, приєднання до них і керування ними |
| **Запити на особисті повідомлення** | Перегляд, прийняття та відхилення вхідних запитів на особисті повідомлення |
| **Соціальне** | Профілі, історії та ваші фільтри карти |
| **Голосові канали** | Приєднання до голосу, перегляд учасників і керування мікрофоном |
| **Обліковий запис і приватність** | Друзі, блокування, вимкнені сповіщення, стан прочитання, кліпи та поширення геопозиції |
| **Скерування агентів** | Налаштування агентів каналу, проєктів і живих завдань |
| **Керування сервером** | Канали, категорії, групи дозволів, учасники, запрошення, емодзі, вебхуки й тригери (справжні дозволи на керування однаково перевіряються) |
| **Модерація спільноти** | Черги перевірки та голосування (однаково потрібен обліковий запис модератора або персоналу) |
| **Не давати комп’ютеру заснути** | Не дає машині засинати, поки асистент працює |
| **Інструменти облікового запису бота** | Інтерактивні 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 . Модель карток та сама, що й у документації [повідомлень ботів](https://docs.mss.gs/uk/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 | Список тих, хто зараз бачить вашу геопозицію. |

### Інструменти облікового запису бота

Публікуйте інтерактивні 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 | Не дає цьому комп’ютеру заснути, поки ви працюєте, або знімає це обмеження. |

## Що далі