MCP-Tools — огляд
Права доступу
Інструментам 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 у джерелі. Він є аналогом фільтра «Власність» у інтерфейсі вхідної пошти та дозволяє ШІ-помічнику цілеспрямовано розглядати лише власні публікації або лише публікації конкурентів.
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 | Рядок | Новий опис ШІ (опціонально) |