Server MCP
Connetti Cursor, Claude Desktop, ChatGPT o altri client MCP all'API pubblica di Speechdash.
Speechdash include un server ufficiale del Model Context Protocol (MCP) che espone la libreria e la sintesi vocale come strumenti. Utilizzalo quando vuoi che un assistente AI elenchi i documenti (compresi i trascritti completi), crei importazioni di testo, traduca o esporti, verifichi il tuo portafoglio o sintetizzi il discorso senza scrivere chiamate HTTP da solo. La libreria include i trascritti completati (source=transcription). Non esiste uno strumento per i trascritti: leggi quei lavori con gli strumenti documenti. MCP non avvia lavori di trascrizione audio.
Puoi anche chiamare direttamente l'API REST pubblica con curl o il tuo client personale. MCP e HTTP condividono gli stessi endpoint, crediti e limiti di velocità dove entrambi gli strati esistono.
Inbound (questa pagina): Il server MCP ufficiale di Speechdash su mcp.speechdash.com permette agli assistenti esterni di chiamare la tua libreria Speechdash.
Outbound (impostazioni app): Impostazioni → Connettori collega i server MCP di terze parti all'interfaccia chat in-app quando questa funzionalità è abilitata. Questo non è il server MCP pubblico di Speechdash.
Non impostare mai SPEECHDASH_API_KEY sulla distribuzione pubblica di mcp.speechdash.com. Ogni client deve autenticarsi tramite OAuth o una chiave personale sh_live_… nella intestazione Authorization.
Prima di iniziare
Crea una chiave API sotto Impostazioni → API nell'app per Cursor, Claude Desktop e altri client che accettano chiavi di tipo bearer. MCP utilizza le stesse chiavi sh_live_… dell'HTTP. Vedi Panoramica API.
ChatGPT (OAuth)
ChatGPT richiede OAuth 2.1 + PKCE, non una chiave API incollata. Non inserire una chiave API nell'interfaccia del connettore ChatGPT.
- URL MCP:
https://mcp.speechdash.com/mcp - Risorsa OAuth:
https://mcp.speechdash.com - Metadati risorsa protetta:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Autorità di autenticazione (discovery):
https://speechdash.com/.well-known/oauth-authorization-server
Effettua l'accesso con il tuo account Speechdash quando ChatGPT ti chiede. I token di accesso vengono coniati dall'app e accettati dal server MCP e dall'API pubblica.
Guida alla configurazione: Agents hub.
Strumenti
Ogni strumento MCP corrisponde a un endpoint REST:
| Strumento 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 |
Il server espone inoltre la risorsa speechdash://openapi (JSON OpenAPI live).
MCP vs capacità REST
| Funzionalità | MCP | REST |
|---|---|---|
| Snapshots dell'account | Sì (speechdash_get_account) | GET /v1/me |
| CRUD documenti (libreria, inclusi trascritti completati) | Sì | Sì |
| Avvio lavori di trascrizione audio | No (solo app) | No (solo app) |
| Sintesi vocale non in streaming (5k caratteri) | Sì | POST /v1/audio/speech |
| Sintesi vocale in streaming (20k caratteri) | No, usa REST | POST /v1/audio/stream |
| Sintesi vocale in streaming con timestamp | No, usa REST | POST /v1/audio/stream/with-timestamps |
| Traduzione | Sì (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Esportazione file | Sì (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Archiviazione / ripristino | Sì (is_archived su speechdash_update_document) | PUT /v1/documents/{document_id} |
| Controllo salute | No | GET /health |
| JSON OpenAPI | Risorsa speechdash://openapi | GET /v1/openapi.json |
Fatturazione
La sintesi vocale MCP addebita lo stesso portafoglio crediti di REST e riproduzione cloud nell'app. La creazione di documenti tramite MCP non consuma crediti, ma viene conteggiata all'interno dello stesso limite giornaliero di documenti dell'app e dell'API REST. Chiamare speechdash_get_account prima della sintesi per controllare il saldo.
speechdash_translate_document addebita lo stesso portafoglio crediti dell'esportazione MP3 (0.5 crediti per ogni 30 secondi di discorso stimato). speechdash_export_document può restituire byte di file grandi: preferisci txt, csv o srt in MCP. pdf e docx sono binari. speechdash_update_document accetta visibility per la pagina di condivisione non elencata e is_archived per archiviare o ripristinare.
Cursor o Claude Desktop
Utilizza Streamable HTTP contro il server MCP ospitato con la tua chiave API personale. Esempio .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_your_key_here"
}
}
}
}Crea la chiave sotto Impostazioni → API nell'app.
Sviluppo locale (clonazione del repository)
Se lavori da una clonazione del repository Speechdash:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpOpzionale: punta a una API locale con SPEECHDASH_API_BASE=http://localhost:3003/v1 mentre bun dev:api è in esecuzione.
Streamable HTTP (locale)
Per i client MCP HTTP durante lo sviluppo locale:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpEndpoint predefinito: http://127.0.0.1:3010/mcp
| Variabile | Scopo |
|---|---|
SPEECHDASH_API_KEY | Richiesto per stdio; opzionale su un server HTTP locale se i client inviano Authorization: Bearer |
SPEECHDASH_API_BASE | URL base dell'API (predefinito https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (predefinito) o http |
MCP_HOST | Host di binding HTTP (predefinito 127.0.0.1) |
MCP_PORT | Porta HTTP (predefinito 3010) |
Documenti leggibili dagli agenti
Contesto del prodotto leggibile dalle macchine per i crawler AI: