التوثيق / إعداد MCP

الأدوات

خادم MCP لفيديوهات الشرح

يتيح خادم MCP من Chasca لـClaude أو Cursor أو أي عميل يدعم بروتوكول Model Context Protocol أن ينشئ فيديوهات الشرح ويغيّرها نيابةً عنك، وأنت منهمك في أي عمل تقوم به.

عنوان URL الأساسي https://app.trychasca.com/api

اربط Chasca بـ Claude أو ChatGPT

أضف Chasca موصِّلًا (connector) وسجّل الدخول: لا شيء لتثبيته ولا حاجة إلى مفتاح API. يعمل في كل الخطط، وتُحتسب الفيديوهات كما في التطبيق (فيديوهاتك المجانية أولًا، ثم دقائق خطتك).

نص
https://app.trychasca.com/mcp
  • Claude (claude.ai وClaude Desktop، في كل خطط Claude): افتح Customize → Connectors، ثم Add → Custom → Web. الصق العنوان، وتابِع، ثم سجّل الدخول إلى Chasca.
  • Claude Code: شغّل الأمر أدناه، ثم /mcp لتسجيل الدخول.
  • ChatGPT: يمكن لمساحات عمل Business وEnterprise إضافته خادمَ MCP مخصّصًا. ويعمل بالطريقة نفسها أي عميل MCP آخر يدعم الخوادم البعيدة وOAuth.
الطرفية
claude mcp add --transport http chasca https://app.trychasca.com/mcp

لفصل أي مساعد، افتح Settings → API and MCP في التطبيق.

على جهازك، بمفتاح API

خادم MCP صغير من نوع stdio، منشور على npm باسم @chasca/mcp، ويعمل على جهازك باستخدام Node 20 أو أحدث. ويتصل بواجهة API في Chasca باستخدام مفتاحك، لذا يظهر كل ما يفعله الوكيل في حسابك (موسومًا بأنه أُنشئ عبر MCP)، ويُعامَل معاملة أي استدعاء لواجهة API: يتطلب خطة Plus أو أعلى، وتُحتسب الدقائق مضروبةً في 2.

  • CHASCA_API_KEY: مطلوب. أنشئ مفتاحًا في التطبيق من Settings → API keys.
  • CHASCA_API_URL: اختياري، وقيمته الافتراضية https://app.trychasca.com/api.

Claude Code

سجّل الخادم مرة واحدة:

الطرفية
claude mcp add chasca \
  -e CHASCA_API_URL=https://app.trychasca.com/api \
  -e CHASCA_API_KEY=chk_live_... \
  -- npx -y @chasca/mcp

أضف --scope user لإتاحته في كل مشاريعك، وتحقق منه بالأمر claude mcp list أو بالأمر /mcp داخل Claude Code.

Claude Desktop

أضف Chasca إلى claude_desktop_config.json (على macOS في ~/Library/Application Support/Claude/، وعلى Windows في %APPDATA%\Claude\)، ثم أعد تشغيل Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "chasca": {
      "command": "npx",
      "args": ["-y", "@chasca/mcp"],
      "env": {
        "CHASCA_API_URL": "https://app.trychasca.com/api",
        "CHASCA_API_KEY": "chk_live_..."
      }
    }
  }
}

إذا لم يعثر Claude Desktop على npx، فضع مساره الكامل قيمةً لـcommand، ويُظهره الأمر where npx على Windows أو which npx على macOS.

Cursor وغيره من العملاء

يعمل أي عميل يدعم MCP عبر stdio بالطريقة نفسها: شغّل npx -y @chasca/mcp بعد ضبط CHASCA_API_KEY. وفي Cursor، أضف إدخال mcpServers نفسه إلى .cursor/mcp.json في مشروعك (أو إلى ~/.cursor/mcp.json لكل المشاريع).

الأدوات

أدوات Chasca MCP ومدخلاتها وما تفعله كل منها
الأداة المدخلات ما تفعله
chasca_generate_explainer input, length, aspect, voice, language, preset, wait يُنشئ فيديو من موضوع أو سؤال أو مستند كامل. يُرجع السجل في قائمة الانتظار، أو ينتظر حتى يجهز الفيديو إذا كانت قيمة wait هي true.
chasca_get_explainer id الحالة والمرحلة والتقدم؛ ورابط الفيديو بعد أن يجهز؛ ومخطط المشاهد القابل للتعديل وكل الإصدارات.
chasca_change_explainer id, change, wait يغيّر شيئًا واحدًا، ويُبقي الباقي كما كان تمامًا. فالترجمة النصية وأسلوب السبورة والموسيقى والعلامة المائية والشعار وسطر التعريف تصنع إصدارًا جديدًا مجانيًا؛ واختيار صوت جديد أو نسبة أبعاد جديدة يصنع فيديو منفصلًا من النص والرسوم نفسها، يُحتسب كأي فيديو جديد.
chasca_list_explainers limit أحدث فيديوهاتك، الأحدث أولًا، مع ملخص للحالة في سطر واحد.
chasca_list_voices language كل الرواة، مع نبرة كل منهم ومعاينة لصوته.

يجري الإنشاء في الخلفية. فإما أن يستعلم الوكلاء دوريًا عبر chasca_get_explainer، أو يمرّروا wait: true لينتظروا حتى يجهز الفيديو. وتعود الأخطاء مع تلميح واضح للوكيل، مثل طريقة إصلاح مفتاح مفقود أو متى يعيد المحاولة.

أمثلة لما يمكنك طلبه

  • «اصنع فيديو شرح عموديًا مدته دقيقة واحدة عن طريقة عمل سياسة الاسترداد لدينا، بناءً على نص السياسة المرفق.»
  • «حوّل ملف README هذا إلى فيديو شرح مدته دقيقتان بأسلوب المخطط الهندسي، بصوت Atlas.»
  • «اصنع نسخة عمودية من آخر فيديو صنعته بـChasca، لأنشرها على Reels.»
  • «ما الأصوات الإسبانية المناسبة للتعليق الصوتي لجمهور المكسيك؟ استخدم أحدها لإعادة صنع فيديو الأمس بالإسبانية.»