Перейти к содержимому
Открыть приложение

Инструменты MCP — обзор

Права доступа

Инструментам MCP присваиваются три уровня области действия:

Область действияЗначение
readТолько доступ на чтение; без права создания, редактирования или удаления
writeЧтение и запись источников, каналов, входящих сообщений; без доступа к настройкам команды
adminПолный доступ к MCP, включая настройки команды

При подключениях через OAuth выбранная при авторизации область доступа ограничивает набор доступных инструментов. При использовании токенов API максимальный уровень доступа определяется ролью токена.


Инструменты чтения

Все инструменты чтения требуют как минимум области действия read.

search_updates

Выполняет поиск в обновлениях по ключевым словам, источникам, тегам и периоду времени.

Требуемый объем доступа: read

ПараметрТипОписание
queryСтрокаКлючевое слово для полнотекстового поиска (необязательно)
source_idСтрокаОбновления из определенного источника (необязательно)
tagsМассивТеги обновлений, по которым осуществляется фильтрация (необязательно)
folderСтрокаinbox, saved или dropped (необязательно)
source_ownershipСтрокаall (по умолчанию), own (только собственные источники) или competitor (только сторонние источники)
limitЦелое числоКоличество результатов (по умолчанию: 20, макс.: 100)

Фильтр source_ownership использует поле is_own в источнике. Он является аналогом фильтра «Ownership» в интерфейсе «Inbox» и позволяет ИИ-помощнику целенаправленно анализировать только собственное присутствие или только конкурентов.


get_update_details

Возвращает полное содержание отдельного обновления.

Требуемый объем: read

ПараметрТипОписание
update_idСтрокаИдентификатор обновления

list_sources

Выводит список всех источников рабочего пространства.

Требуемый объем: read

ПараметрТипОписание
is_ownБулево значениеtrue = только собственные источники, false = только конкуренты, опущено = все

Каждый возвращаемый источник содержит поле is_own, чтобы ИИ-помощники могли отделять собственное присутствие от конкурентов без необходимости отправлять второй запрос.


list_reports

Перечисляет доступные отчёты ИИ.

Требуемый объем: read

ПараметрТипОписание
typeСтрокаsummary, feedback, list, linkedin_post, conversation_starters (необязательно)
limitЦелое числоКоличество (по умолчанию: 10)

get_report

Возвращает полное содержимое отчета.

Требуемый область действия: read

ПараметрТипОписание
report_idСтрокаИдентификатор отчёта

get_team_context

Возвращает контекст ИИ рабочей области: метаданные команды (название, язык, часовой пояс), URL-адрес веб-сайта, контекстные документы и настройки владения.

Требуемая область: read

Обязательных параметров нет.

Ответ содержит в блоке context:

  • website_url – сохраненный URL организации
  • is_own_sources_configuredtrue, если хотя бы один источник помечен как собственный
  • own_sources_count – количество собственных источников

ИИ-помощники должны предлагать сравнения по показателям Voice Share или Momentum только в том случае, если is_own_sources_configured равно true — в противном случае отсутствует основа для сравнения.


list_tags

Выводит список всех тегов рабочего пространства.

Требуемый объем: read

ПараметрТипОписание
typeСтрокаsources, channels, updates (необязательно)

Инструменты записи

Все инструменты записи требуют как минимум область действия write.

create_source

Создает новый источник.

Требуемый уровень доступа: write

ПараметрТипОписание
urlСтрокаURL-адрес веб-сайта источника
nameСтрокаВнутреннее имя
tagsМассивИдентификаторы тегов (опционально)

update_source

Изменяет название, URL или теги существующего источника.

Требуемый объем: write

ПараметрТипОписание
source_idСтрокаИдентификатор источника
nameСтрокаНовое имя (необязательно)
urlСтрокаНовый URL (необязательно)

delete_source

Удаляет источник, включая все каналы и обновления.

Требуемый объем: write

ПараметрТипОписание
source_idСтрокаИдентификатор источника

create_channel

Вручную создает канал.

Требуемый объем: write

ПараметрТипОписание
source_idСтрокаИдентификатор родительского источника
urlСтрокаURL канала
nameСтрокаНазвание канала (необязательно)

update_channel

Изменяет название или описание канала.

Требуемый объем: write

ПараметрТипОписание
channel_idСтрокаИдентификатор канала
nameСтрокаНовое название (необязательно)

delete_channel

Удаляет канал.

Требуемый объем: write

ПараметрТипОписание
channel_idСтрокаИдентификатор канала

toggle_channel

Включает или отключает канал.

Требуемый объем: write

ПараметрТипОписание
channel_idСтрокаИдентификатор канала
activeБулево значениеtrue = активен, false = неактивен

create_tag

Создает новый тег.

Требуемый область действия: write

ПараметрТипОписание
nameСтрокаИмя тега
typeСтрокаsources, channels или updates
descriptionСтрокаОписание тегирования ИИ (необязательно)

update_tag

Изменяет имя или описание тега.

Требуемый объем: write

ПараметрТипОписание
tag_idСтрокаИдентификатор тега
nameСтрокаНовое имя (необязательно)
descriptionСтрокаНовое описание ИИ (необязательно)

Дополнительные темы