Сервер MCP
Підключіть Cursor, Claude Desktop, ChatGPT або інші клієнти MCP до публічного API Speechdash.
Speechdash поставляє офіційний сервер Model Context Protocol (MCP), який надає бібліотеку та синтез мови як інструменти. Використовуйте його, коли хочете, щоб штучний інтелект допоміг перелічити документи (включаючи завершені транскрипти), створити імпорт тексту, перекласти або експортувати, перевірити ваш гаманець або синтезувати мову без написання HTTP-запитів самостійно. Бібліотека включає завершені транскрипти (source=transcription). Інструментів для транскриптів немає: читайте ці завдання за допомогою інструментів документів. MCP не запускає завдання аудіо-транскрипції.
Ви також можете безпосередньо викликати публічний REST API за допомогою curl або свого власного клієнта. MCP і HTTP діляться однаковими кінцевими точками, кредитами та обмеженнями швидкості там, де обидві поверхні існують.
Вхідний (поточна сторінка): Офіційний MCP Speechdash на mcp.speechdash.com дозволяє зовнішнім асистентам викликати вашу бібліотеку Speechdash.
Вихідний (налаштування додатку): Налаштування → З’єднання приєднує третій-сторонні сервери MCP до вбудованого чат-інтерфейсу, коли ця функція увімкнена. Це не публічний сервер MCP Speechdash.
Ніколи не встановлюйте SPEECHDASH_API_KEY на публічному розгорнутому mcp.speechdash.com. Кожен клієнт повинен аутентифікуватися за допомогою OAuth або особистого ключа sh_live_… у заголовку Authorization.
Перед тим, як почати
Створіть API-ключ у розділі Налаштування → API в додатку для Cursor, Claude Desktop та інших клієнтів, які приймають ключі типу "Bearer". MCP використовує ті самі ключі sh_live_…, що й HTTP. Див. Огляд API.
ChatGPT (OAuth)
ChatGPT вимагає OAuth 2.1 + PKCE, а не вставлений API-ключ. Не вводите API-ключ у інтерфейсі з’єднання ChatGPT.
- MCP URL:
https://mcp.speechdash.com/mcp - OAuth ресурс:
https://mcp.speechdash.com - Захищений ресурс метадані:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Сервер авторизації (відкриття):
https://speechdash.com/.well-known/oauth-authorization-server
Увійдіть у систему за допомогою вашого облікового запису Speechdash, коли ChatGPT запропонує це. Токени доступу виготовляються додатком і приймаються сервером MCP та публічним API.
Похідний посібник: Agents hub.
Інструменти
Кожен інструмент MCP відповідає одній кінцевій точці REST:
| Інструмент MCP | REST |
|---|---|
speechdash_get_account | GET /v1/me |
speechdash_list_documents | GET /v1/documents |
speechdash_get_document | GET /v1/documents/{document_id} |
speechdash_create_document | POST /v1/documents |
speechdash_update_document | PUT /v1/documents/{document_id} |
speechdash_translate_document | POST /v1/documents/{document_id}/translate |
speechdash_export_document | GET /v1/documents/{document_id}/export |
speechdash_delete_document | DELETE /v1/documents/{document_id} |
speechdash_list_voices | GET /v1/voices |
speechdash_get_voice | GET /v1/voices/{voice_id} |
speechdash_synthesize_speech | POST /v1/audio/speech |
Сервер також надає ресурс speechdash://openapi (живий JSON OpenAPI).
MCP vs REST можливості
| Функція | MCP | REST |
|---|---|---|
| Знімок облікового запису | Так (speechdash_get_account) | GET /v1/me |
| CRUD документів (бібліотека, включаючи завершені транскрипти) | Так | Так |
| Запуск завдань аудіо-транскрипції | Ні (тільки додаток) | Ні (тільки додаток) |
| Непотокова мова (5 тис. символів) | Так | POST /v1/audio/speech |
| Потокова мова (20 тис. символів) | Ні, використовуйте REST | POST /v1/audio/stream |
| Потокова з таймстампами | Ні, використовуйте REST | POST /v1/audio/stream/with-timestamps |
| Переклад | Так (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Експорт файлів | Так (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Архівування / відновлення | Так (is_archived на speechdash_update_document) | PUT /v1/documents/{document_id} |
| Перевірка стану | Ні | GET /health |
| JSON OpenAPI | Ресурс speechdash://openapi | GET /v1/openapi.json |
Рахунок
Синтез мови 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
| Змінна | Призначення |
|---|---|
SPEECHDASH_API_KEY | Необхідний для stdio; опціональний на локальному HTTP сервері, якщо клієнти відправляють Authorization: Bearer |
SPEECHDASH_API_BASE | Базова URL API (за замовчуванням https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (за замовчуванням) або http |
MCP_HOST | Хост для зв’язку HTTP (за замовчуванням 127.0.0.1) |
MCP_PORT | Порт HTTP (за замовчуванням 3010) |
Документація, доступна для агентів
Машинно-читабельна продуктова інформація для штучних crawlerів: