ГайдыMCP-сервер

Подключите QuillAI к любому AI-ассистенту

QuillAI предоставляет Model Context Protocol (MCP) сервер, чтобы AI-ассистенты — Antigravity, Claude Desktop, Cursor, ChatGPT, Cline — могли расшифровывать аудио и видео за вас без единой строки интеграционного кода.

Endpoint: https://mcp.quillhub.ai/mcp
Авторизуйтесь тем же токеном qai_live_, что и для REST API. Создать или перевыпустить ключ →

Зачем MCP?

MCP — открытый стандарт, через который AI-ассистенты находят и вызывают внешние инструменты. Один протокол, все ключевые клиенты:

Без glue-кода — добавьте один JSON-сниппет в клиент, и он увидит все QuillAI tools с типизированными параметрами и описаниями.
Разговорный стиль — ассистент сам читает схемы tools, выбирает нужный, заполняет поля и обрабатывает пагинацию.
Те же гарантии, что у REST API — идентичная авторизация, одинаковый envelope ошибок, одна и та же стоимость в поинтах.

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

Три шага от нуля до «Клод, расшифруй это YouTube-видео»:

Получите API-ключ

Создайте ключ на странице Developers. Подойдёт любой qai_live_ — MCP-сервер это тонкая обёртка над REST API.

Вставьте конфиг

Найдите ниже сниппет под ваш клиент, вставьте его, замените на свой ключ.

Перезапустите клиент

После перезапуска клиент увидит шесть новых tools: get_account, create_transcription, get_transcription, list_transcriptions, cancel_transcription, wait_for_transcription.

Antigravity

Откройте MCP manager, нажмите View raw config и вмёрджьте сниппет ниже в mcp.json.

mcp.jsonjson

{
  "quillai": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://mcp.quillhub.ai/mcp",
      "--header",
      "Authorization:Bearer qai_live_YOUR_KEY"
    ]
  }
}

Claude Desktop

Отредактируйте claude_desktop_config.json — на macOS он лежит в ~/Library/Application Support/Claude/, на Windows — в %APPDATA%/Claude/.

claude_desktop_config.jsonjson

{
  "mcpServers": {
    "quillai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.quillhub.ai/mcp",
        "--header",
        "Authorization:Bearer qai_live_YOUR_KEY"
      ]
    }
  }
}

Полностью закройте Claude (из трея или дока, не просто окно) и откройте заново — только тогда изменения применятся.

Cursor / Cline / другие MCP-клиенты

Любой клиент, поддерживающий стандартный конфиг mcpServers, подключается так же. Добавьте снипет в MCP-конфиг клиента.

.cursor/mcp.jsonjson

{
  "mcpServers": {
    "quillai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.quillhub.ai/mcp",
        "--header",
        "Authorization:Bearer qai_live_YOUR_KEY"
      ]
    }
  }
}

После двоеточия не нужен пробел. Пишите Authorization:Bearer qai_live_..., а не Authorization: Bearer qai_live_.... Некоторые версии mcp-remote режут аргументы по пробелу и теряют токен.

Доступные tools

Сервер анонсирует шесть tools. Схемы повторяют REST API — если вы пользовались HTTP-эндпоинтами, разница будет минимальной.

Tool	Описание
`get_account`	Получить данные аккаунта — user id, остаток поинтов, подписка. Быстрый вызов, подходит для liveness-проверки.
`create_transcription`	Создать транскрипцию из URL (YouTube, Instagram, прямой аудио/видео URL) или inline base64 файла (≤25 MB).
`get_transcription`	Получить транскрипцию в одном из шести форматов: `summary` (по умолчанию, ~3-6 kB), `text`, `segments`, `paragraphs`, `chapters`, `subtitles`. Берите минимальный, который отвечает на вопрос.
`list_transcriptions`	Лёгкие саммари транскрипций владельца ключа, свежие сверху. В каждой строке title, summary, key_theses, highlights, длительность — БЕЗ полного текста. Фильтрация: `q` (поиск по тексту), `created_before`, `created_after`.
`cancel_transcription`	Отменить задачу в статусе queued или processing. На терминальных транскрипциях — no-op.
`wait_for_transcription`	Опрашивать транскрипцию до терминального статуса или таймаута. Избавляет агента от собственного polling-цикла.
`get_developer_docs`	Возвращает developer-документацию QuillAI в markdown для агентов, которые пишут интеграционный код. Без `topic` — короткий индекс, `all` — всё целиком, имя секции (например, `webhooks`) — только её.

Прямой HTTP (без MCP-клиента)

MCP-сервер можно вызывать напрямую через HTTP с plain JSON-RPC — удобно для отладки, скриптов и кастомных агентов. На каждый POST нужен заголовок Authorization и JSON-RPC тело.

direct-call.shbash

curl -X POST https://mcp.quillhub.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer qai_live_YOUR_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "create_transcription",
      "arguments": { "url": "https://youtu.be/dQw4w9WgXcQ" }
    }
  }'

Ограничения

Inline-загрузка base64 ограничена 25 MB. Для больших файлов загружайте в S3/Wasabi/любой публичный URL и передавайте поле url.
Webhook'ов через MCP нет — агенты не могут принимать входящие POST'ы. Для push-уведомлений используйте REST-вебхуки.
wait_for_transcription имеет лимит 300 секунд, чтобы не упереться в таймауты клиента. По таймауту возвращает последнее известное не-терминальное состояние (не ошибку), поэтому агент может просто позвать его ещё раз.

Берегите ключ. MCP-сервер пробрасывает заголовок Authorization дословно в REST API. Не коммитьте конфиг с реальным ключом — используйте переменные окружения или secret storage клиента, если возможно.

Вебхуки

API Reference