Инструменты 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_configured–true, если хотя бы один источник помечен как собственный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 | Строка | Новое описание ИИ (необязательно) |