whollycrypto.
العربية

اتصالات الذكاء الاصطناعي · MCP

اربط مساعدك الذكي.

اعثر على المدفوعات وافحص الأرصدة وأنشئ الفواتير عبر تثبيت Wholly Crypto الخاص بك.

خادمك. ورابط MCP واحد.

مضمّن في إصدار التاجر 5.0.0+. دون خدمة إضافية أو بيئة Node.js أو relay مستضاف. استخدم نطاق API المضبوط للتثبيت، مثل https://api.example.com/mcp.

  1. افتح الإعدادات ← الوصول إلى API. أنشئ مفتاحًا مخصّصًا وحدد المشاريع التي يحتاجها المساعد. ابدأ بالقراءة فقط.
  2. في اتصالات الذكاء الاصطناعي · MCP، فعّل MCP. حدّد مفتاحك واختر قراءة فقط واحفظ.
  3. أضف الرابط الظاهر إلى إعدادات HTTP/MCP البعيدة في مساعدك.
  4. لـOAuth، سجّل الدخول إلى لوحة التاجر. راجع اسم العميل وعنوان العودة وصلاحيات المفتاح، ثم وافق. تبقى Basic Auth وTOTP الحاليتان ساريتين.
{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

استبدل النطاق التوضيحي. تختلف صيغ الإعداد حسب العميل؛ اختر Streamable HTTP، لا أمرًا محليًا أو رابط SSE قديمًا.

اسأل عن مدفوعاتك.

  • «اعرض آخر الفواتير غير المدفوعة في متجري.»
  • «ما الأصول التي يقبلها هذا المتجر؟»
  • «افحص أرصدة المحافظ وتسليمات webhook الفاشلة.»
  • «أنشئ فاتورة بقيمة 25 EUR للطلب 1042.» يتطلب إذن إنشاء الفواتير.

تغطي ثماني أدوات قراءة المشاريع والمتاجر وطرق الدفع والمحافظ والفواتير وسجل التسليم والتحويلات المخزّنة مؤقتًا. تنشئ أداة تاسعة اختيارية الفواتير وفق قواعد API الموجودة.

تتضمن النتائج معرّفات المشاريع والمتاجر. تبقى المبالغ سلاسل نصية عشرية. تحتفظ الأسعار والأرصدة المؤقتة بمعلومات حداثتها؛ التحويل ليس عرض سعر مضمونًا للفاتورة.

اختر ما يصل إليه المساعد.

MCP معطّل افتراضيًا، حتى بعد الترقية. لا تحصل مفاتيح API الموجودة على الوصول تلقائيًا. يرى المساعد المشاريع الموافق عليها فقط؛ وتنطبق قيود IP وحد طلبات REST للمفتاح على MCP أيضًا.

لإنشاء الفواتير، اختر مفتاح قراءة وكتابة و قراءة + إنشاء فواتير. يجب أن يطلب عملاء OAuth mcp:invoice:create، وعليك تحديد السماح بإنشاء الفواتير أيضًا عند الموافقة.

أعد استخدام idempotency_key نفسه وجسم الفاتورة نفسه بعد انتهاء المهلة. مفتاح جديد ينشئ فاتورة جديدة. تبقى قواعد الهامش ونسبة السماح والدفع والرصيد المعتادة سارية.

لا تصدير للمفاتيح أو أدوات لإرسال الأموال. لا يستطيع MCP كشف عبارات الاستعادة أو إرسال الأموال أو تجميعها أو ردها أو إعادة الإشعارات أو تغيير الحسابات والنطاقات والفوترة.

OAuth ومفاتيح Bearer وإلغاء الوصول

تدوم رموز وصول OAuth 15 دقيقة. تتبدل رموز التحديث ويدوم الاتصال حتى 30 يومًا. إعادة استخدام رمز تحديث قديم تلغي الاتصال. لا تُقبل إلا روابط عودة HTTPS أو loopback المسجّلة.

استخدم العملاء المتصلون ← إلغاء لإزالة الوصول. تعطيل MCP يلغي اتصالات OAuth. تغيير المفتاح أو سياسة MCP أو نطاق API الأساسي يتطلب اتصالًا جديدًا.

يمكن للعملاء الداعمين للترويسات المخصّصة استخدام مفتاح API مفعّل لـMCP في Authorization: Bearer …. يحتفظ المفتاح بصلاحيات REST المنفصلة، لذا يُفضّل OAuth للوصول إلى MCP وحده. لا تلصق الأسرار في المحادثات أو الروابط أو الشيفرة المصدرية أبدًا.

وافق فقط على عميل تعرفه. أسماء العملاء غير متحقق منها. يتلقى مزوّد الذكاء الاصطناعي المعلومات التي تسمح له بقراءتها، بما فيها بيانات العملاء التي تعيدها أدوات الفواتير.

إذا فشل الاتصال.

  • 404: فعّل MCP واستخدم مضيف API، لا مضيف اللوحة أو صفحة الدفع.
  • 401: أعد الاتصال عبر OAuth أو تحقق من صلاحية مفتاح Bearer.
  • 403: افحص صلاحيات المفتاح والمشاريع الموافق عليها والأصل وقيود IP المصدر.
  • 405 عند GET: متوقع. تستخدم نقطة الاتصال هذه POST دون حفظ حالة وتعيد استجابات JSON منتهية، دون تدفق SSE مستقل.
  • 429: انتظر المدة في Retry-After. يشترك MCP وREST في حصة المفتاح.
  • لا يمكن إنشاء فواتير: افحص كل صلاحيات الكتابة وحالة المشروع والمتجر وجاهزية الدفع والتحقق من حساب الرصيد.

عطّل التخزين المؤقت والتحديات التفاعلية في Cloudflare لـ /mcp, /mcp/oauth/* ومسارات اكتشاف OAuth. يجب أن تتضمن قوائم IP المسموحة عناوين الخروج الموثقة لخدمة المساعد.

مراجعات البروتوكول المدعومة: 2025-11-25, 2025-06-18 و 2025-03-26. يجب أن يدعم العميل إحداها. راجع مرجع API لكل أداة ونقطة اتصال وصيغة خطأ.

اختر طرق الدفع لكل فاتورة.

استخدم invoice.payment_methods مع chain_slug: "ethereum" و asset_tickers: ["USDC", "USDT"]. تجد أسماء الشبكات المختصرة ورموز الأصول ضمن طرق دفع المتجر أو باستخدام list_payment_methods.

يتجاهل إصدار التاجر 5.4.0+ الخيارات غير النشطة أو غير المقبولة. إن لم توجد مطابقة، تُطبّق افتراضيات المتجر. تحديد الشبكة وحدها يشمل كل أصولها المقبولة النشطة. تحتاج الرموز المختصرة المشتركة إلى معرّفات دقيقة في asset_ids. تبقى فحوصات الجاهزية والأسعار سارية مع أخطاء خاصة بكل شبكة. Lightning منفصل؛ ومصفوفة الاختيار الفارغة غير صالحة. صيغة الطلب ←