MCP-Tools — огляд

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

Інструментам MCP присвоюються три рівні доступу:

Рівень	Значення
`read`	Тільки доступ для читання; неможливо створювати, редагувати або видаляти
`write`	Читання та запис джерел, каналів, Inbox; відсутність доступу до налаштувань команди
`admin`	Повний доступ до MCP, включаючи налаштування команди

У разі підключень OAuth обсяг повноважень, обраний під час авторизації, обмежує перелік доступних інструментів. У разі API-токенів роль токена визначає максимальний рівень доступу.

Вибір Workspace

MCP-сервер розташований за адресою https://picasi.app/mcp, без Workspace в адресі.

Авторизація	Workspace
API-токен	фіксований, Workspace токена; параметр не потрібен
OAuth	усі Workspaces облікового запису; кожен виклик потребує `workspace_id`

За OAuth можливі значення видає list_workspaces. Без workspace_id виклик відхиляється.

Інструменти для читання

Усі інструменти для читання вимагають щонайменше сфери дії read.

`search_updates`

Здійснює пошук серед Updates за ключовими словами, джерелами, тегами та періодом часу.

Необхідна сфера дії: read

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

Фільтр source_ownership використовує поле is_own у джерелі. Він є аналогом фільтра «Власність» в інтерфейсі Inbox та дозволяє ШІ-помічнику цілеспрямовано розглядати лише власні публікації або лише публікації конкурентів.

`get_update_details`

Повертає повний вміст окремого Update.

Необхідний обсяг: read

Параметр	Тип	Опис
`update_id`	Рядок	Ідентифікатор Updates

`list_sources`

Виводить список усіх джерел Workspace.

Необхідний обсяг: read

Параметр	Тип	Опис
`is_own`	Логічне значення	`true` = тільки власні джерела, `false` = тільки конкуренти, пропустити = усі

Кожне повернуте джерело містить поле is_own, щоб ШІ-асистенти могли відокремлювати власну присутність від конкурентів без необхідності надсилати другий запит.

До кожного каналу додаються три поля, які варто розрізняти:

Поле	Значення
`monitoring_active`	Перемикач каналу: увімкнено чи вимкнено. Це не стан здоровʼя.
`state`	Стан отримання: `healthy`, `degraded`, `broken`, `quarantined` або `paused`. Поштові канали не опитуються, а приймають; вони повідомляють `receiving`, `stale` або `waiting`. `null` означає, що отримання ще не привʼязане.
`last_checked`	Остання спроба отримання, у поштових каналів — останній прийнятий лист.

Для повної діагностики окремого каналу є get_channel_status.

`list_reports`

Перелічує доступні звіти.

Необхідний обсяг: read

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

`get_report`

Повертає повний вміст звіту.

Необхідний обсяг: read

Параметр	Тип	Опис
`report_id`	Рядок	Ідентифікатор звіту

`get_team_context`

Повертає контекст ШІ Workspace: метадані команди (назва, мова, часовий пояс), URL-адресу веб-сайту, документи контексту та конфігурацію прав власності.

Необхідний обсяг: read

Обов’язкових параметрів немає.

Відповідь містить у блоці context:

website_url – збережений URL організації
is_own_sources_configured – true, якщо хоча б одне джерело позначено як власне
own_sources_count – кількість власних джерел

Асистенти на базі штучного інтелекту повинні пропонувати порівняння Voice Share або Momentum лише тоді, коли is_own_sources_configured дорівнює true — інакше відсутня основа для порівняння.

`list_tags`

Перелічує всі теги Workspace.

Необхідна область дії: read

Параметр	Тип	Опис
`type`	Рядок	`sources`, `channels`, `updates` (опціонально)

`get_update_statistics`

Рахує Updates замість того, щоб їх перелічувати. Приймає ті самі фільтри, що й search_updates, і не має межі у 100 результатів.

Необхідна сфера дії: read

Параметр	Тип	Опис
`group_by`	Рядок	`source` (за замовчуванням), `source_tag`, `update_tag`, `day`, `week`, `month`, `quarter`
`compare_previous_period`	Логічне значення	Додатково рахує однаково довгий попередній період і показує різницю
`query`	Рядок	Ключове слово для повнотекстового пошуку (необов’язково)
`source_id`	Рядок	Обмежити одним джерелом (необов’язково)
`source_tags`	Масив	Теги джерел (необов’язково)
`update_tags`	Масив	Тематичні теги (необов’язково)
`source_ownership`	Рядок	`all` (за замовчуванням), `own` або `competitor`
`platform`	Рядок	Обмежити однією платформою, наприклад `linkedin` (необов’язково)
`folder`	Масив	`inbox`, `saved`; за замовчуванням обидві
`days`	Ціле число	Період у днях, від 1 до 365 (за замовчуванням: 30)
`date_from`, `date_to`	Рядок	Період у вигляді дати, замість `days`

Групування за платформою недоступне. Відхилені Updates та Updates в Overflow не рахуються.

`get_channel_status`

Повертає стан каналу: останнє отримання, останній успіх, остання помилка, кількість невдач поспіль, наступна запланована спроба та кількість Updates із цього каналу.

Необхідна сфера дії: read

Параметр	Тип	Опис
`channel_id`	Рядок	ID каналу, з `list_sources` з `include_channels=true`

