MCP-сервер Писаря

Подключите свои исследования к Claude или Cursor. Ассистент ищет по всем интервью проекта, запускает разбор и собирает сводный отчёт — и отвечает дословными цитатами с таймкодами, а не пересказом.

Где в проекте «Онбординг» жалуются на подтверждение телефона? Дай дословные цитаты.
pysar · search_interviews

Нашёл в 5 из 9 интервью. Самые показательные:

04:12 · Анна К., продакт

«Мы теряем клиентов на третьем шаге — там, где просят подтвердить телефон»

17:48 · Игорь М., руководитель продаж

«Половина заявок не доходит до звонка: люди бросают на коде из СМС»

Обновить сводный отчёт по проекту и выгрузить в XLSX?

Что можно делать из чата

Ассистент работает с теми же проектами, что и веб-версия: всё, что он создаст или разберёт, сразу видно в Писаре.

Спросить свои интервью

«Где в проекте «Онбординг» жалуются на цену? Дай дословные цитаты с таймкодами»

search_interviews

Начать исследование

«Создай проект про онбординг бухгалтеров и собери гайд под гипотезу, что их пугает настройка интеграций»

create_projectmanage_guide

Загрузить и разобрать интервью

«Добавь в проект записи из этой папки на Яндекс.Диске и разбери их»

list_cloud_filesadd_interviewanalyze_interviews

Собрать выводы

«Какие гипотезы подтвердились? Обнови сводку и выгрузи отчёт в XLSX»

get_reportexport_report

Что такое MCP

Model Context Protocol (MCP) — открытый стандарт от Anthropic для подключения внешних инструментов к AI-агентам. MCP позволяет языковым моделям вызывать внешние сервисы прямо из чата.

MCP-сервер Писаря даёт ассистенту доступ к вашим исследованиям — проектам, гайдам, интервью, разборам и сводным отчётам, — а также расшифровывает аудио и видео по ссылке. Подключить его можно к Claude Desktop, Claude Code, Cursor, claude.ai и любому другому MCP-совместимому клиенту.

Быстрый старт

  1. 01

    Создайте аккаунт

    Зарегистрируйтесь или войдите в существующий аккаунт

  2. 02

    Подключите агента

    В настройках клиента добавьте коннектор с URL https://mcp.pysar.ru — войдите и разрешите доступ (см. инструкции ниже)

  3. 03

    Используйте

    Попросите в чате, например: «Покажи мои проекты» или «Найди в проекте „Онбординг“, где жалуются на цену, — дословно»

Настройка клиентов

Claude Desktop

Рекомендуемый
  1. Откройте Settings → Connectors → Add custom connector
  2. Name: Писарь
  3. URL: https://mcp.pysar.ru
  4. Нажмите Add → войдите в аккаунт → разрешите доступ
Альтернативный способ: через конфиг-файл (с API-ключом)
  1. Откройте файл конфигурации:
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. Добавьте конфигурацию (или дополните существующую):
{
  "mcpServers": {
    "pysar": {
      "url": "https://mcp.pysar.ru",
      "headers": {
        "Authorization": "Bearer tk_ваш_ключ"
      }
    }
  }
}

После сохранения перезапустите Claude Desktop.

claude.ai

  1. Откройте Settings → Connectors
  2. Нажмите Add custom connector
  3. Name: Писарь
  4. URL: https://mcp.pysar.ru
  5. Нажмите Add → войдите в аккаунт Писаря → разрешите доступ

OAuth Client ID и Secret оставьте пустыми — используется динамическая регистрация.

Claude Code

Выполните в терминале:

claude mcp add --transport streamable-http pysar https://mcp.pysar.ru

Claude Code откроет браузер для входа в аккаунт.

Альтернативный способ: с API-ключом
claude mcp add --transport streamable-http pysar https://mcp.pysar.ru \
  --header "Authorization: Bearer tk_ваш_ключ"

Cursor

  1. Откройте Settings → MCP
  2. Нажмите Add new MCP server
  3. Тип: Streamable HTTP
  4. URL: https://mcp.pysar.ru
  5. Cursor откроет браузер для входа в аккаунт
Альтернативный способ: с API-ключом
URL:            https://mcp.pysar.ru
Authorization:  Bearer tk_ваш_ключ

Другие MCP-клиенты

Если клиент поддерживает OAuth, достаточно указать URL без заголовка Authorization — авторизация произойдёт через браузер:

Endpoint:  https://mcp.pysar.ru
Transport: Streamable HTTP
Без OAuth: с API-ключом
Endpoint:  POST https://mcp.pysar.ru
Header:    Authorization: Bearer tk_ваш_ключ
Transport: Streamable HTTP

Доступные инструменты

Исследования

list_projectsВаши проекты и проекты, к которым вам открыли доступ
create_projectСоздать исследовательский проект
get_projectОбзор проекта: гайд и статусы интервью
manage_guideГайд интервью: сгенерировать по анкете, импортировать свой, править вопросы и гипотезы
add_interviewДобавить интервью готовым текстом или записью по ссылке
list_interviewsИнтервью проекта со статусами расшифровки и разбора
analyze_interviewsРазобрать одно интервью или все неразобранные в проекте
get_interviewРезультат разбора: JTBD, боли, решения, сигналы, вердикты по гипотезам
get_transcriptРасшифровка интервью целиком — с таймкодами и спикерами
search_interviewsПоиск по расшифровкам и разборам: дословные цитаты с таймкодом и спикером
get_reportСводный отчёт по проекту: покрытие гайда, вердикты по гипотезам, кластеры болей и JTBD
export_reportВыгрузить отчёт в CSV или XLSX и получить ссылку на файл

Расшифровка файлов

transcribeРасшифровка по ссылке

Транскрибирует аудио/видео файл по URL. Скачивает файл, отправляет на распознавание, возвращает текстовую расшифровку.

ПараметрТипОписание
url *stringURL аудио/видео файла
languagestringКод языка (ru, en, de...). Автоопределение если не указан
output_formatstringФормат вывода: txt (по умолчанию), srt, vtt, json
enable_diarizationbooleanРаспознавание спикеров (по умолчанию: включено)
num_speakersnumberОжидаемое количество спикеров (1–20)
get_transcription

Получить результат транскрипции по ID. Используйте, если транскрипция не успела завершиться при первом вызове.

ПараметрТипОписание
transcription_id *string (UUID)ID транскрипции
output_formatstringФормат вывода: txt (по умолчанию), srt, vtt, json
list_transcriptions

Список последних транскрипций пользователя с их статусами.

ПараметрТипОписание
limitnumberКоличество записей (1–50, по умолчанию: 10)

Ещё два вспомогательных: list_cloud_files — показать записи в папке на Яндекс.Диске, Google Drive, Dropbox, OneDrive или в Облаке Mail.ru, и get_transcription_url — ссылка на файл расшифровки, когда текст слишком большой для чата.

Ещё примеры запросов

После подключения MCP-сервера вы можете отправлять промпты прямо в чат:

  • “Транскрибируй это аудио: https://example.com/meeting.mp3”

  • “Добавь эту запись в проект «Онбординг» и разбери её”

  • “Транскрибируй видео с субтитрами в формате SRT: https://example.com/lecture.mp4”

  • “Какие гипотезы в проекте подтвердились, а какие нет?”

  • “Расшифруй интервью на 3 спикера и раздели реплики по ролям”

  • “Что респонденты говорили про конкурентов? Только дословные цитаты”

Форматы расшифровки

txt
Читаемый текст с метками спикеров и временными отсечками. По умолчанию
srt
Субтитры SubRip — для встраивания в видео
vtt
Субтитры WebVTT — для веб-плееров
json
Структурированные сегменты — для программной обработки

Поддерживаемые форматы файлов

Аудио
MP3, WAV, OGG, FLAC, AAC, M4A, WMA
Видео
MP4, WebM, MKV, MOV, AVI

Максимальный размер файла по URL: 2 ГБ. Таймаут ожидания транскрипции: 10 минут.

Частые вопросы

Нужна ли платная подписка?

Нет, MCP работает и на бесплатном тарифе. Разборы и расшифровка списываются с вашего тарифа так же, как в веб-версии: на «Старте» это три разбора и час расшифровки в месяц.

Можно ли передать файл напрямую, а не по ссылке?

Нет, MCP-сервер принимает ссылки. Подойдёт ссылка на файл или на папку в Яндекс.Диске, Google Drive, Dropbox, OneDrive или Облаке Mail.ru — ассистент сам покажет, какие записи в ней лежат. Готовый транскрипт можно передать текстом.

Увидит ли ассистент проекты, которыми со мной поделились?

Да. В список попадают ваши проекты и те, к которым вам открыли доступ другие пользователи.

Что происходит, если транскрипция не успевает за 10 минут?

Сервер вернёт ID транскрипции. Используйте инструмент get_transcription, чтобы получить результат позже.

Сколько API-ключей можно создать?

Количество API-ключей не ограничено. Вы можете создать отдельный ключ для каждого агента.

Какие агенты поддерживаются?

Любой MCP-совместимый клиент с поддержкой Streamable HTTP транспорта: Claude Desktop, Claude Code, claude.ai, Cursor и другие.

В чём разница между коннектором и API-ключом?

Коннектор использует OAuth — вы входите через браузер и не вводите ключ вручную. API-ключ удобнее для автоматизации (Claude Code, скрипты). Оба способа работают одновременно.

Разберите первое интервью бесплатно

Три разбора в месяц без карты. Вставьте готовый транскрипт — и через несколько минут увидите выводы с цитатами.