الوصول البرمجي والأتمتة

نظرة عامة

هناك ثلاث طرق للعمل مع Whisperer دون الواجهة: خادم MCP لعملاء الذكاء الاصطناعي، والخدمات المتصلة للأتمتة الاعتيادية، والتصدير لنقل المحتوى إلى مكان آخر. ولا ينشر Whisperer واجهة REST عامة للاستخدام المفتوح — فالعناوين تحت /v1/ قناة خاصة بين تطبيقاتنا والخادم الخلفي، لا تقدّم وعدًا بالتوافق وقد تتغيّر في أي وقت.

هذا حدّ مقصود لا إغفال. فالواجهة المنشورة يجب أن تظل تعمل سنوات؛ أما MCP فيمنح الوصول نفسه ومعه إدارة الإصدارات وشاشة الموافقة وإلغاء الصلاحيات مدمجة أصلًا.

متى تستخدمها

  • تريد أن يقرأ مساعد ذكاء اصطناعي اجتماعاتك ويتعامل مع مهامك — MCP.
  • تريد إجراءً متكرّرًا («اجتماع جديد ← صف في جدول») — Zapier.
  • تريد المحتوى نفسه في أداة أخرى — التصدير.

خطوة بخطوة

  1. لعملاء الذكاء الاصطناعي اربط عبر MCP: MCP: ربط Claude وChatGPT وCursor. هذا هو المسار البرمجي المدعوم، وهو الوحيد الذي يشمله وعد الاستقرار.
  2. للأتمتة اربط Zapier أو Notion أو Slack أو HubSpot من حسابك، ثم ابنِ السيناريو داخل تلك الخدمة.
  3. للنقل لمرة واحدة صدّر الاجتماع إلى Markdown أو SRT أو VTT أو JSON من صفحته.
  4. لمعلومات المنتج بصيغة يقرأها الحاسوب — مثلًا حين تريد أن يجيب مساعد ذكاء اصطناعي عن أسئلة حول Whisperer نفسه — وجّهه إلى https://whisperer.one/llms.txt أو إلى المجموعة الكاملة https://whisperer.one/llms-full.txt. كلاهما عام ولا يتطلّب مصادقة.

ما هو متاح للعموم

العنوان ما هو
https://whisperer.one/mcp خادم MCP لعملاء الذكاء الاصطناعي الخارجيين
https://whisperer.one/.well-known/oauth-protected-resource حيث يعرف العميل كيفية المصادقة
https://whisperer.one/.well-known/oauth-authorization-server نقاط OAuth والمجالات المدعومة
https://whisperer.one/llms.txt فهرس المنتج لأنظمة الذكاء الاصطناعي
https://whisperer.one/llms-full.txt كل التوثيق العام في ملف واحد
https://whisperer.one/docs/en/<الصفحة>.md أي صفحة من التوثيق الإنجليزي بصيغة Markdown خالصة

الأخطاء الشائعة

  • البناء على /v1/. تلك العناوين داخلية: مغلقة أمام الزواحف، ومخطّطها معطّل في الإنتاج، وتتغيّر دون إشعار.
  • البحث عن مفتاح واجهة برمجية. لا وجود له، لأنه لا توجد واجهة REST عامة. الوصول الخارجي رمز bearer يُصدَر عبر موافقة MCP.
  • انتظار خطافات الويب. الأتمتة الصادرة تمرّ عبر Zapier والخدمات المتصلة، لا عبر خطافات خاصة بنا.

أفضل الممارسات

  • اقرأ نقاط OAuth من وثيقة البيانات الوصفية بدل تثبيتها في الشفرة: فهي منشورة هناك تحديدًا كي تتمكّن من الانتقال دون كسر العملاء.
  • أنشئ اتصالًا مستقلًا لكل تكامل، لتلغي واحدًا دون المساس بالبقية.

مقالات ذات صلة