---
title: "MCP: свържете Claude и други AI асистенти с mssgs"
description: "Свържете Claude, Cursor и други AI инструменти с mssgs чрез MCP. Локален сървър с разрешения и 127 инструмента: канали, съобщения, ботове и още."
canonical: https://docs.mss.gs/bg/mcp
language: bg
---

# Свържете AI асистент

Настолното приложение mssgs има вграден MCP сървър. Свържете Claude, Cursor или Codex и те могат да четат, обобщават и отговарят в каналите, които изберете, направо от вашия компютър.

## Какво можете да направите

- **Чете и обобщава** Канали, лични съобщения, споменавания и закачени съобщения, само в каналите, които споделите.

- **Пише, когато позволите** Изпраща, отговаря, реагира, редактира и закача, след като включите изпращането.

- **Играе игри** Приема покана, чете дъската и прави истински ходове.

- **Контролът остава у вас** Изключено по подразбиране, първо само четене, само локално, отделен токен за всеки AI инструмент, който можете да отмените.

В приложението

Питате в своя AI инструмент; той чете #general чрез MCP сървъра и публикува обобщението от ваше име, защото сте разрешили изпращането.

- [Общ преглед](#overview)

- [Свързване](#connect)

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

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

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

## Общ преглед

Настолното приложение mssgs идва с вграден **MCP сървър** (Model Context Protocol), така че AI асистенти като Claude или Cursor могат да четат и да действат във вашето работно пространство. Той работи локално на вашия компютър и комуникира със сесията ви в mssgs; не ви трябват отделен акаунт за бот или хостинг.

### Вие решавате какво вижда

Сървърът работи само на localhost , докато mssgs е отворено и сте влезли в акаунта си. Вие избирате кои канали да споделите и включвате, група по група, какво може да прави асистентът. В момента има **127 инструмента** в 14 групи.

## Свързване

Удостоверяване с Bearer токен от [страницата с настройки AI / MCP](https://mss.gs/bg/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 настройките на вашия AI инструмент. Вижте [ръководството стъпка по стъпка](https://mss.gs/bg/help/bots-mcp/connect-your-ai) в Центъра за помощ.

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

Кои инструменти вижда асистентът, зависи от превключвателите, които включите. Инструментите само за четене са винаги включени; всичко останало е зад превключвател за съответната група. Управлението на сървъри и модерацията допълнително проверяват реалните ви права в акаунта.

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

### Токени

Токените имат имена, отделни са за всеки AI инструмент и се отменят с едно кликване, а графиката на активността при всеки токен показва точно кога е използван. Добра практика: един токен на инструмент, с ясно име. Изгубен лаптоп? Отменете токена му и той става безполезен.

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

Отворете MCP endpoint-а като поток ( 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/bg/bots).

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

Всеки инструмент по-долу е реално действие в mssgs. Имената са точните MCP идентификатори. Инструментите се появяват едва след като групата им е включена.

### Четене

Инструменти само за четене, достъпни от момента, в който сървърът е включен. Те виждат единствено каналите, които сте споделили.

| Инструмент | Какво прави |
| --- | --- |
| list_channels | Изброява каналите, които сте споделили с AI инструментите. |
| 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 | Предава или напуска игра. |

### Watch party

Започвайте и управлявайте съвместни прожекции, влизайте в стаята и реагирайте заедно в реално време.

| Инструмент | Какво прави |
| --- | --- |
| list_watch_parties | Изброява активните watch party, до които имате достъп. |
| get_watch_party | Взема пълното състояние на едно watch party. |
| start_watch_party | Започва watch party в канал. |
| join_watch_party | Присъединява се към активно watch party. |
| leave_watch_party | Напуска watch party. |
| control_watch_party | Пуска, паузира или превърта за цялата стая. |
| end_watch_party | Приключва watch party за всички. |
| send_watch_party_emote | Изпраща емоция в реално време към watch party. |

### Заявки за лични съобщения

Решавайте кой може да започне разговор с вас.

| Инструмент | Какво прави |
| --- | --- |
| 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 | Изтрива тригер. |

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

Същите опашки за преглед, които бутонът с щита отваря в приложението. Гласовете и ветото пак изискват истински акаунт на модератор (или на екипа на mssgs).

| Инструмент | Какво прави |
| --- | --- |
| 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 | Само за екипа на mssgs: сваля филтър за картата веднага (необратимо). |

### Помощни инструменти

Малки помощници за асистенти, които работят дълго.

| Инструмент | Какво прави |
| --- | --- |
| keep_computer_awake | Не позволява на компютъра да заспи, докато работите, или премахва тази забрана. |

## Продължете нататък