Сервер MCP

Speechdash поставляется с официальным сервером Model Context Protocol (MCP), который предоставляет библиотеку и синтез речи в виде инструментов. Используйте его, если хотите, чтобы ваш помощник на основе ИИ перечислял документы (включая завершённые транскрипты), создавал текстовые импорты, переводил или экспортировал, проверял ваш кошелёк или синтезировал речь без написания HTTP-запросов самостоятельно. Библиотека включает завершённые транскрипты (source=transcription). Нет инструмента для транскриптов: читайте эти задания с помощью инструментов документов. MCP не запускает аудио-транскрипты.

Вы также можете напрямую вызывать публичный REST API с помощью curl или вашего собственного клиента. MCP и HTTP используют одни и те же конечные точки, кредиты и лимиты запросов там, где обе поверхности существуют.

Перед началом

Создайте API-ключ в разделе Настройки → API в приложении для Cursor, Claude Desktop и других клиентов, которые принимают ключи типа "bearer". MCP использует те же ключи sh_live_…, что и HTTP. Подробнее см. Обзор API.

ChatGPT (OAuth)

ChatGPT требует OAuth 2.1 + PKCE, а не вставленный API-ключ. Не вводите API-ключ в интерфейсе подключения ChatGPT.

1. MCP URL: https://mcp.speechdash.com/mcp
2. OAuth ресурс: https://mcp.speechdash.com
3. Метанформация защищённого ресурса: https://mcp.speechdash.com/.well-known/oauth-protected-resource
4. Сервер авторизации (открытие): https://speechdash.com/.well-known/oauth-authorization-server

Войдите в систему с помощью вашего аккаунта Speechdash, когда ChatGPT запросит это. Токены доступа выдаются приложением и принимаются сервером MCP и публичным API.

Пошаговая инструкция по настройке: Agents hub.

Инструменты

Каждый инструмент MCP соответствует одной REST конечной точке:

Сервер также предоставляет ресурс speechdash://openapi (живой JSON OpenAPI).

MCP vs REST возможности

Биллинг

Синтез речи через MCP списывает с того же кошелька кредитов, что и REST и воспроизведение в облаке в приложении. Создание документов через MCP не тратит кредиты, но учитывается в том же дневном лимите документов, что и в приложении и REST API. Вызовите speechdash_get_account перед синтезом, чтобы проверить баланс.

speechdash_translate_document списывает с того же кошелька кредитов, что и экспорт в MP3 (0.5 кредита за каждые начатые 30 секунд оценённой речи). speechdash_export_document может возвращать большие файлы: предпочтите txt, csv или srt в MCP. pdf и docx — бинарные. speechdash_update_document принимает visibility для страницы непубличного доступа и is_archived, чтобы архивировать или восстановить.

Cursor или Claude Desktop

Используйте Streamable HTTP с хостируемым сервером MCP и вашим личным API-ключом. Пример .cursor/mcp.json:

{
  "mcpServers": {
    "speechdash": {
      "url": "https://mcp.speechdash.com/mcp",
      "headers": {
        "Authorization": "Bearer sh_live_your_key_here"
      }
    }
  }
}

Создайте ключ в разделе Настройки → API в приложении.

Локальное развитие (клон репозитория)

Если вы работаете с клона репозитория Speechdash:

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp

По желанию: направьтесь на локальный API с помощью SPEECHDASH_API_BASE=http://localhost:3003/v1, пока bun dev:api работает.

Streamable HTTP (локальный)

Для HTTP клиентов MCP во время локального развития:

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:http

По умолчанию конечная точка: http://127.0.0.1:3010/mcp

Документы для агентов

Машинно-читаемый контекст продукта для ботов:

Связанное