Каталог MCP
Perspective-AI/mcp

Perspective-AI/mcp

Name: Perspective-AI/mcp
Availability: InStock
Author: perspective-ai

MCP-сервер для Perspective AI превращает статические формы в адаптивные диалоги. Помогает бизнесу квалифицировать лиды, структурировать данные и запускать автоматизацию прямо из Claude, Cursor или ...

Github NPM Сайт сервера

README

35 инструментов

Версии

Установить сервер

Perspective AI MCP Server

Forms are costing you business. An AI concierge turns them into conversations.

MCP server for Perspective AI. An AI Concierge replaces static forms with adaptive AI conversations that understand real situations, structure key information automatically, and trigger the right next step.

Rigid forms cause drop-off, weaken qualification, and strip away context. Perspective uses adaptive AI to capture structured data and trigger automation, so you understand what truly matters to your customers and can make decisions with conviction.

What this MCP server does

Once connected, your AI assistant can design conversation agents, analyze conversations, deploy embeds, and automate follow-ups directly from Claude Desktop, Claude Code, Cursor, or any MCP-compatible client. Try prompts like:

Design a Concierge that qualifies pricing-page leads by budget and timeline.

Why are people abandoning my lead-capture concierge this week?

Whenever a conversation scores above 80 on trust, push it to HubSpot and ping #sales in Slack.

Инструменты были проиндексированы: 07.10.2026

agent_template_getтолько чтениеидемпотентный

Возвращает полные сведения об одном шаблоне агента из публичной библиотеки Agent Library: что он захватывает, как проходит диалог, в какие интеграции обычно передаёт данные, где находится в библиотеке и какие связанные шаблоны существуют. Поведение: - Только чтение, публичный каталог — рабочее пространство не требуется. - Неизвестные слаги возвращают ошибку; слаги берутся из agent_template_search. Когда использовать этот инструмент: - Вы выбрали шаблон агента с помощью agent_template_search и хотите получить достаточно подробностей, чтобы описать его пользователю или подготовить бриф для perspective_create. Когда НЕ использовать этот инструмент: - У вас ещё нет слага — используйте agent_template_search.

Параметры

slugstringобязательный
Slug шаблона агента из agent_template_search

agent_template_searchтолько чтениеидемпотентный

Ищет в публичной библиотеке Perspective Agent Library шаблоны агентов под компанию, аудиторию или сценарий использования. Возвращает лучшие совпадения, отсортированные по релевантности: у каждого есть ссылка на страницу шаблона, которой можно поделиться, ссылка на живое демо (если есть) и готовый бриф для perspective_create. Поведение: - Каталог публичный, только для чтения: рабочее пространство не нужно, а результаты одинаковы для всех, кто обращается. - query - свободный текст (например, "dental clinic new patient scheduling", "SaaS onboarding churn"). Шаблоны агентов сортируются по числу слов из запроса, совпавших с их названием, описанием и классификацией; шаблоны без совпадений отбрасываются. - agent_type, industry, team, outcome, job, journey_stage, replaces и category - жёсткие фильтры: внутри одного фильтра подходит любое из перечисленных значений, между фильтрами совпадать должны все. Чтобы получить лучшие рекомендации, сочетайте короткий запрос с одним-двумя фильтрами; если total_matches равен 0, уберите самый сомнительный фильтр и повторите. - Возвращает не больше limit шаблонов агентов (по умолчанию 10, максимум 25) плюс total_matches, чтобы было видно, когда подходящих шаблонов больше. Когда использовать этот инструмент: - Когда рекомендуете шаблоны агентов новому или потенциальному пользователю, опираясь на то, что знаете о его компании, роли или цели. - Когда ищете отправную точку перед perspective_create: передайте create_brief выбранного шаблона в description, а его agent_type в agent_context. - Когда отвечаете на вопрос "есть ли у вас шаблон агента для X?". Когда НЕ использовать этот инструмент: - Когда вы уже знаете slug шаблона агента и хотите полные детали - используйте agent_template_get. - Когда ищете собственные perspectives пользователя - используйте perspective_list.

Параметры

agent_typeenum[]
categoryenum[]
industryenum[]
jobenum[]
journey_stageenum[]
limitinteger
Максимальное количество шаблонов агентов, которое нужно вернуть (по умолчанию 10).
outcomeenum[]
querystring
Описание компании, аудитории или задачи, которую нужно выполнить, в свободной форме. Необязательно, если заданы фильтры.
replacesenum[]
teamenum[]

automation_createвнешний мир

