Servidor MCP
Conecta Cursor, Claude Desktop, ChatGPT u otros clientes MCP a la API pública de Speechdash.
Speechdash incluye un servidor oficial de Model Context Protocol (MCP) que expone la biblioteca y la síntesis de voz como herramientas. Úsalo cuando quieras que un asistente de IA liste documentos (incluyendo transcripciones terminadas), cree importaciones de texto, traduzca o exporte, revise su billetera o sintetice voz sin escribir llamadas HTTP por tu cuenta. La biblioteca incluye transcripciones terminadas (source=transcription). No hay una herramienta de transcripción: lee esos trabajos con las herramientas de documentos. MCP no inicia trabajos de transcripción de audio.
También puedes llamar directamente a la API REST pública con curl o tu propio cliente. MCP y HTTP comparten los mismos endpoints, créditos y límites de tasa donde ambas superficies existen.
Entrante (esta página): El MCP oficial de Speechdash en mcp.speechdash.com permite que asistentes externos llamen a tu biblioteca de Speechdash.
Saliente (ajustes de la app): Ajustes → Conectores adjunta servidores MCP de terceros al chat de la interfaz de usuario de la app cuando esa función está habilitada. Esto no es el servidor MCP público de Speechdash.
Nunca configures SPEECHDASH_API_KEY en el despliegue público de mcp.speechdash.com. Cada cliente debe autenticarse con OAuth o una clave personal sh_live_… en el encabezado Authorization.
Antes de empezar
Crea una clave de API bajo Ajustes → API en la app para Cursor, Claude Desktop y otros clientes que acepten claves de tipo bearer. MCP usa las mismas claves sh_live_… que HTTP. Consulta Visión general de la API.
ChatGPT (OAuth)
ChatGPT requiere OAuth 2.1 + PKCE, no una clave de API copiada y pegada. No ingreses una clave de API en la interfaz de conexión de ChatGPT.
- URL de MCP:
https://mcp.speechdash.com/mcp - Recurso OAuth:
https://mcp.speechdash.com - Metadatos de recurso protegido:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Servidor de autorización (descubrimiento):
https://speechdash.com/.well-known/oauth-authorization-server
Inicia sesión con tu cuenta de Speechdash cuando ChatGPT te lo solicite. Los tokens de acceso son creados por la app y aceptados por el servidor MCP y la API pública.
Guía de configuración: Agents hub.
Herramientas
Cada herramienta MCP corresponde a un endpoint REST:
| Herramienta 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 |
El servidor también expone el recurso speechdash://openapi (JSON OpenAPI en vivo).
MCP vs Capacidades REST
| Funcionalidad | MCP | REST |
|---|---|---|
| Resumen de cuenta | Sí (speechdash_get_account) | GET /v1/me |
| CRUD de documentos (biblioteca, incluyendo transcripciones terminadas) | Sí | Sí |
| Iniciar trabajos de transcripción de audio | No (solo app) | No (solo app) |
| Síntesis de voz no en streaming (5k caracteres) | Sí | POST /v1/audio/speech |
| Síntesis de voz en streaming (20k caracteres) | No, usa REST | POST /v1/audio/stream |
| Síntesis de voz en streaming con marcas de tiempo | No, usa REST | POST /v1/audio/stream/with-timestamps |
| Traducción | Sí (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Exportación de archivos | Sí (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Archivar / restaurar | Sí (is_archived en speechdash_update_document) | PUT /v1/documents/{document_id} |
| Verificación de salud | No | GET /health |
| JSON OpenAPI | Recurso speechdash://openapi | GET /v1/openapi.json |
Facturación
La síntesis de voz de MCP consume la misma billetera de créditos que REST y la reproducción en la nube en la app. Crear documentos a través de MCP no gasta créditos, pero sí cuenta hacia el mismo límite diario de documentos que la app y la API REST. Llama a speechdash_get_account antes de la síntesis para verificar tu saldo.
speechdash_translate_document cobra de la misma billetera de créditos que la exportación a MP3 (0.5 créditos por cada 30 segundos estimados de voz iniciados). speechdash_export_document puede devolver bytes de archivos grandes: prefiera txt, csv o srt en MCP. pdf y docx son binarios. speechdash_update_document acepta visibility para la página de compartir no lista y is_archived para archivar o restaurar.
Cursor o Claude Desktop
Usa Streamable HTTP contra el servidor MCP alojado con tu clave de API personal. Ejemplo .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_your_key_here"
}
}
}
}Crea la clave bajo Ajustes → API en la app.
Desarrollo local (clonación del repositorio)
Si trabajas desde un clon del repositorio de Speechdash:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpOpcional: apunta a una API local con SPEECHDASH_API_BASE=http://localhost:3003/v1 mientras bun dev:api está en ejecución.
Streamable HTTP (local)
Para clientes MCP HTTP durante el desarrollo local:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpEndpoint por defecto: http://127.0.0.1:3010/mcp
| Variable | Propósito |
|---|---|
SPEECHDASH_API_KEY | Requerido para stdio; opcional en un servidor HTTP local si los clientes envían Authorization: Bearer |
SPEECHDASH_API_BASE | URL base de la API (por defecto https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (por defecto) o http |
MCP_HOST | Host de enlace HTTP (por defecto 127.0.0.1) |
MCP_PORT | Puerto HTTP (por defecto 3010) |
Documentación legible por agentes
Contexto de producto legible por máquinas para rastreadores de IA: