Перейти до вмісту
До застосунку

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_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РядокНовий опис ШІ (опціонально)

Додаткові теми