Δημιουργός MCP (Server)

Ο Speechdash παρέχει επίσημο server για το Model Context Protocol (MCP), το οποίο εκθέτει τη βιβλιοθήκη και τη σύνθεση ομιλίας ως εργαλεία. Χρησιμοποιήστε το όταν θέλετε ένας βοηθός AI να καταχωρίσει έγγραφα (συμπεριλαμβανομένων των τελειωμένων μεταγραφών), να δημιουργήσει εισαγωγές κειμένου, να μεταφράσει ή να εξαγάγει, να ελέγξει το πορτοφόλι σας ή να συνθέσει ομιλία χωρίς να γράφετε HTTP κλήσεις μόνοι σας. Η βιβλιοθήκη περιλαμβάνει τελειωμένες μεταγραφές (source=transcription). Δεν υπάρχει εργαλείο μεταγραφής: διαβάστε αυτές τις εργασίες με τα εργαλεία εγγράφων. Το MCP δεν ξεκινά εργασίες μεταγραφής ήχου.

Μπορείτε επίσης να κάνετε απευθείας κλήσεις στην δημόσια REST API με curl ή τον δικό σας πελάτη. Το MCP και το HTTP μοιράζονται τα ίδια endpoints, τα κέρδη και τα όρια ρυθμών όπου και οι δύο επιφάνειες υπάρχουν.

Πριν ξεκινήσετε

Δημιουργήστε ένα κλειδί API κάτω από Ρυθμίσεις → API στην εφαρμογή για το Cursor, το Claude Desktop και άλλα προγράμματα που αποδέχονται κλειδιά εγγύησης. Το MCP χρησιμοποιεί τα ίδια sh_live_… κλειδιά με το HTTP. Δείτε περίληψη API.

ChatGPT (OAuth)

Το ChatGPT απαιτεί OAuth 2.1 + PKCE, όχι ένα επικολλημένο κλειδί API. Μη εισάγετε κλειδί API στην UI συνδέσμου του ChatGPT.

1. MCP URL: https://mcp.speechdash.com/mcp
2. OAuth πόρος: https://mcp.speechdash.com
3. Μεταδεδομένα προστατευμένου πόρου: https://mcp.speechdash.com/.well-known/oauth-protected-resource
4. Σέρβερ εξουσιοδότησης (αποκάλυψη): https://speechdash.com/.well-known/oauth-authorization-server

Συνδεθείτε με το λογαριασμό σας Speechdash όταν το ChatGPT σας ζητήσει. Τα tokens εξουσιοδότησης δημιουργούνται από την εφαρμογή και αποδέχονται από τον MCP server και τη δημόσια API.

Οδηγός ρύθμισης: Agents hub.

Εργαλεία

Κάθε εργαλείο MCP αντιστοιχεί σε ένα endpoint REST:

Ο server εκθέτει επίσης τον πόρο speechdash://openapi (ζωντανό JSON OpenAPI).

MCP vs REST δυνατότητες

Λογιστική

Η MCP σύνθεση ομιλίας χρεώνει το ίδιο πορτοφόλι κερδών με το REST και την αναπαραγωγή στο cloud στην εφαρμογή. Η δημιουργία εγγράφων μέσω MCP δεν καταναλώνει κέρδη, αλλά υπολογίζεται στο ίδιο ημερήσιο όριο εγγράφων με την εφαρμογή και την REST API. Καλέστε το speechdash_get_account πριν από τη σύνθεση για να ελέγξετε την ισορροπία σας.

Το speechdash_translate_document χρεώνει το ίδιο πορτοφόλι κερδών με την εξαγωγή MP3 (0.5 κέρδη για κάθε ξεκινούμενο 30 δευτερόλεπτα εκτιμώμενης ομιλίας). Το speechdash_export_document μπορεί να επιστρέψει μεγάλα bytes αρχείου: προτιμήστε txt, csv, ή srt στο MCP. Τα pdf και docx είναι δυαδικά. Το speechdash_update_document αποδέχεται visibility για την σελίδα μοιρασμού που δεν είναι καταχωρημένη και is_archived για να αρχειοθετήσετε ή να αποκαταστήσετε.

Cursor ή Claude Desktop

Χρησιμοποιήστε Streamable HTTP εναντίον του φιλοξενημένου MCP server με το προσωπικό σας κλειδί API. Παράδειγμα .cursor/mcp.json:

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

Δημιουργήστε το κλειδί κάτω από Ρυθμίσεις → API στην εφαρμογή.

Τοπική ανάπτυξη (αντιγραφή αποθετηρίου)

Αν εργάζεστε από μια αντίγραφη του αποθετηρίου Speechdash:

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

Επιλογή: δείτε σε τοπική API με SPEECHDASH_API_BASE=http://localhost:3003/v1 ενώ τρέχει bun dev:api.

Streamable HTTP (τοπική)

Για MCP πελάτες HTTP κατά την τοπική ανάπτυξη:

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

Προεπιλεγμένο endpoint: http://127.0.0.1:3010/mcp

Εγγράφα που διαβάζονται από agent

Μηχανοδιαβιβάσιμη προϊοντική περιγραφή για AI crawlers:

Σχετικά