`discover_channels`

Досліджує вебсайт і повідомляє про канали, які можна було б відстежувати. Нічого не створює.

Необхідна сфера дії: read

Параметр	Тип	Опис
`url`	Рядок	Вебсайт для дослідження (необов’язково, якщо задано `source_id`)
`source_id`	Рядок	Використовує вебсайт цього джерела й позначає канали, які воно вже має

`list_workspaces`

Перелічує Workspaces авторизованого облікового запису з workspace_id, назвою та роллю.

Необхідна сфера дії: не потрібна; інструмент відкритий для будь-якого з’єднання

Без параметрів.

Інструменти звітів

`create_report`

Створює звіт із Updates, що відповідають фільтру. Фільтри ті самі, що й у search_updates.

Створення відбувається у фоні: виклик одразу повертає request_id. get_report_status каже, на якій він стадії, get_report читає готовий звіт.

Необхідна сфера дії: read

Параметр	Тип	Опис
`type`	Рядок	Обов’язково. `summary`, `feedback`, `list` або `conversation_starters`
`title`	Рядок	Назва звіту (необов’язково)
`instructions`	Рядок	Фокус для ШІ (необов’язково)
`language`	Рядок	Код мови, наприклад `de`; за замовчуванням мова Workspace
`query`	Рядок	Ключове слово для повнотекстового пошуку (необов’язково)
`source_ids`	Масив	Обмежити цими джерелами (необов’язково)
`source_tags`	Масив	Теги джерел (необов’язково)
`source_tags_mode`	Рядок	`AND` або `OR`
`update_tags`	Масив	Тематичні теги (необов’язково)
`update_tags_mode`	Рядок	`AND` або `OR`
`source_ownership`	Рядок	`all`, `own` або `competitor`
`platform`	Рядок	Обмежити однією платформою (необов’язково)
`folder`	Масив	Теки бази даних; за замовчуванням `inbox` та `saved`
`days`	Ціле число	Період у днях, від 1 до 365 (за замовчуванням: 30)
`date_from`, `date_to`	Рядок	Період у вигляді дати, замість `days`

`get_report_status`

Повертає стан звіту, замовленого через create_report.

Необхідна сфера дії: read

Параметр	Тип	Опис
`request_id`	Рядок	`request_id` із `create_report`

Статус	Значення
`queued`	чекає в черзі
`running`	створюється
`ready`	готовий; читай його через `get_report` і `report_id`
`empty`	завершено, але жоден Update не підійшов під фільтри
`failed`	перервано; причина вказана у відповіді

Інструменти запису

Усі інструменти запису вимагають щонайменше сфери дії write.

`create_source`

Створює нове джерело.

Необхідна сфера дії: write

Параметр	Тип	Опис
`url`	Рядок	URL-адреса веб-сайту джерела
`name`	Рядок	Внутрішня назва
`tags`	Масив	Ідентифікатори тегів (опціонально)

`update_source`

Змінює назву, URL-адресу або теги існуючого джерела.

Необхідний обсяг: write

Параметр	Тип	Опис
`source_id`	Рядок	Ідентифікатор джерела
`name`	Рядок	Нова назва (опціонально)
`url`	Рядок	Нова URL-адреса (опціонально)

`delete_source`

Видаляє джерело, включаючи всі канали та Updates.

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

`update_update_state`

Переміщує Updates між теками Workspace.

Необхідна сфера дії: write

Параметр	Тип	Опис
`update_ids`	Масив	ID Updates, щонайбільше 100 за виклик
`folder`	Рядок	`inbox`, `saved` або `dropped`

Стан діє в межах Workspace і не змінює сам Update. У відповіді кожен ID зазначено окремо.

`tag_update`

Призначає Updates вже наявні тематичні теги.

Необхідна сфера дії: write

Параметр	Тип	Опис
`update_ids`	Масив	ID Updates, щонайбільше 100 за виклик
`tags`	Масив	Теги у вигляді slug, ID або назви
`mode`	Рядок	`add` (за замовчуванням) зберігає наявні теги, `replace` залишає саме ці

Дозволені лише теги з applies_to = updates; тег джерела відхиляється. Відсутні теги створи заздалегідь через create_tag.

`untag_update`

Знімає тематичні теги з Updates.

Необхідна сфера дії: write

Параметр	Тип	Опис
`update_ids`	Масив	ID Updates, щонайбільше 100 за виклик
`tags`	Масив	Теги для зняття, у вигляді slug, ID або назви

Знімається лише прив’язка цього Workspace. Сам тег залишається.

`refresh_source_channels`

Заново запускає розпізнавання каналів для наявного джерела.

Необхідна сфера дії: write

Параметр	Тип	Опис
`source_id`	Рядок	ID джерела
`create_detected`	Логічне значення	`false` (за замовчуванням) лише повідомляє, `true` створює відсутні канали

Наявні канали не створюються повторно; вимкнений канал вважається наявним. Нові канали починають отримання самі.

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

MCP — використання Picasi в помічнику на основі штучного інтелекту Загальна інформація: що таке MCP, рівні OAuth Scope та концепція безпеки.

Підключити Picasi до Claude Code Створити токен API та налаштувати його в Claude Code.

Підключити Picasi до Claude.ai Налаштування підключення OAuth для Claude.ai.