@txscribe/mcp

MCP-сервер для developer API txscribe. Он позволяет AI-ассистенту транскрибировать ссылку с помощью вашей учётной записи txscribe, а затем получать транскрипт и сводку через тот же API, документация к которому доступна по адресу https://txscribe.ai/developers.

Подключиться можно двумя способами. В обоих случаях доступны одни и те же восемь инструментов:

Размещённый сервер — https://txscribe.ai/mcp (Streamable HTTP). Claude и ChatGPT подключаются к нему как к пользовательскому коннектору и выполняют вход в txscribe через OAuth. Устанавливать ничего не нужно. Клиенты, которые поддерживают заголовки, могут вместо этого передавать API-ключ.
Локальный сервер — этот пакет. Claude Desktop, Claude Code, Cursor и другие клиенты, которые запускают MCP-серверы самостоятельно, выполняют его как команду (npx -y @txscribe/mcp), передавая API-ключ через окружение.

Оба варианта — тонкие обёртки: каждый вызов инструмента обращается к developer API от вашего имени. Возможности инструментов и расход минут соответствуют возможностям вашей учётной записи в приложении. Данные не кэшируются и не сохраняются на вашем устройстве.

Размещённый сервер: Claude и ChatGPT

Claude (claude.ai или настольное приложение): откройте Settings → Connectors → Add custom connector и укажите URL https://txscribe.ai/mcp. Claude откроет txscribe; войдите в систему и выберите Разрешить.
ChatGPT (с включённым режимом разработчика): добавьте коннектор с URL https://txscribe.ai/mcp и OAuth в качестве способа аутентификации, затем разрешите подключение на открывшейся странице txscribe.
Claude Code: выполните claude mcp add --transport http txscribe https://txscribe.ai/mcp (вход выполняется через OAuth) или укажите ключ:

claude mcp add --transport http txscribe https://txscribe.ai/mcp --header "Authorization: Bearer txs_live_…".

Cursor и другие клиенты, поддерживающие URL и заголовки: укажите URL выше и заголовок Authorization: Bearer txs_live_….

При подключении через Разрешить приложение сохраняет для вас API-ключ. Он отображается в разделе Тарифный план и оплата → Developer API. Нажмите Отозвать, чтобы отключить приложение. Срок действия ключа не истекает автоматически.

Локальный сервер: этот пакет

В приложении откройте Тарифный план и оплата → Developer API и создайте ключ. Он начинается с txs_live_; посмотреть его можно только один раз.
Добавьте сервер в клиент, передав ключ через окружение.

Claude Desktop (claude_desktop_config.json) или любой клиент, принимающий команду:

{
  "mcpServers": {
    "txscribe": {
      "command": "npx",
      "args": ["-y", "@txscribe/mcp"],
      "env": { "TXSCRIBE_API_KEY": "txs_live_…" }
    }
  }
}

Claude Code:

claude mcp add txscribe --env TXSCRIBE_API_KEY=txs_live_… -- npx -y @txscribe/mcp

Переменная TXSCRIBE_API_BASE указывает серверу адрес другого развёртывания. По умолчанию используется https://txscribe.ai/api/v1.

Инструменты

Инструмент	Назначение	Изменяет данные?
`list_transcriptions`	Список ваших транскрипций, от новых к старым, с постраничной навигацией	нет
`search_transcriptions`	Находит записи, в которых произнесено заданное слово или фраза, и указывает время: до пяти совпадений для каждой записи с отметкой секунды, на которой они начинаются. Поиск выполняется по завершённым транскрипциям среди 500 последних записей; ищутся произнесённые слова, а не названия записей.	нет
`transcribe_link`	Создаёт транскрипцию по ссылке (YouTube, Google Drive, Dropbox и др.). Запись транскрибируется, но не скачивается. Расходует минуты вашего тарифа.	да
`get_transcription`	Возвращает статус и метаданные одной транскрипции	нет
`get_transcript`	Возвращает готовый транскрипт в формате `json` (сегменты, временные метки слов, говорящие), `txt`, `srt` или `vtt`; параметры `from` и `to` (секунды) позволяют получить только абзацы вокруг нужного момента, а `summaryOnly` — вместо транскрипта получить сводку	нет
`get_summary`	Возвращает сводку и её статус	нет
`request_summary`	Запрашивает сводку или её новую версию на указанном языке и для заданного типа записи	да
`delete_transcription`	Удаляет транскрипцию и все созданные на её основе данные. Отменить удаление нельзя.	да, безвозвратно

Пять инструментов только читают данные, три изменяют вашу учётную запись. Загрузка файла не входит в число инструментов: API загружает файл целиком с помощью подписанного PUT-запроса, который ассистент не может отправить из чата. Для работы с файлами используйте приложение или обращайтесь к API напрямую.

Пример обычного диалога: «Расшифруй это выступление и перечисли три утверждения, которые нужно проверить» → transcribe_link → get_transcription до тех пор, пока статус не станет done → get_transcript (txt) → ассистент читает транскрипт; затем request_summary и get_summary — чтобы получить сводку, созданную txscribe.

Чтобы найти нужную информацию в уже имеющихся записях, можно спросить: «О чём мы договорились насчёт бюджета?» → search_transcriptions («budget») → get_transcript с параметрами from и to, охватывающими найденные совпадения, вместо получения транскриптов целиком.

Ошибки

Отказы API возвращаются как ошибки инструментов с кодом API (invalid_api_key, quota_exceeded, not_ready, unsupported_link и др.), HTTP-статусом, идентификатором запроса для обращения в службу поддержки и, при ответе 429, числом секунд из Retry-After. Сервер не выполняет повторные запросы.

Разработка

npm ci
npm test

Тесты запускают сервер через транспорт в памяти и используют поддельный fetch; сетевые запросы не выполняются. Размещённый сервер находится в веб-приложении (web/src/lib/mcp/); тесты проверяют, что список его инструментов совпадает со списком в этом пакете.

Публикация (для сопровождающих)

cd mcp
npm ci && npm test
npm login                      # an npm account that owns the @txscribe scope
npm publish                    # publishConfig makes it public; prepublishOnly runs the tests

Файл server.json используется для регистрации в MCP Registry (registry.modelcontextprotocol.io). Его поле name совпадает со значением mcpName в package.json — по нему реестр проверяет, что npm-пакет принадлежит нам.

Опубликуйте пакет после его публикации в npm и включения размещённой конечной точки. Для этого используйте mcp-publisher и подтвердите владение доменом txscribe.ai через DNS.