Servidor MCP
Conecte o Cursor, o Claude Desktop, ChatGPT ou outros clientes MCP à API pública do Speechdash.
O Speechdash inclui um servidor oficial do Model Context Protocol (MCP) que expõe a biblioteca e a síntese de fala como ferramentas. Use-o quando quiser que um assistente de IA liste documentos (incluindo transcrições concluídas), crie importações de texto, traduza ou exporte, verifique sua carteira ou sintetize fala sem escrever chamadas HTTP manualmente. A biblioteca inclui transcrições concluídas (source=transcription). Não há uma ferramenta de transcrição: leia esses trabalhos com as ferramentas de documentos. O MCP não inicia trabalhos de transcrição de áudio.
Você também pode chamar diretamente a API REST pública usando curl ou seu próprio cliente. O MCP e o HTTP compartilham os mesmos endpoints, créditos e limites de taxa onde ambas as interfaces existem.
Entrante (esta página): O MCP oficial do Speechdash em mcp.speechdash.com permite que assistentes externos chamem sua biblioteca do Speechdash.
Saída (configurações do app): Configurações → Conectores anexa servidores MCP de terceiros à interface de chat embutida quando essa funcionalidade estiver habilitada. Isso não é o servidor MCP público do Speechdash.
Nunca defina SPEECHDASH_API_KEY na implantação pública do mcp.speechdash.com. Cada cliente deve autenticar-se com OAuth ou uma chave pessoal sh_live_… no cabeçalho Authorization.
Antes de começar
Crie uma chave de API em Configurações → API no aplicativo para o Cursor, Claude Desktop e outros clientes que aceitam chaves de autenticação. O MCP usa as mesmas chaves sh_live_… que o HTTP. Veja Visão geral da API.
ChatGPT (OAuth)
O ChatGPT requer OAuth 2.1 + PKCE, não uma chave de API colada. Não insira uma chave de API no campo de conectores do ChatGPT.
- URL do MCP:
https://mcp.speechdash.com/mcp - Recurso OAuth:
https://mcp.speechdash.com - Metadados de recurso protegido:
https://mcp.speechdash.com/.well-known/oauth-protected-resource - Servidor de autorização (descoberta):
https://speechdash.com/.well-known/oauth-authorization-server
Faça login com sua conta do Speechdash quando o ChatGPT pedir. Os tokens de acesso são gerados pelo aplicativo e aceitos pelo servidor MCP e pela API pública.
Guia de configuração: Agents hub.
Ferramentas
Cada ferramenta MCP corresponde a um endpoint REST:
| Ferramenta 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 |
O servidor também expõe o recurso speechdash://openapi (JSON OpenAPI em tempo real).
MCP vs Capacidades REST
| Recurso | MCP | REST |
|---|---|---|
| Snapshot da conta | Sim (speechdash_get_account) | GET /v1/me |
| CRUD de documentos (biblioteca, incluindo transcrições concluídas) | Sim | Sim |
| Iniciar trabalhos de transcrição de áudio | Não (apenas app) | Não (apenas app) |
| Síntese de fala não-streaming (5k caracteres) | Sim | POST /v1/audio/speech |
| Síntese de fala em streaming (20k caracteres) | Não, use REST | POST /v1/audio/stream |
| Streaming com timestamps | Não, use REST | POST /v1/audio/stream/with-timestamps |
| Tradução | Sim (speechdash_translate_document) | POST /v1/documents/{document_id}/translate |
| Exportação de arquivos | Sim (speechdash_export_document) | GET /v1/documents/{document_id}/export |
| Arquivar / restaurar | Sim (is_archived em speechdash_update_document) | PUT /v1/documents/{document_id} |
| Verificação de saúde | Não | GET /health |
| JSON OpenAPI | Recurso speechdash://openapi | GET /v1/openapi.json |
Faturamento
A síntese de fala do MCP descontará a mesma carteira de créditos que o REST e a reprodução em nuvem no aplicativo. Criar documentos via MCP não gasta créditos, mas conta para o mesmo limite diário de documentos do aplicativo e da API REST. Chame speechdash_get_account antes da síntese para verificar seu saldo.
speechdash_translate_document cobra da mesma carteira de créditos que a exportação para MP3 (0,5 créditos por cada 30 segundos estimados de fala iniciados). speechdash_export_document pode retornar bytes de arquivos grandes: prefira txt, csv ou srt no MCP. pdf e docx são binários. speechdash_update_document aceita visibility para a página de compartilhamento não listada e is_archived para arquivar ou restaurar.
Cursor ou Claude Desktop
Use o Streamable HTTP contra o servidor MCP hospedado com sua chave de API pessoal. Exemplo .cursor/mcp.json:
{
"mcpServers": {
"speechdash": {
"url": "https://mcp.speechdash.com/mcp",
"headers": {
"Authorization": "Bearer sh_live_sua_chave_aqui"
}
}
}
}Crie a chave em Configurações → API no aplicativo.
Desenvolvimento local (clonar repositório)
Se você trabalha com um clone do repositório do Speechdash:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcpOpcional: aponta para uma API local com SPEECHDASH_API_BASE=http://localhost:3003/v1 enquanto bun dev:api está rodando.
Streamable HTTP (local)
Para clientes MCP HTTP durante o desenvolvimento local:
export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:httpEndpoint padrão: http://127.0.0.1:3010/mcp
| Variável | Propósito |
|---|---|
SPEECHDASH_API_KEY | Obrigatório para stdio; opcional em um servidor HTTP local se os clientes enviarem Authorization: Bearer |
SPEECHDASH_API_BASE | URL base da API (padrão https://api.speechdash.com/v1) |
MCP_TRANSPORT | stdio (padrão) ou http |
MCP_HOST | Host para ligação HTTP (padrão 127.0.0.1) |
MCP_PORT | Porta HTTP (padrão 3010) |
Documentos legíveis por agentes
Contexto de produto legível por máquinas para crawlers de IA: