Model Context Protocol

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

Подключите транскрибацию аудио и видео к вашему AI-агенту. Отправьте ссылку на файл в чат — получите готовую расшифровку с распознаванием спикеров.

Быстрый старт Создать API-ключ

Что такое MCP

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

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

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

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

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

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

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

Используйте

Отправьте в чат ссылку на аудио/видео — например: "Транскрибируй https://example.com/audio.mp3"

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

Claude Desktop

Рекомендуемый

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

Альтернативный способ: через конфиг-файл (с API-ключом)

Откройте файл конфигурации:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Добавьте конфигурацию (или дополните существующую):

{
  "mcpServers": {
    "pysar": {
      "url": "https://mcp.pysar.ru",
      "headers": {
        "Authorization": "Bearer tk_ваш_ключ"
      }
    }
  }
}

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

claude.ai

Откройте Settings → Connectors
Нажмите Add custom connector
Name: Писарь
URL: https://mcp.pysar.ru
Нажмите 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

Откройте Settings → MCP
Нажмите Add new MCP server
Тип: Streamable HTTP
URL: https://mcp.pysar.ru
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

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

transcribe

Основной инструмент

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

Параметр	Тип	Описание
`url` *	string	URL аудио/видео файла
`language`	string	Код языка (ru, en, de...). Автоопределение если не указан
`output_format`	string	Формат вывода: txt (по умолчанию), srt, vtt, json
`enable_diarization`	boolean	Распознавание спикеров (по умолчанию: включено)
`num_speakers`	number	Ожидаемое количество спикеров (1–20)

get_transcription

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

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

list_transcriptions

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

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

Примеры использования

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

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

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

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

“Покажи мои последние транскрипции”

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

“Получи результат транскрипции с ID ..., если она уже готова”

Форматы вывода

txt

Читаемый текст с метками спикеров и временными отсечками. По умолчанию

srt

Субтитры SubRip — для встраивания в видео

vtt

Субтитры WebVTT — для веб-плееров

json

Структурированные сегменты — для программной обработки

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

Аудио

MP3, WAV, OGG, FLAC, AAC, M4A, WMA

Видео

MP4, WebM, MKV, MOV, AVI

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

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

Нужна ли подписка для использования MCP-сервера?

Да, MCP-сервер использует минуты вашего тарифного плана. Бесплатный план включает пробные минуты.

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

Нет, MCP-сервер принимает только URL-ссылки на файлы. Загрузите файл на любой хостинг (Google Drive, Dropbox, S3) и отправьте ссылку.

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

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

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

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

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

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

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

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