Программный доступ и автоматизация

Короткое описание

Работать с Whisperer без интерфейса можно тремя способами: MCP-сервер для AI-клиентов, подключённые сервисы для рутинной автоматизации и экспорт, чтобы перенести материал в другой инструмент. Публичного REST API у Whisperer нет: адреса под /v1/ — это внутренний канал между нашими приложениями и бэкендом, они не дают обещания совместимости и могут измениться в любой момент.

Это осознанная граница, а не недоделка. Опубликованный API обязан работать годами; MCP даёт тот же доступ, но с версионированием, экраном согласия и отзывом прав уже внутри.

Когда использовать

  • Нужно, чтобы AI-ассистент читал встречи и работал с задачами, — MCP.
  • Нужно повторяющееся действие («новая встреча → строка в таблице») — Zapier.
  • Нужен сам материал в другом инструменте — экспорт.

Пошаговая инструкция

  1. Для AI-клиентов подключайтесь по MCP: MCP: подключение Claude, ChatGPT и Cursor. Это поддерживаемый программный путь и единственный, на который распространяется обещание стабильности.
  2. Для автоматизации подключите в кабинете Zapier, Notion, Slack или HubSpot и стройте сценарий уже в этом сервисе.
  3. Для разовых переносов выгрузите встречу в Markdown, SRT, VTT или JSON со страницы встречи.
  4. Для машиночитаемых сведений о продукте — например, если хотите, чтобы AI-ассистент отвечал на вопросы о самом Whisperer, — укажите ему https://whisperer.one/llms.txt или полный корпус https://whisperer.one/llms-full.txt. Оба открыты и не требуют авторизации.

Что открыто публично

Адрес Что это
https://whisperer.one/mcp MCP-сервер для внешних AI-клиентов
https://whisperer.one/.well-known/oauth-protected-resource Откуда клиент узнаёт, как авторизоваться
https://whisperer.one/.well-known/oauth-authorization-server Endpoint'ы OAuth и поддерживаемые области доступа
https://whisperer.one/llms.txt Указатель по продукту для AI-систем
https://whisperer.one/llms-full.txt Вся публичная документация одним файлом
https://whisperer.one/docs/en/<страница>.md Любая страница английской документации в чистом Markdown

Частые ошибки

  • Строить интеграцию на /v1/. Эти адреса внутренние: они закрыты от краулеров, схема в проде выключена, и меняются они без предупреждения.
  • Искать API-ключ. Его нет, потому что нет публичного REST API. Внешний доступ — это bearer-токен, выданный через согласие в MCP.
  • Ждать вебхуков. Исходящая автоматизация идёт через Zapier и подключённые сервисы, а не через наши вебхуки.

Лучшие практики

  • Читайте адреса OAuth из документа метаданных, а не прописывайте их в коде: они там опубликованы как раз для того, чтобы могли переехать, не ломая клиентов.
  • Заводите для каждой интеграции своё подключение, чтобы отозвать одно, не задев остальные.

Связанные статьи