Serveur MCP

Speechdash fournit un serveur officiel du Model Context Protocol (MCP) qui expose la bibliothèque et la synthèse vocale en tant que outils. Utilisez-le lorsque vous souhaitez qu'un assistant IA liste des documents (y compris les transcriptions terminées), crée des imports de texte, traduise ou exporte, vérifie votre portefeuille de crédits ou synthétise la parole sans écrire de requêtes HTTP vous-même. La bibliothèque inclut les transcriptions terminées (source=transcription). Il n'y a pas d'outil de transcription : lisez ces tâches avec les outils de document. MCP ne lance pas de tâches de transcription audio.

Vous pouvez également appeler directement l'API REST publique avec curl ou votre propre client. MCP et HTTP partagent les mêmes points de terminaison, crédits et limites de débit là où les deux interfaces existent.

Avant de commencer

Créez une clé API sous Paramètres → API dans l'application pour Cursor, Claude Desktop et autres clients qui acceptent des clés de type bearer. MCP utilise les mêmes clés sh_live_… que HTTP. Consultez Vue d'ensemble de l'API.

ChatGPT (OAuth)

ChatGPT nécessite OAuth 2.1 + PKCE, et non une clé API collée. Ne saisissez pas de clé API dans l'interface de connexion de ChatGPT.

1. URL MCP : https://mcp.speechdash.com/mcp
2. Ressource OAuth : https://mcp.speechdash.com
3. Métadonnées de la ressource protégée : https://mcp.speechdash.com/.well-known/oauth-protected-resource
4. Serveur d'autorisation (découverte) : https://speechdash.com/.well-known/oauth-authorization-server

Connectez-vous avec votre compte Speechdash lorsque ChatGPT vous le demande. Les jetons d'accès sont émis par l'application et acceptés par le serveur MCP et l'API publique.

Guide de configuration : Agents hub.

Outils

Chaque outil MCP correspond à un point de terminaison REST :

Le serveur expose également la ressource speechdash://openapi (JSON OpenAPI en direct).

Capacités MCP vs REST

Facturation

La synthèse vocale MCP prélève les mêmes crédits que REST et la lecture en cloud dans l'application. La création de documents via MCP ne consomme pas de crédits, mais elle est comptabilisée dans la même limite quotidienne de documents que l'application et l'API REST. Appelez speechdash_get_account avant la synthèse pour vérifier votre solde.

speechdash_translate_document facture le même portefeuille de crédits que l'export en MP3 (0,5 crédits d'affichage / 1 centime de portefeuille par 30 secondes estimées de parole entamées). Les horodatages (**0:34**, **SPEAKER_00** · 0:34, (0:34)) sont recopiés tels quels comme références de lecture. speechdash_export_document peut retourner des octets de fichiers volumineux : privilégiez txt, csv ou srt dans MCP. pdf et docx sont binaires. speechdash_update_document accepte visibility pour la page de partage non répertoriée et is_archived pour archiver ou restaurer.

Cursor ou Claude Desktop

Utilisez Streamable HTTP contre le serveur MCP hébergé avec votre clé API personnelle. Exemple de fichier .cursor/mcp.json :

{
  "mcpServers": {
    "speechdash": {
      "url": "https://mcp.speechdash.com/mcp",
      "headers": {
        "Authorization": "Bearer sh_live_votre_cle_ici"
      }
    }
  }
}

Créez la clé sous Paramètres → API dans l'application.

Développement local (clonage du dépôt)

Si vous travaillez à partir d'un clone du dépôt Speechdash :

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp

Optionnel : pointez vers une API locale avec SPEECHDASH_API_BASE=http://localhost:3003/v1 pendant que bun dev:api est en cours d'exécution.

Streamable HTTP (local)

Pour les clients MCP HTTP pendant le développement local :

export SPEECHDASH_API_KEY="sh_live_..."
bun run dev:mcp:http

Point de terminaison par défaut : http://127.0.0.1:3010/mcp

Documentation lisible par les agents

Contexte produit lisible par machine pour les crawlers IA :

Liens connexes