MCP sunucusu
Cursor, Claude Masaüstü, ChatGPT veya diğer MCP istemcilerini Speechdash'ın kamusal API'sine bağlayın.
Speechdash, Model Context Protocol (MCP) sunucusunu resmi olarak sağlar ve kütüphaneyi ve konuşma sentezini araçlar olarak sunar. Bu sunucuyu kullanmak istediğinizde, AI asistanınızın belgeleri (bitmiş transkripsiyonları da dahil) listelemesini, metin yüklemelerini oluşturmasını, çevirmesini veya ihraç etmesini, cüzdanınızı kontrol etmesini veya HTTP çağrıları yazmadan konuşma sentezini yapmasını sağlayın. Kütüphane bitmiş transkripsiyonları (source=transcription) içerir. Transkripsiyon araçları yoktur: bu işleri belge araçlarıyla okuyun. MCP, sesli transkripsiyon işlemlerini başlatmaz.
Kamusal REST API'sini doğrudan curl veya kendi istemcinizle çağırmanız da mümkündür: mcp.speechdash.com/mcp. MCP ve HTTP aynı uç noktaları, kredileri ve oran sınırlamalarını paylaşır.
Gelen (bu sayfa): Speechdash'ın resmi MCP'si mcp.speechdash.com dışarıdan gelen asistanların sizin Speechdash kütüphanenizi çağırmasına izin verir.
Giden (uygulama ayarları): Ayarlar → Bağlantılar üçüncü taraf MCP sunucularını, bu özelliğin etkinleştirildiği durumda, uygulamadaki sohbet UI'sine ekler. Bu Speechdash'ın kamusal MCP sunucusu değildir.
Kamusal mcp.speechdash.com sürümünde SPEECHDASH_API_KEY ayarını asla ayarlayın. Her istemci OAuth veya kişisel sh_live_… anahtarını Authorization başlığında kimlik doğrulamalıdır.
Başlamadan önce
Cursor, Claude Masaüstü ve diğer anahtarları kabul eden istemciler için uygulamada Ayarlar → API altında bir API anahtarı oluşturun. MCP, HTTP ile aynı sh_live_… anahtarlarını kullanır. Detaylar için API genel bakış sayfasını inceleyin.
ChatGPT (OAuth)
ChatGPT, OAuth 2.1 + PKCE gerektirir, değil bir yapıştırılan API anahtarı. ChatGPT bağlantı UI'sine API anahtarı girmeyin.
- MCP URL:
https://mcp.speechdash.com/mcp - OAuth kaynak:
https://mcp.speechdash.com - Korunan kaynak metaveri:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Yetkilendirme sunucusu (keşif):
https://speechdash.com/.well-known/oauth-authorization-server
ChatGPT sizi Speechdash hesabınızla oturum açmaya davet edecektir. Yetkilendirme tokenleri uygulamadan üretilir ve MCP sunucusu ile kamusal API tarafından kabul edilir.
Kurulum rehberi: Agents hub.
Araçlar
Her MCP aracı bir REST uç noktasına karşılık gelir:
| MCP Aracı | 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 |
Sunucu ayrıca speechdash://openapi kaynağını (canlı OpenAPI JSON) da sunar.
MCP vs REST yetenekleri
| Özellik | MCP | REST |
|---|---|---|
| Hesap özeti | Evet (speechdash_get_account) | GET /v1/me |
| Belge CRUD (kütüphane, bitmiş transkripsiyonlar dahil) | Evet | Evet |
| Sesli transkripsiyon işlemleri başlat | Hayır (uygulama yalnız) | Hayır (uygulama yalnız) |
| Akış dışı konuşma (5k karakter) | Evet | POST /v1/audio/speech |
| Akış içi konuşma (20k karakter) | Hayır, REST kullanın | POST /v1/audio/stream |
| Zaman damgalı akış | Hayır, REST kullanın | POST /v1/audio/stream/with-timestamps |
| Çeviri | Evet (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Dosya ihraç | Evet (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Arşivleme / geri yükleme | Evet (is_archived speechdash_update_documentta) | PUT /v1/documents/{document_id} |
| Sağlık kontrolü | Hayır | GET /health |
| OpenAPI JSON | speechdash://openapi kaynağı | GET /v1/openapi.json |
Faturalandırma
MCP konuşma sentezi, REST ve uygulamadaki bulut oynatımının aynı kredi cüzdanını tahsis eder. MCP üzerinden belge oluşturmak kredi harcamaz, ancak günlük belge sınırına katkıda bulunur. Sentezden önce speechdash_get_account çağırarak bakiyenizi kontrol edin.
speechdash_translate_document MP3 ihraç için aynı kredi cüzdanını kullanır (30 saniyelik tahmini konuşma başına 0.5 kredi). speechdash_export_document büyük dosya byte'ları döndürebilir: MCP'de txt, csv, veya srt tercih edin. pdf ve docx ikili dosyadır. speechdash_update_document visibility (liste dışı paylaşım sayfası) ve is_archived (belgeyi arşivle veya geri yükle) kabul eder.
Cursor veya Claude Masaüstü
Hosted MCP sunucusuna Streamable HTTP ile kişisel API anahtarınızla bağlanın. Örnek .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_your_key_here"
}
}
}
}Anahtarı uygulamada Ayarlar → API altında oluşturun.
Yerel geliştirme (depo klonu)
Speechdash deposundan çalışıyorsanız:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpOpsiyonel: bun dev:api çalışırken yerel bir API'ye SPEECHDASH_API_BASE=http://localhost:3003/v1 ile yönlendirin.
Streamable HTTP (yerel)
Yerel geliştirme sırasında HTTP MCP istemcileri için:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpVarsayılan uç nokta: http://127.0.0.1:3010/mcp
| Değişken | Amaç |
|---|---|
SPEECHDASH_API_KEY | Stdio için gerekli; yerel HTTP sunucusunda istemciler Authorization: Bearer gönderdiğinde opsiyonel |
SPEECHDASH_API_BASE | API temeli URL'si (varsayılan https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (varsayılan) veya http |
MCP_HOST | HTTP bağlama hostu (varsayılan 127.0.0.1) |
MCP_PORT | HTTP portu (varsayılan 3010) |