Создаёт автоматизацию для перспективы. Триггеры: per_interview (срабатывает при каждом завершённом разговоре) или scheduled (ежедневно/еженедельно, с целью digest, invite или insights). Действия: внутреннее выявление инсайтов, вебхук, электронная почта или подключённые интеграции на основе провайдеров, такие как Slack, HubSpot, Gmail, Google Docs, Notion и Confluence. Режимы выполнения: direct (быстрый, детерминированный, только вебхуки) или agent (на основе LLM, требуется для инсайтов и каналов доставки). Поведение: - Каждый вызов создаёт новую автоматизацию, даже если имя/конфигурация совпадает с существующей. - После включения автоматизация начинает срабатывать на реальные события: per_interview отправляет сообщение при каждом завершённом разговоре в дальнейшем; scheduled отправляет реальное сообщение с заданной периодичностью (ежедневно/еженедельно). - Для HubSpot требуется подключение HubSpot в рабочем пространстве: при отсутствии подключения возникает ошибка «Could not resolve HubSpot portal ID - please reconnect HubSpot». - Вебхук-каналы: НЕ спрашивайте у пользователя URL конечной точки или учётные данные, ни то, ни другое через этот инструмент не принимается. Автоматизация создаётся отключённой, и ответ содержит configure_url, страницу веб-приложения, где пользователь задаёт URL (и заголовок аутентификации при необходимости). Поделитесь этой ссылкой и попросите пользователя ответить «Done» после сохранения, затем включите автоматизацию через automation_update. - Инсайт-автоматизации используют kind «insights», execution_mode «agent», не указывают канал и используют scheduled purpose «insights» при расписании. - Ошибки, когда перспектива не найдена или у вас нет доступа. Когда использовать этот инструмент: - Пользователь хочет получать постоянные уведомления о каждом завершённом разговоре (per_interview). - Создание ежедневного/еженедельного дайджеста с доставкой в Slack, на почту, в HubSpot или через вебхук (scheduled). - Запуск запланированной инсайт-автоматизации, которая создаёт инсайты без внешней доставки. Когда НЕ использовать этот инструмент: - Попытка разовой отправки перед запуском: создайте автоматизацию, затем используйте automation_test (используйте override_email для почтовых каналов, чтобы не задеть реальные…

Параметры

automationobjectобязательный
Автоматизация создания
perspective_idstringобязательный
Идентификатор перспективы
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

automation_delete

Необратимо удаляет автоматизацию. Сначала приостанавливает запланированные отправки, а затем удаляет автоматизацию. Поведение: - РАЗРУШИТЕЛЬНОЕ и необратимое действие: автоматизацию невозможно восстановить. Отменить нельзя. - Возвращает ошибку, если perspective или автоматизация не найдены либо у вас нет доступа. Удаление уже удалённой автоматизации тоже вызывает ошибку. - Если приостановить запланированную отправку не удаётся, удаление прерывается, и вы получите success: false с сообщением «Failed to stop running workflow. Please try again.» В этом случае автоматизация останется нетронутой. Когда использовать этот инструмент: - Пользователь явно попросил удалить автоматизацию и подтвердил удаление. - Нужно удалить неправильно настроенную автоматизацию, на которой automation_test постоянно выдаёт ошибку. Когда НЕ использовать этот инструмент: - Пользователь просто хочет временно приостановить её: вместо этого используйте automation_update с параметром { enabled: false }. - Вы не уверены, какой automation_id правильный: сначала уточните через automation_list.

Параметры

automation_idstringобязательный
ID автоматизации
perspective_idstringобязательный
Идентификатор перспективы
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

automation_listтолько чтениеидемпотентный

Параметры

perspective_idstringобязательный
Идентификатор перспективы
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

automation_testвнешний мир

Запускает однократное сквозное выполнение существующей автоматизации и возвращает success/failure, а также цель и длительность. Повторяет реальный запуск в продакшене. Поведение: - Отправляет РЕАЛЬНЫЕ сообщения: делает POST на настроенный webhook, отправляет настроенное письмо, публикует сообщение в Slack или записывает запись в HubSpot. Для перенаправления доставки на безопасную тестовую цель используется override_email (для email-каналов). - Автоматизации Insight используют РЕАЛЬНЫЕ исследовательские беседы, создают обычную сессию анализа и инсайты и расходуют обычные кредиты сессии анализа. Они не продвигают расписание настроенного триггера. - Каждый вызов запускает ещё одну реальную доставку. - Выдаёт ошибку, если perspective или автоматизация не найдены либо у вас нет доступа. Автоматизации webhook, у которых ещё не задан URL конечной точки (на configure_url), возвращают ошибку со ссылкой на эту страницу. - Значения по умолчанию для mock-беседы: trust score 85, статус complete, "Test Participant" / test@example.com. Переопределяются participant_name, participant_email, summary и tags через test_data. Автоматизации заметок и обновления записей HubSpot находят контакт по participant_email, поэтому в нём должен быть email существующего контакта. - Возвращает success: false, когда автоматизация пропускает доставку (например, фильтр по тегам/trust не совпадает с mock или ни одна запись HubSpot не совпадает с email участника); сообщение содержит причину пропуска. Поле error заполняется только при реальных сбоях доставки. Когда использовать этот инструмент: - Проверка только что созданной автоматизации на то, что она действительно доставляет, прежде чем полагаться на неё (override_email направляет тестовые письма на безопасную цель вместо реальных получателей). - Воспроизведение сбоя доставки, показанного в automation_list (last_error). Когда НЕ использовать этот инструмент: - Просмотр настроенного: для этого есть automation_list. - Изменение конфигурации: для этого есть automation_update. - Удаление автоматизации: для этого есть automation_delete.

Параметры

automation_idstringобязательный
Идентификатор автоматизации
override_emailstring
Переопределяет получателя из настроек (только для канала email)
perspective_idstringобязательный
Идентификатор перспективы
test_dataobject
Моковые данные диалога для тестового прогона
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

automation_updateвнешний мир

Обновляет поля существующей автоматизации. Передайте объект частичного обновления только с теми полями, которые нужно изменить; пропущенные поля сохраняются. Переключение enabled или изменение расписания/канала/условия вступает в силу при следующем запуске по расписанию. Прямое выполнение только через webhook; для поиска инсайтов, email и каналов на стороне провайдера используйте режим агента. Поведение: - Сохраняет изменение в той же записи автоматизации. Автоматизации по расписанию с активным workflow перезапускаются при обновлении, чтобы следующий запуск подхватил последнюю конфигурацию. - Возвращает ошибку, если perspective или автоматизация не найдены, или у вас нет доступа. - Для HubSpot подключение рабочего пространства к HubSpot проверяется заново - выдаёт ошибку "Could not resolve HubSpot portal ID - please reconnect HubSpot", если подключение разорвано. - Каналы webhook: НЕ спрашивайте у пользователя URL эндпоинта или учётные данные - ни то, ни другое не принимается через этот инструмент. Сохранённые URL/заголовок авторизации сохраняются при повторном указании канала, при переключении на канал webhook он создаётся отключённым, а включение выдаёт ошибку, пока URL не задан в configure_url (возвращается в ответе). - Для автоматизаций по расписанию: изменения канала, условия, режима выполнения или инструкции применяются начиная со следующего запуска, а не к текущему выполняющемуся. Когда использовать этот инструмент: - Переключение enabled вкл или выкл (также ставит на паузу/возобновляет отправки по расписанию). - Изменение расписания, канала, условия или инструкции у работающей автоматизации. Когда НЕ использовать этот инструмент: - Полное удаление автоматизации - используйте automation_delete. - Проверка, что изменение конфигурации действительно доставляется - используйте automation_test. - Просмотр того, что настроено - используйте automation_list.

Параметры

automation_idstringобязательный
Идентификатор автоматизации
perspective_idstringобязательный
Идентификатор перспективы
updatesobjectобязательный
Частичные поля для обновления (передайте enabled, чтобы переключить)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

conversations_data_analysisтолько чтениеидемпотентный

Запускает конвейер агрегации MongoDB по диалогам для количественного анализа (подсчёты, распределения, тренды, перекрёстные таблицы). Поведение: - Только чтение из отфильтрованной коллекции диалогов (в рамках этой перспективы). - Фильтры researchId и mode подставляются автоматически, не добавляйте их. - Максимум 10 стадий конвейера, максимум 500 строк результата. - Разрешены только стадии чтения ($match, $group, $sort, $limit, $skip, $project, $unwind, $count, $addFields, $bucket, $bucketAuto, $sortByCount, $facet, $replaceRoot, $replaceWith). Когда использовать этот инструмент: - Точные подсчёты и распределения (источники переходов, статусы, теги) - Анализ по датам (диалоги по неделям и месяцам) - Числовые агрегации (средние оценки доверия, количество сообщений) - Перекрёстные таблицы Когда НЕ использовать этот инструмент: - Качественные темы и цитаты: используйте conversations_search (семантический) или conversations_explorer (точный и глубокий; async + await_job). - Транскрипт одного диалога: используйте perspective_get_conversation. - Только сводный статус: используйте read_perspective_status или perspective_get_stats.

Параметры

perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
pipelineany[]обязательный
Конвейер агрегации MongoDB (массив объектов этапов). НЕ включайте $match для researchId или mode - их подставляют автоматически. Пример: распределение источников рефералов: [ { "$group": { "_id": "$structuredOutput.referral_source", "count": { "$sum": 1 } } }, { "$sort": { "count": -1 } }, { "$limit": 10 } ] Пример: диалогов в неделю: [ { "$group": { "_id": { "$dateToString": { "format": "%Y-W%V", "date": "$created_at" } }, "count": { "$sum": 1 } } }, { "$sort": { "_id": -1 } }, { "$limit": 12 } ]
titlestringобязательный
Короткая понятная метка для этого запроса (например, «Разбивка по квалификации», «Недельный тренд регистраций»).
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

conversations_explorerтолько чтениевнешний мир

Запускает глубокое текстовое исследование стенограмм разговоров. Немедленно возвращает job_id (статус "pending"); выполняет long-poll для perspective_await_job, пока статус не станет "ready", для получения результатов с указанием источников. Суб-агент читает исходные стенограммы (точные фразы, паттерны множественных разговоров, глубокие прочтения). Для широких тематических/смысловых вопросов предпочитайте conversations_search, а для количественных подсчётов - conversations_data_analysis. Опускайте фильтры, чтобы исследовать полный корпус анализа. Используйте фильтры только для установления чёткой границы стенограмм: статус разговора, диапазон дат создания или явные идентификаторы разговоров. Сначала используйте conversations_data_analysis, когда когорту требуется определить по структурированным атрибутам, затем передавайте полученные идентификаторы разговоров сюда. Фильтрованная задача покрывает полный отфильтрованный объём, а не всю картину. Используется для: - Точные упоминания слов/фраз - Сравнение паттернов разговоров во времени - Чтение полных разговоров с конкретными участниками - Перекрёстное сопоставление текстовых паттернов («разговоры, в которых упоминаются X и Y») - Подход интервьюера или ход разговора Поведение: - Только чтение данных разговоров. - Open-world: запускает автоматического агента исследования в долговременной фоновой задаче, используя внешние сервисы. - Каждый вызов запускает новую задачу, небезопасно вслепую повторять тот же запрос. - Типичный поток: conversations_explorer → perspective_await_job (повторный опрос, пока задача в статусе pending). Когда НЕ следует использовать этот инструмент: - Подсчёты/распределения - используйте conversations_data_analysis. - Смысловые темы без точного совпадения - используйте conversations_search. - Один известный идентификатор разговора - используйте perspective_get_conversation. - Опрос ранее запущенной задачи - используйте perspective_await_job.

Параметры

filtersobject
Необязательные фильтры необработанного корпуса. Пропустите, чтобы изучить весь корпус анализа.
perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
querystringобязательный
Что исследовать в разговорах. Сделайте это различающим: укажите точную фразу, именованную сущность, участника, временной интервал или сравнение. Избегайте общих запросов вроде «проведи полное исследование».
titlestringобязательный
Короткая понятная человеку метка для этого исследования (например, «Сравнить шаблоны разговоров за январь и апрель»).
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

conversations_searchтолько чтениеидемпотентныйвнешний мир

Выполняет семантический поиск по стенограммам разговоров для perspective. Возвращает обобщённый ответ со ссылками на источники. Используйте для качественных / тематических вопросов: - Темы, тональность, болевые точки, мотивации - «Что люди говорят о X?» - Широкие обзоры, где не требуется точное совпадение фраз Для подсчётов и распределений предпочитайте conversations_data_analysis. Для точных фраз, глубокого чтения нескольких стенограмм или сравнения паттернов предпочитайте conversations_explorer (асинхронное задание, опрашивайте через perspective_await_job). Когда идентификатор разговора уже известен, предпочитайте perspective_get_conversation. Поведение: - Только чтение. - Открытый мир: запрашивает внешний управляемый индекс семантического поиска, построенный из стенограмм perspective. - Возвращает ошибку, когда perspective отсутствует или недоступна. Возвращает result_kind "unavailable", когда индекс поиска ещё не готов.

Параметры

filtersobject
Необязательные фильтры метаданных
perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
querystringобязательный
Чёткий вопрос на естественном языке для семантического поиска (не просто ключевые слова).
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

integration_manageтолько чтениеидемпотентныйвнешний мир

Проверяет интеграции рабочего пространства в режиме только для чтения. Операции: "list" перечисляет зарегистрированные провайдеры (в настоящее время slackbot, hubspot, gmail, googledocs, notion, confluence, salesforce, prodege) и статус подключения; "connect" возвращает URL настройки, который пользователь открывает в браузере для завершения OAuth, или, для провайдеров, подключаемых с помощью ключей, выданных клиентом (prodege), страницу, где пользователь вставляет эти ключи; "search_tools" возвращает доступные слаги действий (например, SLACKBOT_SEND_MESSAGE, HUBSPOT_SUBMIT_FORM, GMAIL_SEND_EMAIL) для подключённого провайдера. Поведение: - Только для чтения. Сам НЕ выполняет OAuth, "connect" просто возвращает URL настройки, чтобы пользователь мог завершить подключение в веб-приложении. - Никогда не запрашивайте у пользователя API-ключи или секреты в чате, они вводятся только на странице setup_url. Поделитесь ссылкой и попросите пользователя ответить "Done" после сохранения. - Выдаёт ошибки, если рабочее пространство не найдено или у вас нет доступа. - search_tools возвращает success: false с сообщением "No active <provider> connection. Use 'connect' operation first.", если провайдер не подключён. Ограничение: 10 инструментов на поиск. - Обязательные параметры для каждой операции: connect требует provider; search_tools требует provider и query. Валидация схемы MCP отклоняет отсутствующие или не относящиеся к операции аргументы до выполнения; обработчик сохраняет аналогичные ошибки для не-MCP вызывающих. Когда использовать этот инструмент: - Проверка того, какие интеграции подключены в рабочем пространстве, перед настройкой автоматизации, которая с ними взаимодействует. - Отображение URL настройки пользователю, когда он хочет подключить провайдера. - Обнаружение слагов действий для наполнения автоматизаций, поддерживаемых провайдером. Когда НЕ использовать этот инструмент: - Создание или изменение автоматизаций, используйте automation_create / automation_update после подключения провайдера. - Отправка реального сообщения для проверки подключения провайдера, сначала создайте автоматизацию, затем запустите automation_test. Примеры: - Список: { "operation": "list" } - Подключить: { "operation": "connect", "provider": "slackbot" } - Поиск:…

Параметры

operationenumобязательный
Выполняемая операция.
providerenum
Provider (обязателен для connect/search_tools)
querystring
Поисковый запрос (обязателен для 'search_tools')
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

participant_inviteвнешний мир

Создаёт приглашения для участников перспективы и возвращает URL magic-ссылок со сроком действия 48 часов, при необходимости отправляя приглашения по электронной почте. Передайте ЛИБО participants (создаёт новые приглашения), ЛИБО invite_ids (повторно использует существующие приглашения и выпускает новую 48-часовую ссылку), и никогда не оба сразу. Поведение: - С participants: создаёт новое приглашение для каждого участника (дедупликация по email, приведённому к нижнему регистру, в пределах одного вызова; при дублирующихся email побеждает ПОСЛЕДНЯЯ запись и для name, и для context, более ранние записи отбрасываются). Повторный вызов с тем же email создаёт отдельную запись приглашения, дедупликации между вызовами нет. Чтобы перевыпустить ссылку для существующего участника без создания новой записи, передайте invite_id этого участника через invite_ids. - С invite_ids: повторно использует существующие приглашения, без дубликатов, но выпускает новую 48-часовую ссылку при каждом вызове. Ранее выданные ссылки остаются действительными, пока не истечёт их срок. - Отправляет реальное приглашение по электронной почте каждому участнику, когда send_email=true. Когда send_email=false (по умолчанию), письмо не отправляется, распространяйте URL самостоятельно. Возвращает ошибку "Email sending is currently disabled.", если отправка писем отключена в этом окружении. - Возвращает ошибку, когда перспектива не найдена или у вас нет доступа. Возвращает ошибку "This perspective is still in draft. Complete the outline before inviting participants.", если у перспективы ещё нет плана. С invite_ids возвращает ошибку "Invite not found: <id>" (покрывает и некорректные id, и несуществующие id) или ошибку доступа для каждого id. - Ограничения: от 1 до 50 участников/id за вызов. Некорректные входные данные отклоняются до создания приглашения. participants и invite_ids взаимоисключающие. - context для каждого участника (до 20 ключей, ключи длиной до 50 символов, значения длиной до 2000 символов) сохраняется вместе с приглашением и передаётся в перспективу как доверенные метаданные участника. Этот параметр необязателен и его нельзя изменить после создания, для обновления создайте новое приглашение. Когда использовать этот инструмент: - Генерация распространяемых ссылок на разговор для списка участников. - Отправка приглашений по электронной почте…

Параметры

custom_messagestring
Свой текст сообщения в письме. Используется только когда send_email имеет значение true.
custom_subjectstring
Пользовательская тема письма. Используется только когда send_email равно true.
invite_idsstring[]
participantsobject[]
Участники, для которых создаются новые приглашения. Укажите РОВНО ОДНО из participants или invite_ids - передача обоих (или ни одного) считается ошибкой.
perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
send_emailboolean
Если true, отправляет письма-приглашения. Если false (по умолчанию), возвращает только URL-адреса приглашений.
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

perspective_await_jobтолько чтениеидемпотентный

Выполняет длительный опрос асинхронной задачи и возвращает либо её конечный результат, либо очередной конверт "pending", чтобы продолжить опрос. Поддерживаемые задачи (запускаемые этими инструментами): - Perspective design: perspective_create / perspective_respond / perspective_update - Conversations explorer: conversations_explorer - Conversation import: perspective_import_conversation Поведение: - Только чтение: наблюдает за выполняющейся задачей. Безопасно вызывать повторно. - Завершается ошибкой "Unknown job_id", если такой задачи не существует или если идентификатор не относится к поддерживаемому типу задач. Доступ к рабочему пространству и перспективе проверяется повторно при каждом вызове. - Каждый вызов блокируется на время до wait_ms (по умолчанию 30 с, минимум 1 с, максимум 45 с). По истечении времени ожидания возвращает статус "pending" и progress_cursor: передайте его при следующем вызове, чтобы пропустить уже просмотренные события прогресса. - Конечный статус: - "ready" = задача успешно завершена (design: план готов; explorer: ответ + источники; import: conversation_id - различайте по job_kind) - "needs_input" = уточняющий вопрос только для design - Сбои записываются в журнал с деталями базового рабочего процесса, но пользователю показывается общее сообщение "The job failed. Please try again.", чтобы не раскрывать внутренние детали. Когда использовать этот инструмент: - Сразу после того, как стартовый инструмент возвращает job_id. - Повторный опрос после того, как предыдущий вызов вернул статус "pending" (передайте возвращённый progress_cursor обратно). Когда НЕ использовать этот инструмент: - У вас ещё нет job_id - сначала вызовите стартовый инструмент. - Для просмотра конфигурации завершённой перспективы используйте perspective_get.

Параметры

job_idstringобязательный
Идентификатор задачи, который возвращают perspective_create, perspective_respond, perspective_update, conversations_explorer или perspective_import_conversation
progress_cursorinteger
Возобновляет поток прогресса на этом индексе чанка. Использует значение, возвращённое в предыдущем ответе в состоянии ожидания, чтобы не дублировать уведомления о прогрессе.
wait_msinteger
Длительность long-poll в миллисекундах (по умолчанию 30000, максимум 45000)

perspective_createвнешний мир

Создаёт новую перспективу в статусе DRAFT из описания на естественном языке и запускает агента проектирования. Возвращает сразу job_id и статус "pending"; выполняет длинный опрос perspective_await_job с этим job_id, чтобы получить сгенерированный план или уточняющий вопрос. Поведение: - Создаёт новую перспективу при каждом вызове - небезопасно слепо повторять. Одинаковый ввод каждый раз создаёт новую перспективу. - Если workspace_id не указан, используется рабочее пространство пользователя по умолчанию. У совсем нового аккаунта его может ещё не быть: тогда вызов возвращает статус "onboarding_required" с onboarding_url вместо ошибки. Передайте эту ссылку, дождитесь, пока пользователь подтвердит, что закончил, и затем повторите вызов этого инструмента. - Совет: используйте workspace_list, чтобы увидеть все рабочие пространства с их описаниями, затем выберите наиболее подходящий workspace_id исходя из контекста. - Заголовок создаётся автоматически из описания. - Агент проектирования работает в фоне и может занять от нескольких секунд до минуты. Дождитесь результата через perspective_await_job; конечные состояния - "ready" (план сгенерирован, возвращены share/direct/preview URL) или "needs_input" (уточняющий вопрос требует ответа пользователя). - description может ссылаться на исследовательские цели, исходные URL или детали аудитории. Примеры: "поймите, почему пробные пользователи не конвертируются", "преобразуйте форму на https://example.com/contact", "поговорите с ушедшими клиентами из Q3". - agent_context выбирает роль агента: 'research' = Interviewer (по умолчанию; глубокие качественные интервью), 'form' = Concierge (заменяет статические формы разговорным потоком), 'survey' = Evaluator (превращает опросы в увлекательные беседы), 'advocate' = Advocate (слушает, затем отвечает по плейбуку бренда или общественной инициативы). Когда использовать этот инструмент: - Пользователь хочет создать новую перспективу из брифа. - Вы начинаете разговор о проектировании, который может продолжаться через perspective_respond. Когда НЕ использовать этот инструмент: - Перспектива уже существует, и пользователь хочет её изменить - используйте perspective_update. - Агент уже задал уточняющий вопрос…

Параметры

agent_contextenum
Роль агента (по умолчанию 'research'): 'research' = Interviewer - глубокие качественные интервью, исследовательский подход; 'form' = Concierge - заменяет статичные формы разговорным сценарием; 'survey' = Evaluator - превращает структурированные опросы в увлекательные беседы; 'advocate' = Advocate - слушает, а затем отвечает по сценарию бренда или кампании.
descriptionstringобязательный
Описание целей исследования на естественном языке
workspace_idstring
Необязательно: рабочее пространство, в котором создавать. Если не указано, использует рабочее пространство пользователя по умолчанию и возвращает onboarding_required, когда у пользователя его ещё нет.

perspective_getтолько чтениеидемпотентный

Возвращает полную конфигурацию для одного perspective: prompt/настройку, outline, поля структурированного вывода, статус, базовую статистику и URL предпросмотра, общий и прямой URL. Поведение: - Только чтение. - Выдаёт ошибку, когда рабочая область или perspective не найдены или у вас нет доступа. - Статистика здесь облегчённая (total, completed, completion_rate, preview_count). total/completed охватывают реальные (режим NORMAL) разговоры; preview_count указывается отдельно. Более детальные разбивки (по периоду, trust score, статусу) доступны в perspective_get_stats. - conversation_count совпадает со stats.total_conversations: это тот же показатель только для NORMAL, который показывает perspective_get_stats. Когда использовать этот инструмент: - Показать пользователю, как устроен perspective: вопросы, поля, тон, статус. - Подтвердить, что вы выбрали нужный perspective, перед сценариями update/preview/embed. - Получить share_url или direct_url для известного perspective. Когда НЕ использовать этот инструмент: - Для агрегированной статистики с разбивкой по периоду, trust score, статусу используйте perspective_get_stats. - Для просмотра или поиска нескольких perspectives используйте perspective_list. - Для получения отдельных транскриптов используйте perspective_list_conversations / perspective_get_conversation.

Параметры

perspective_idstringобязательный
Perspective ID (из perspective_list или perspective_create)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

perspective_get_conversationтолько чтениеидемпотентный

Возвращает полную запись для одного разговора: отрендеренную расшифровку, сводку, оценку доверия с баллами по измерениям и рекомендациями, поля структурированного вывода, метаданные участников, URL фрагментов голосовых сообщений, длительность и временные метки. Поведение: - Только для чтения. - Выдаёт ошибку, когда разговор не существует, принадлежит другому рабочему пространству, его перспектива недоступна или id имеет неверный формат. - Расшифровка объединяет реплики участника и агента с метками ролей. - voice_snippets присутствуют только у сообщений голосового режима. - participant_metadata - сохранённая плоская карта строк, совпадающая с export participant.metadata и webhook participant_metadata, без санитизации или усечения промпта. Он равен null, когда метаданных нет. Когда использовать этот инструмент: - Детальный разбор одного разговора: полная расшифровка, почему доверие было низким, что было сказано. - Извлечение точных цитат или аудиоссылок для одного ответа. Когда НЕ использовать этот инструмент: - Просмотр множества разговоров - используйте perspective_list_conversations. - Массовый анализ или тематические закономерности по многим разговорам - используйте perspective_get_conversations (пакетно, экономно по токенам). - Только агрегированная статистика - используйте perspective_get_stats.

Параметры

conversation_idstringобязательный
Идентификатор беседы (из perspective_list_conversations)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

perspective_get_conversationsтолько чтениеидемпотентный

Возвращает экономную по токенам партию бесед для массового анализа. По умолчанию выдаёт только сводки (id, summary, trust_score, status, created_at) плюс структуру перспективы; полные XML-транскрипты включаются через include_transcripts=true, а сохранённые метаданные участников - через include_participant_metadata=true. Формат по умолчанию - TOON (компактный); доступен JSON. Поведение: - Только чтение. - Выдаёт ошибку, если перспектива не найдена или у вас нет к ней доступа. - Фильтры: период (7d/30d/90d/all, по умолчанию 30d), статус, диапазон trust_score. Размер страницы до 50, по умолчанию 10. Передайте nextCursor обратно в cursor для следующей партии. - Ответ содержит total_matching, returned_count, has_more, nextCursor для оценки объёма. - participant_metadata каждой сводки по умолчанию опускается. При include_participant_metadata=true это сохранённая плоская строковая карта, совпадающая с экспортами и вебхуками без санитизации и усечения промпта, либо null, если метаданных нет. Запрашивайте её только когда нужен контекст участника; полные карты бывают большими. Метаданные внутри необязательных XML-транскриптов остаются санитизированными для использования в промпте. - Формат цитирования при включённых транскриптах: "conversation_id:message_index". Когда использовать этот инструмент: - Тематический анализ, распределение тональности или поиск закономерностей по множеству бесед. - Дешёвая сборка исследовательской сводки из множества сводок с последующим углублением в конкретные транскрипты. - Массовый экспорт с фильтрами. Когда НЕ использовать этот инструмент: - Нужна одна беседа во всех деталях (фрагменты голоса, измерения доверия) - используйте perspective_get_conversation. - Нужен просто просматриваемый список с метаданными - используйте perspective_list_conversations. - Нужны только агрегированные счётчики - используйте perspective_get_stats (вызовите сначала, чтобы оценить размер набора данных перед разбивкой на партии).

Параметры

cursorstring
Курсор пагинации из предыдущего ответа
formatenum
Формат вывода: «toon» (по умолчанию, экономичный по токенам) или «json».
include_participant_metadataboolean
Включает полные сохранённые карты метаданных участников. По умолчанию false, чтобы уменьшить размер полезной нагрузки и ненужное раскрытие данных. Устанавливается в true только тогда, когда нужен контекст участника.
include_transcriptsboolean
Включает полные транскрипты беседы. По умолчанию false (только сводки), чтобы экономить токены. Устанавливается в true, только когда нужны детали на уровне отдельных сообщений.
limitinteger
Количество диалогов в пакете (максимум 50)
periodenum
Фильтр по временному периоду
perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
statusenum
Фильтрует по статусу беседы
trust_score_maxnumber
Максимальная оценка доверия (0-100)
trust_score_minnumber
Минимальный показатель доверия (0-100)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

perspective_get_embed_optionsтолько чтениеидемпотентный

Возвращает артефакты развертывания для перспективы: share_url и direct_url для рассылки, а также готовые к вставке фрагменты кода (fullpage, widget, popup, slider, float, card) и справочник SDK (URL скрипта, события, параметры URL/бренда/темы, методы JS API, обратные вызовы). Поведение: - Только чтение. - Возвращает ошибку, если перспектива не найдена или у вас нет доступа. - URL-адреса стабильны для каждой перспективы. Беседы, начатые из этих встроенных элементов, учитываются в квоте рабочей области (предпросмотр бесед не учитывается - см. perspective_get_preview_link). - Используйте фрагмент, возвращенный для этой конкретной перспективы, а не создавайте URL-адреса вручную. - share_url / direct_url принимают следующие параметры URL: name, email, returnUrl, а также произвольные ключи отслеживания (source, campaign и т. д.). Когда использовать этот инструмент: - Развертывание перспективы на реальном сайте, в электронной почте или в интерфейсе приложения. - Генерация кода интеграции SDK (макет Next.js, необработанный HTML, кнопка запуска всплывающего окна и т. д.). - Поиск имен событий или параметров URL, которые принимает встроенный элемент. Когда НЕ использовать этот инструмент: - Внутреннее смоук-тестирование - используйте perspective_get_preview_link (предпросмотр бесед не учитывается в квоте). - Просмотр структуры / настройки - используйте perspective_get. Типичный сценарий: 1. perspective_create → проектирование 2. perspective_get_preview_link → тестирование 3. perspective_update → доработка 4. perspective_get_embed_options → развертывание 5. automation_create → (контексты форм / сбора лидов) передача данных беседы в CRM или бэкенд Размещение фрагмента по типу встроенного элемента: - Popup / Slider / Float: скрипт размещается перед </body> в HTML или в _app.tsx / layout.tsx для React/Next.js. - Widget: div отмечает место, где отображается виджет. - Fullpage: выделенная страница или iframe-контейнер. - Card: ссылка для предпросмотра целевых страниц или писем. Для перспектив с формами / сбором лидов automation_create может пересылать каждый завершенный разговор в CRM, базу данных или канал уведомлений. Примеры: - Необязательные параметры URL в ссылке для публикации: email (предварительно заполняет email участника), returnUrl…

Параметры

perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

perspective_get_preview_linkтолько чтениеидемпотентный

Возвращает общедоступную ссылку, которая открывает перспективу в режиме предпросмотра, чтобы вы (или ваш коллега) могли провести с ней пробный диалог перед развёртыванием. Поведение: - Только чтение. Для заданной перспективы ссылка всегда одна и та же и не истекает. - Диалоги, начатые по этой ссылке, считаются предпросмотрочными и НЕ учитываются в квоте рабочего пространства. - Любой, у кого есть ссылка, может начать предпросмотрочный диалог, даже без аутентификации - относитесь к ней как к полупубличной. Когда использовать этот инструмент: - После perspective_create или perspective_update, чтобы вручную проверить поведение перспективы перед запуском. - Чтобы поделиться ссылкой на предпросмотр с коллегой для ревью. Когда НЕ использовать этот инструмент: - Для продакшн-развёртывания - используйте perspective_get_embed_options, который возвращает embed-фрагменты и публичную ссылку для шаринга, диалоги по которой учитываются в квоте. - Для просмотра существующих реальных диалогов - используйте perspective_list_conversations / perspective_get_conversation. Типичный сценарий: 1. perspective_create → проектирование 2. perspective_get_preview_link → тестирование 3. perspective_update → доработка 4. perspective_get_embed_options → развёртывание

Параметры

perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

perspective_get_statsтолько чтениеидемпотентный

Возвращает агрегированные счётчики разговоров и разбивки для перспективы за выбранный период (7d, 30d, 90d или всё время). Включает итоги, процент завершения, среднюю продолжительность, а также распределения по периоду, диапазону оценки доверия и статусу. Поведение: - Только чтение. - Возвращает ошибку, когда перспектива не найдена или у вас нет доступа. - total_conversations / completed / completion_rate охватывают только реальные производственные разговоры (режим NORMAL). preview_count сообщается отдельно, чтобы вы видели, сколько тестового трафика получила перспектива по ссылкам /share?mode=preview. - avg_duration_seconds вычисляется среди завершённых реальных разговоров за запрошенный период. - Диапазоны оценки доверия также ограничены запрошенным периодом. - Статистика perspective_get использует то же определение: оба инструмента сходятся в итоговом показателе. Когда использовать этот инструмент: - Чтобы оценить размер набора данных перед выгрузкой разговоров пачками с помощью perspective_get_conversations. - Быстрая проверка состояния: процент завершения, объём по периодам, распределение доверия. Когда НЕ использовать этот инструмент: - Для чтения отдельных транскриптов или сводок используйте perspective_list_conversations или perspective_get_conversation. - Для просмотра настроек и структуры используйте perspective_get.

Параметры

periodenum
Период времени: 7д, 30д, 90д или все
perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

perspective_import_conversationвнешний мир

Импортирует внешнюю беседу (очную встречу, звонок в Zoom/Gong/Meet/Teams, любое интервью, проведённое вне Perspective) в существующую перспективу на основе её транскрипта. Немедленно возвращает job_id (статус "pending"); выполняйте долгий опрос perspective_await_job, пока не получите статус "ready" для импортированного conversation_id. Передавайте полный текст транскрипта. Строки с метками говорящих ("Alice: …", "[00:12] Bob: …") разбираются на реплики беседы; текст без меток автоматически разбивается на реплики, а определённые роли возвращаются в виде предупреждений. Поведение: - Создаёт завершённую беседу в перспективе и запускает тот же автоматический анализ (саммари, структурированные поля, инсайты), что и для обычных бесед: анализ продолжается и после того, как задание сообщит "ready". - В одной перспективе одновременно может выполняться один импорт; запуск второго завершается ошибкой с идентификатором выполняющегося задания, чтобы вы могли дождаться его завершения. - Каждый вызов запускает новое задание: небезопасно слепо повторять попытку; сначала дождитесь возвращённого job_id. - Типичный сценарий: perspective_import_conversation → perspective_await_job (повторный опрос, пока статус pending) → perspective_get_conversation с возвращённым conversation_id. Когда НЕ следует использовать этот инструмент: - У вас есть запись, а не транскрипт: сначала расшифруйте её и передайте текст; этот инструмент не принимает аудио и видео. - Беседы, проведённые внутри Perspective: они уже находятся в перспективе. - Массовый перенос из Perspective в Perspective: используйте ZIP-экспорт/импорт в приложении. Пример: { workspace_id, perspective_id, participant_name: "Alice", transcript: "Interviewer: …\nAlice: …", provider: "zoom", conducted_at: "2026-08-01T10:00:00Z" }

Параметры

conducted_atstring
Когда разговор фактически состоялся (ISO 8601). По умолчанию используется время импорта.
external_idstring
Идентификатор диалога во внешней системе
external_urlstring
Ссылка на исходную беседу во внешней системе
labelstring
Короткая метка для этого импорта, отображаемая в приложении
notesstring
Внутренние заметки, хранящиеся вместе с импортированным диалогом
participant_emailstring
Адрес электронной почты участника (необязательно)
participant_namestringобязательный
Имя участника, у которого берут интервью
perspective_idstringобязательный
ID перспективы, в которую импортируется разговор (из perspective_list)
providerenum
Платформа встречи, из которой пришёл разговор, если известна
provider_namestring
Название источника в свободной форме, если provider - 'other' или не указан в списке
transcriptstringобязательный
Полный текст расшифровки разговора. Строки с указанием говорящего (например, 'Alice: …', '[00:12] Bob: …') разбираются на реплики. Расшифровывает записи перед вызовом этого инструмента.
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

perspective_listтолько чтениеидемпотентный

Перечисляет перспективы: либо просматривает одну рабочую область, либо ищет по имени/названию (а также email/имени владельца) во всех рабочих областях, к которым у пользователя есть доступ. Элементы включают perspective_id, название, статус, количество разговоров и информацию о рабочей области. Поведение: - Только чтение. - Режим просмотра (workspace_id без query): перечисляет все перспективы в этой рабочей области. - Режим поиска (query): сопоставляет имя/название перспективы и email/имя владельца в доступных рабочих областях. Необязательный workspace_id сужает поиск. Query должен быть непустым и не длиннее 200 символов. - Выводит ошибку "Please provide workspace_id to list perspectives or query to search.", если не задано ни то, ни другое. - Передаёт nextCursor обратно как cursor; has_more указывает на наличие дальнейших результатов. Когда использовать этот инструмент: - Чтобы получить perspective_id по имени, которое упомянул пользователь (режим поиска). - Чтобы просмотреть перспективы рабочей области и выбрать или обобщить их. Когда НЕ использовать этот инструмент: - Для детального изучения одной известной перспективы: используйте perspective_get. - Для агрегированных подсчётов или показателей: используйте perspective_get_stats. - Для получения данных о разговорах: используйте perspective_list_conversations или perspective_get_conversations. Примеры: - Список всех перспектив в рабочей области: { workspace_id: "ws_..." } - Поиск по имени во всех рабочих областях: { query: "welcome" } - Поиск в пределах рабочей области: { query: "welcome", workspace_id: "ws_..." }

Параметры

cursorstring
Курсор пагинации из предыдущего ответа
querystring
Ищет по имени или названию. Включает поиск между рабочими пространствами.
workspace_idstring
Необязательно: рабочая область, из которой нужно получить список. Обязательна для режима просмотра, необязательна для режима поиска.

perspective_list_conversationsтолько чтениеидемпотентный

Выводит список бесед для перспективы с необязательными фильтрами по статусу, диапазону trust score и диапазону дат. Каждый элемент включает conversation_id, статус, поля structured-output, trust score и URL транскрипта. Включает сохранённые метаданные участников через include_participant_metadata=true. Поведение: - Только для чтения. - Возвращает ошибку, если перспектива не найдена или у вас нет доступа. - Передаёт nextCursor обратно как cursor для следующей страницы. Пустые результаты возвращают пустой массив. - Этот список НЕ включает транскрипты или сводки - только метаданные. - participant_metadata по умолчанию опускается. Когда include_participant_metadata=true, это сохранённая плоская строковая карта, совпадающая с экспортами и вебхуками без санитизации или обрезки промпта, или null, когда метаданных нет. Запрашивайте его только когда нужен контекст участника; полные карты могут быть большими. - date_from / date_to должны быть строками ISO 8601 (например, "2026-04-28T00:00:00Z"). Некорректные даты отклоняются на уровне схемы, а не молча трактуются как отсутствие фильтра. Когда использовать этот инструмент: - Выбор конкретных бесед по статусу / trust / дате перед глубоким погружением. - Показ пользователю списка ответов для просмотра. Когда НЕ использовать этот инструмент: - Нужен транскрипт или сводка для одной беседы - используйте perspective_get_conversation. - Массовый анализ по многим беседам - используйте perspective_get_conversations (пакетный режим с опциональными транскриптами). - Только агрегированные счётчики/показатели - используйте perspective_get_stats.

Параметры

cursorstring
Курсор пагинации из предыдущего ответа
date_fromstring
Фильтр с даты (ISO 8601)
date_tostring
Фильтрует по дате (ISO 8601)
include_participant_metadataboolean
Включает полные сохранённые карты метаданных участников. По умолчанию false, чтобы уменьшить размер полезной нагрузки и ненужное раскрытие данных. Устанавливается в true только тогда, когда нужен контекст участника.
perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
statusenum
Фильтрует по статусу беседы
trust_score_maxnumber
Максимальная оценка доверия (0-100)
trust_score_minnumber
Минимальный показатель доверия (0-100)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

perspective_respondвнешний мир

Отправляет ответ пользователя на уточняющий вопрос, заданный агентом проектирования при создании перспективы, затем повторно запускает этап проектирования. Возвращает новый job_id в статусе pending; выполните long-poll запрос к perspective_await_job, чтобы дождаться следующего терминального состояния. Поведение: - Добавляет ответ пользователя в диалог проектирования и запускает ещё один проход проектирования. Каждый вызов начинает новый проход. - ДЕЙСТВУЕТ ТОЛЬКО, пока перспектива находится в статусе DRAFT. В противном случае возвращает ошибку: "This perspective already has an outline. Use the update tool to make changes." - Возвращает ошибку, если перспектива не существует или у вас нет доступа. - Сразу возвращает "pending". perspective_await_job возвращает "ready" (план сгенерирован) или "needs_input" (ещё один уточняющий вопрос: вызовите этот инструмент снова). Когда использовать этот инструмент: - perspective_await_job вернул статус "needs_input" с follow_up_question, и у вас есть ответ пользователя. - Когда нужно продолжить диалог проектирования до того, как будет сгенерирован какой-либо план. Когда НЕ использовать этот инструмент: - У перспективы уже есть план: используйте perspective_update для внесения изменений. - Создание новой перспективы: используйте perspective_create. - Опрос ранее поставленного в очередь job: используйте perspective_await_job.

Параметры

perspective_idstringобязательный
Perspective ID (из perspective_create со статусом 'needs_input')
responsestringобязательный
Ответ пользователя на уточняющий вопрос
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

perspective_updateвнешний мир

Применяет обратную связь на естественном языке к структуре существующей перспективы (например, «сделай короче», «добавь вопрос про бюджет», «более тёплый тон»). Возвращает job_id незавершённой задачи; выполните long-poll к perspective_await_job, чтобы получить обновлённую структуру. Поведение: - Каждый вызов запускает ещё одну итерацию проектирования и может привести к другой структуре. - Допустимые статусы жизненного цикла: OUTLINE_DEFINED, IN_REVIEW, READY_TO_PUBLISH и COLLECTING. Перспективы в статусе DRAFT должны использовать инструмент respond; завершённые или иным образом нередактируемые перспективы возвращают ошибку текущего статуса. - Возвращает ошибку, если перспектива не найдена или у вас нет доступа. - perspective_await_job возвращает "ready" (структура обновлена) или "needs_input" (уточняющий вопрос: вызовите update снова, передав ответ в качестве обратной связи). Когда использовать этот инструмент: - Пользователь хочет доработать, расширить или изменить уже спроектированную перспективу. - Доработка тона, набора вопросов или выходных полей после предварительного теста. Когда НЕ использовать этот инструмент: - Перспектива всё ещё в статусе DRAFT (структуры ещё нет): используйте perspective_respond. - Создание новой перспективы: используйте perspective_create. - Ожидание результата ранее запущенной задачи: используйте perspective_await_job.

Параметры

feedbackstringобязательный
Обратная связь на естественном языке: 'сделай короче', 'добавь вопрос о бюджете' и т. д.
perspective_idstringобязательный
Perspective ID (должен иметь outline: статус OUTLINE_DEFINED или выше)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

read_insightтолько чтениеидемпотентный

Возвращает полное содержимое одного инсайта по идентификатору в рамках указанной перспективы. Поведение: - Только чтение. - Возвращает ошибку, если перспектива не найдена, инсайт отсутствует или инсайт не принадлежит указанной перспективе. - Включает session_url для сеанса анализа, в котором владелец может редактировать инсайт. Когда использовать этот инструмент: - После read_insights, чтобы получить полное содержимое одного инсайта. Когда НЕ использовать этот инструмент: - Список инсайтов: используйте read_insights. - Транскрипты разговоров: используйте perspective_get_conversation.

Параметры

insight_idstringобязательный
Идентификатор Insight из read_insights.
perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

read_insightsтолько чтениеидемпотентный

Перечисляет аналитические инсайты для перспективы (только метаданные, без полного содержания). Сначала самые свежие. Фильтрует по статусу и типу публикации, с пагинацией через limit/offset. Поведение: - Только чтение. - Возвращает ошибку, если перспектива не найдена или у вас нет доступа. - По умолчанию фильтр по статусу публикации установлен в «all» (черновики и опубликованные), поэтому владелец видит приватные черновики. - Каждая строка содержит session_url, которая указывает на сессию анализа, где можно отредактировать инсайт. - Для полного содержания одного инсайта вызовите read_insight с его id. Когда использовать этот инструмент: - «Что аналитик уже нашёл?» - Выбор id инсайта перед чтением полного содержания. Когда НЕ использовать этот инструмент: - Полный текст инсайта: используйте read_insight. - Снимок фазы/объёма/кредитов: используйте read_perspective_status.

Параметры

limitinteger
Максимальное количество инсайтов на странице (по умолчанию 10, максимум 50).
offsetinteger
Пропускает столько инсайтов (сначала самые свежие).
perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
publishedenum
Фильтр публикаций: "published" | "drafts" | "all" (по умолчанию).
typeenum
Фильтр по типу: "highlights" | "pages" | "all" (по умолчанию).
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

read_perspective_statusтолько чтениеидемпотентный

Возвращает вычисленный сервером снимок состояния перспективы: фаза (design/test/share/live), состояние плана, количество диалогов и завершений, реакции эмодзи, количество инсайтов, сводка по типам включённых автоматизаций и баланс кредитов рабочего пространства. Правила определения фазы: - design: плана ещё нет - test: план есть, предпросмотра/теста и реальных участников нет - share: предпросмотр/тест есть, реальных участников пока нет - live: хотя бы один реальный (NORMAL) диалог всегда перевешивает test/share Поведение: - Только чтение. - Возвращает ошибку, если перспектива не найдена или у вас нет доступа. - insights_count включает черновики и опубликованные инсайты; для разбивки используйте read_insights, для содержимого - read_insight. Когда использовать этот инструмент: - «На каком этапе эта перспектива?» / проверка статуса перед анализом или привлечением участников. - Когда нужно решить, приглашать ли участников, изучать инсайты или продолжать проектирование. Когда НЕ использовать этот инструмент: - Для сводных разбивок объёма по периодам или по доверию используйте perspective_get_stats. - Для чтения содержимого инсайтов или стенограмм диалогов используйте инструменты insight/conversation.

Параметры

perspective_idstringобязательный
Идентификатор перспективы (из perspective_list или perspective_create)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

slack_channel_refreshвнешний мир

Обновляет каталог каналов Slack для рабочей области из Slack и ожидает завершения. Нужен только когда канал не удаётся найти через slack_channel_search / slack_channel_resolve: большинство каналов (включая только что созданные и те, куда бота только что пригласили) индексируются автоматически в течение нескольких секунд, так что сначала воспользуйтесь этими инструментами. Полное обновление может занять время в больших рабочих областях, поэтому уточните у пользователя перед запуском (если только resolve не сообщил "refresh_required"). Поведение: - Запускает обновление или присоединяется к уже выполняющемуся для рабочей области (одновременно выполняется только одно). - Ожидает до wait_ms, затем возвращает "running". Вызывайте slack_channel_refresh_status, чтобы продолжить ожидание (он не запустит новый обход). - После "completed" используйте slack_channel_search / slack_channel_resolve, чтобы найти канал.

Параметры

wait_msinteger
Длительность long-poll в миллисекундах (по умолчанию 30000, максимум 45000)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

slack_channel_refresh_statusтолько чтениеидемпотентный

Ожидает завершения обновления каталога каналов Slack, которое уже выполняется для этого рабочего пространства. Только чтение, никогда не запускает новое. Используйте его, чтобы продолжать ждать после того, как slack_channel_refresh вернул "running". Возвращает "idle", когда ничего не выполняется. Поведение: - Выполняет длинный опрос до wait_ms; возвращает "running", если индексация всё ещё идёт (вызовите снова), "completed"/"failed", когда процесс завершился, или "idle", если обновление не выполняется. - После "completed" (или "idle") используйте slack_channel_search / slack_channel_resolve, чтобы найти канал.

Параметры

wait_msinteger
Длительность long-poll в миллисекундах (по умолчанию 30000, максимум 45000)
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

slack_channel_resolveидемпотентныйвнешний мир

Разрешает один точный канал Slack по имени ('general' / '#general') или идентификатору ('C0123ABCD') и сверяет его вживую со Slack. Подтверждённый результат можно безопасно передавать в automation_create / automation_update в качестве resource_id. Инструмент не только читает: сверка обновляет индексированный каталог (добавляет подтверждённый канал, удаляет его, если он исчез). Поведение: - not_connected: Slack не подключён — сначала подключите его через integration_manage (операция "connect"). - not_found: канал не существует или, для приватного канала, бот не получил приглашение. Новые каналы и те, куда бота только что пригласили, индексируются автоматически в течение нескольких секунд, так что быстрый повторный запрос часто решает проблему; в противном случае уточните у пользователя, прежде чем обновлять полный список через slack_channel_refresh. - refresh_required: каталог ещё не проиндексирован — запустите slack_channel_refresh, затем повторите запрос. Пример: { "channel": "#product-feedback" }

Параметры

channelstringобязательный
Название канала ('general' или '#general') или ID канала ('C0123ABCD').
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

slack_channel_searchтолько чтениеидемпотентный

Перечисляет каналы Slack рабочего пространства, имя которых содержит подстроку (постранично). Читает индексированный каталог каналов, поэтому работает быстро. Только чтение: чтобы подтвердить конкретный канал перед сохранением автоматизации, используйте slack_channel_resolve. Поведение: - not_connected: Slack не подключён. Сначала подключите его через integration_manage (операция "connect"). - directory_synced: false с пустым результатом означает, что каталог ещё не проиндексирован. Запустите slack_channel_refresh, затем повторите поиск. Примеры: - { "query": "feedback", "limit": 25 } - { } (перечислить все проиндексированные каналы)

Параметры

cursorinteger
Смещение для постраничной навигации - передайте next_cursor из предыдущего ответа.
limitinteger
Максимальное количество каналов для возврата (по умолчанию 25).
querystring
Подстрока без учёта регистра, которая сопоставляется с названиями каналов. Не указывайте её или передайте пустое значение, чтобы вывести список всех проиндексированных каналов.
workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

workspace_getтолько чтениеидемпотентный

Возвращает сведения об одном рабочем пространстве по id или uniqueName (slug): название, тарифный план и количество участников. Поведение: - Только для чтения. - Выдаёт ошибку, если рабочее пространство не существует или у вас нет доступа. - Принимает либо ID рабочего пространства, либо uniqueName (slug) в аргументе workspace_id. - Возвращает описание для сопоставления с контекстом. - НЕ сообщает, является ли это рабочее пространство рабочим пространством по умолчанию для вызывающего: для этого один раз вызовите workspace_get_default и сравните id на стороне клиента. Когда использовать этот инструмент: - У вас уже есть workspace_id (например, из workspace_get_default), и нужно узнать тарифный план или количество участников. - Нужно подтвердить, на какое рабочее пространство указывает slug, перед выполнением операций записи в него. Когда НЕ использовать этот инструмент: - Вы не знаете, какое рабочее пространство имеет в виду пользователь: используйте workspace_list (постраничная выдача, поддерживает поиск). - Вам нужно только рабочее пространство по умолчанию: используйте workspace_get_default.

Параметры

workspace_idstringобязательный
ID рабочего пространства (из workspace_get_default или workspace_list) или slug рабочего пространства (uniqueName)

workspace_get_defaultтолько чтениеидемпотентный

Возвращает рабочее пространство пользователя по умолчанию (id, uniqueName, name, description), чтобы использовать его как аргумент workspace_id для других инструментов без запроса. Поведение: - Работает только на чтение. Не принимает параметров. - Выбирает пространство по умолчанию по приоритету: явно заданное пользователем по умолчанию > первое собственное пространство с активностью > приглашённое пространство. Та же логика, что использует веб-приложение для автоматического выбора. - Когда ни одно пространство недоступно, возвращает объект с полями null (НЕ выдаёт ошибку). Это происходит, когда у пользователя нет доступных пространств (собственных или приглашённых), или когда сессия с ограничением по пространству не достигает ни одного из пространств пользователя. - Совершенно новый аккаунт, который не завершил настройку, также получает onboarding_url. Передайте эту ссылку и дождитесь подтверждения пользователя, что он закончил, прежде чем повторить попытку. Когда использовать этот инструмент: - В начале разговора, когда пользователь не назвал пространство - избавляет от вопроса, какое использовать. - Всякий раз, когда вам нужен workspace_id, а пользователь подразумевает "моё пространство" или не указал его. Когда НЕ использовать этот инструмент: - Пользователь называет конкретное пространство - используйте workspace_list, чтобы найти его по имени. - У вас уже есть workspace_id, и вы хотите только его детали - используйте workspace_get. - Перечисление всех доступных пространств - используйте workspace_list.

Параметры

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

workspace_listтолько чтениеидемпотентный

Перечисляет все рабочие пространства, к которым у пользователя есть доступ, с workspace_id, uniqueName (slug) и отображаемым именем. Поведение: - Только чтение. Размер страницы 20, сортировка по имени. Передавайте nextCursor обратно в качестве курсора, чтобы получить следующую страницу. - Необязательный поиск выполняется по имени, uniqueName (slug) и веб-сайту (без учёта регистра); пустые результаты возвращают пустой массив. - Другие инструменты perspective принимают workspace_id или uniqueName взаимозаменяемо. - Возвращает описание для каждого рабочего пространства. Используйте его, чтобы подобрать нужное рабочее пространство по контексту. - НЕ помечает, какое рабочее пространство является для вызывающего по умолчанию. Вызовите workspace_get_default один раз и сравните идентификаторы на стороне клиента, если нужно его выделить. Когда использовать этот инструмент: - Пользователь называет конкретное рабочее пространство, и вам нужен его workspace_id (отфильтруйте с помощью поиска). - Нужно показать пользователю полный набор рабочих пространств, из которых он может выбирать. Когда НЕ использовать этот инструмент: - Вам нужно только рабочее пространство пользователя по умолчанию. Используйте workspace_get_default. - У вас уже есть workspace_id, и нужны подробности. Используйте workspace_get.

Параметры

cursorstring
Курсор пагинации из предыдущего ответа
searchstring
Сопоставляет без учёта регистра с name, uniqueName (slug) и website.

Выберите клиент, чтобы установить Perspective-AI/mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "perspective-ai-mcp-f92kmu6br3": {
      "type": "http",
      "url": "https://getperspective.ai/mcp"
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "perspective-ai-mcp-f92kmu6br3": {
      "type": "http",
      "url": "https://getperspective.ai/mcp"
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "perspective-ai-mcp-f92kmu6br3": {
      "type": "http",
      "url": "https://getperspective.ai/mcp"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"perspective-ai-mcp-f92kmu6br3\",\"type\":\"http\",\"url\":\"https://getperspective.ai/mcp\"}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "perspective-ai-mcp-f92kmu6br3": {
      "type": "http",
      "url": "https://getperspective.ai/mcp"
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add --transport http perspective-ai-mcp-f92kmu6br3 https://getperspective.ai/mcp

Либо через JSON-конфиг:

claude mcp add-json perspective-ai-mcp-f92kmu6br3 "{\"type\":\"http\",\"url\":\"https://getperspective.ai/mcp\"}"

Codex

Добавьте сервер командой в терминале:

codex mcp add perspective-ai-mcp-f92kmu6br3 --url https://getperspective.ai/mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.perspective-ai-mcp-f92kmu6br3]
url = "https://getperspective.ai/mcp"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите Perspective-AI/mcp.

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "perspective-ai-mcp-f92kmu6br3": {
      "type": "http",
      "url": "https://getperspective.ai/mcp"
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "perspective-ai-mcp-f92kmu6br3": {
      "type": "http",
      "url": "https://getperspective.ai/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например perspective-ai-mcp-f92kmu6br3.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: perspective-ai-mcp-f92kmu6br3
    type: http
    url: https://getperspective.ai/mcp

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "perspective-ai-mcp-f92kmu6br3": {
      "type": "http",
      "url": "https://getperspective.ai/mcp"
    }
  }
}

Конфиг для установки сервера

{
  "type": "http",
  "url": "https://getperspective.ai/mcp"
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 5
Форков на Github: 1
Язык реализации: Shell
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 14.10 в 06:26
Идентификатор: y483oqc7K3OPGOrB
Категории: Автоматизация приложений, Агенты

Perspective-AI/mcp

Perspective AI MCP Server

What this MCP server does

Похожие MCP-сервера

valado/pantheon-mcp

eliottreich/taskbounty-mcp-server

modus-agendi/managed-agent-control-mcp

recursechat/mcp-server-apple-shortcuts

pminervini/deep-research-mcp

incentivai/quickchat-ai-mcp