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

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

Инструментам 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 в источнике. Он является аналогом фильтра «Ownership» в интерфейсе «Inbox» и позволяет ИИ-помощнику целенаправленно анализировать только собственное присутствие или только конкурентов.

`get_update_details`

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

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

Параметр	Тип	Описание
`update_id`	Строка	Идентификатор Update

`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 и концепция безопасности.

Связать Picasi с Claude Code Создать токен API и настроить его в Claude Code.

Подключить Picasi к Claude.ai Настройка подключения по OAuth для Claude.ai.