שרת MCP

חיבור ל-Cursor, Claude Desktop, ChatGPT או לקליינטים MCP אחרים באמצעות API הציבורי של Speechdash.

Speechdash כוללת שרת רשמי של Model Context Protocol (MCP) שמגדיר את הספרייה והסינתזת הדיבור ככלים. השתמש בו כאשר אתה רוצה שעוזר AI יספק רשימה של מסמכים (כולל תעתיקים סופיים), יוצר ייבואי טקסט, יתרגם או ייצא, יבדוק את תיקיית הכסף שלך או יסנתז דיבור ללא כתיבת קריאות HTTP בעצמך. הספרייה כוללת תעתיקים סופיים (source=transcription). אין כלי לתעתיקים: קרא לעבודות אלה באמצעות הכלים למסמכים. MCP לא מתחיל עבודות תעתיק קול.

אתה יכול גם לקרוא את ה-API הציבורי REST ישירות באמצעות curl או לקליינט שלך. MCP ו-HTTP משתפים את אותו קצה קישור, נקודות אשראי ומעכבי קצב שם קיימים שני פנים.

מגיע (עמוד זה): שרת MCP הרשמי של Speechdash ב-mcp.speechdash.com מאפשר לעוזרים חיצוניים לקרוא ל-ספריית Speechdash שלך.

יציאה (הגדרות האפליקציה): הגדרות → חיבורים מחבר שרתי MCP של גוף שלישי לאזור השיחה בתוך האפליקציה כאשר תכונה זו מופעלת. זה אינו שרת MCP הציבורי של Speechdash.

אל תגדיר את SPEECHDASH_API_KEY על גרסת ה-mcp.speechdash.com הציבורית. כל לקוח חייב להתאמת באמצעות OAuth או מפתח אישי sh_live_… ב-Authorization header.

לפני שתחיל

יצר מפתח API תחת הגדרות → API באפליקציה עבור Cursor, Claude Desktop, ולקליינטים אחרים שמקבלים מפתחות נושאים. MCP משתמש במפתחות sh_live_… אותם משתמשים גם ב-HTTP. ראה תצוגת API.

ChatGPT (OAuth)

ChatGPT דורש OAuth 2.1 + PKCE, ולא מפתח API שנכנס ישירות. אל תכנס מפתח API באזור הגדרות החיבור של ChatGPT.

MCP URL: https://mcp.speechdash.com/mcp
OAuth resource: https://mcp.speechdash.com
Protected resource metadata: https://mcp.speechdash.com/.well-known/oauth-protected-resource
Authorization server (discovery): https://speechdash.com/.well-known/oauth-authorization-server

התחבר עם חשבון Speechdash שלך כאשר ChatGPT יבקש ממך. טוקנים אישור יוצרים על ידי האפליקציה ומאושרים על ידי שרת MCP והאפיק הציבורי.

תהליך התקנה: Agents hub.

כלי

כל כלי MCP מתאים לאפיק REST אחד:

כלי 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`

השרת גם מגדיר את המשאב speechdash://openapi (JSON OpenAPI חי).

MCP לעומת REST יכולות

תכונה	MCP	REST
צילום רגעי של חשבון	כן (`speechdash_get_account`)	`GET /v1/me`
CRUD למסמכים (ספרייה, כולל תעתיקים סופיים)	כן	כן
התחלת עבודות תעתיק קול	לא (רק באפליקציה)	לא (רק באפליקציה)
סינתזת דיבור שאינה זורמת (5k תווים)	כן	`POST /v1/audio/speech`
סינתזת דיבור זורמת (20k תווים)	לא, השתמש ב-REST	`POST /v1/audio/stream`
זרימה עם תוויות זמן	לא, השתמש ב-REST	`POST /v1/audio/stream/with-timestamps`
תרגום	כן (`speechdash_translate_document`)	`POST /v1/documents/{document_id}/translate`
ייצוא קובץ	כן (`speechdash_export_document`)	`GET /v1/documents/{document_id}/export`
ארכיון / השבתה	כן (`is_archived` ב-`speechdash_update_document`)	`PUT /v1/documents/{document_id}`
בדיקת בריאות	לא	`GET /health`
JSON OpenAPI	משאב `speechdash://openapi`	`GET /v1/openapi.json`

חשבון

סינתזת הדיבור של MCP מחזירה את אותו תיקית אשראי כמו REST ונגינת ענן באפליקציה. יצירת מסמכים באמצעות MCP לא משתמש באשראי, אך היא מונה את אותו קפאון יומי למסמכים כמו באפליקציה ו-BAPI REST. קרא ל-speechdash_get_account לפני הסינתזה כדי לבדוק את הסaldo שלך.

speechdash_translate_document מחזירה את אותה תיקית אשראי כמו ייצוא MP3 (0.5 אשראי לכל 30 שניות של דיבור מוערך שמתחילים). speechdash_export_document יכול להחזיר שדות קובץ גדולים: עדיף txt, csv, או srt ב-MCP. pdf ו-docx הם בינארים. speechdash_update_document מקבל visibility עבור דף השיתוף הלא רשמי ו-is_archived כדי לארכיון או להחזיר.

Cursor או Claude Desktop

השתמש ב-Streamable HTTP נגד השרת MCP המארח עם מפתח 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

קצה קישור ברירת מחדל: http://127.0.0.1:3010/mcp

משתנה	מטרה
`SPEECHDASH_API_KEY`	דרוש ל-stdio; אופציונלי בשרת HTTP מקומי אם הלקליינטים שולחים `Authorization: Bearer`
`SPEECHDASH_API_BASE`	קצה API (ברירת מחדל `https://api.speechdash.com/v1`)
`MCP_TRANSPORT`	`stdio` (ברירת מחדל) או `http`
`MCP_HOST`	שרת חיבור HTTP (ברירת מחדל `127.0.0.1`)
`MCP_PORT`	נמל HTTP (ברירת מחדל `3010`)

לפני שתחיל

ChatGPT (OAuth)

כלי

MCP לעומת REST יכולות

חשבון

Cursor או Claude Desktop

פיתוח מקומי (קובץ גיט)

Streamable HTTP (מקומי)

מסמכים קריאים לאגנטים

Agents hub (אתר)

agents.md

JSON OpenAPI

דוגמאות בגיטהאב

קשורים

תצוגת API

מפתחות API ומק

תיקית אשראי

חיבורים (הגדרות אפליקציה)

On this page