خادم MCP

قم بتوصيل Cursor، أو Claude Desktop، أو ChatGPT، أو أي عميل آخر لمبادرة MCP مع API العامة لSpeechdash.

يقدم Speechdash خادمًا رسميًا لمبادرة Model Context Protocol (MCP) يعرض المكتبة والتوليف الصوتي كأدوات. استخدمه عندما تريد مساعدة ذكاء اصطناعي لتقسيم المستندات (بما في ذلك النسخ النهائية للمقاطع الصوتية)، أو إنشاء استيراد نصي، أو الترجمة أو التصدير، أو التحقق من محفظتك، أو توليف الصوت دون كتابة طلبات 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.

قبل البدء

إنشاء مفتاح API تحت إعدادات → API في التطبيق لCursor، وClaude Desktop، وغيرها من العميلات التي تقبل مفاتيح الترخيص. MCP يستخدم نفس مفاتيح sh_live_… مثل HTTP. انظر ملخص API.

ChatGPT (OAuth)

يحتاج ChatGPT إلى OAuth 2.1 + PKCE وليس مفتاح API مقصود. لا أدخل مفتاح API في واجهة وصلات ChatGPT.

موقع MCP: https://mcp.speechdash.com/mcp
مورد OAuth: https://mcp.speechdash.com
بيانات الموارد المحمية: https://mcp.speechdash.com/.well-known/oauth-protected-resource
مقدم الخدمة (اكتشاف): https://speechdash.com/.well-known/oauth-authorization-server

تسجيل الدخول باستخدام حساب Speechdash عندما يطلب ChatGPT منك ذلك. يتم صك الرموز الوصولية بواسطة التطبيق وتقبلها خادم MCP والAPI العام.

مرشد الإعداد: مكتبة الوكالات.

الأدوات

تخضع كل أداة 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`
إدارة المستندات (المكتبة، بما في ذلك النسخ النهائية للمقاطع الصوتية)	نعم	نعم
بدء مهام تسجيل الصوت	لا (التطبيق فقط)	لا (التطبيق فقط)
الصوت غير المتدفق (5k حرف)	نعم	`POST /v1/audio/speech`
الصوت المتدفق (20k حرف)	لا، استخدم REST	`POST /v1/audio/stream`
الصوت المتدفق معestamps	لا، استخدم 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 لا يستهلك ائتمانًا، ولكنها تحسب ضمن نفس الحد اليومي للمستندات مثل التطبيق وAPI REST. اتصل بـ speechdash_get_account قبل توليف الصوت للتحقق من رصيدك.

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`	عنوان URL ل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.md

JSON OpenAPI

أمثلة على GitHub

ذات الصلة

ملخص API

مفاتيح API ومبادرة MCP (دليل المستخدم)

محفظة الائتمان

الوصلات (إعدادات التطبيق)

On this page