ربط وكيل ذكاء اصطناعي

اربط وكيلًا برمجيًا يدعم خوادم MCP البعيدة بالرابط https://app.tgpaycrypto.com/mcp. يمكنه قراءة وثائق الواجهة، وطلب إنشاء تطبيق تاجر، وضبط الويب هوك، والمساعدة في كتابة التكامل. توافق أنت على إنشاء التطبيق في البوت، ويتلقى الوكيل رمزًا محدود الصلاحيات دون أن تنسخه يدويًا. راجع التكامل واختبره قبل قبول مدفوعات حقيقية.

وهذا الرابط هو خادم MCP (Model Context Protocol — الطريقة المعيارية لوصل خدمة بوكيل ذكاء اصطناعي). افتحه في المتصفح ليشرح لك إعداده بنفسه.

الربط

استعمل السطر الذي يناسب أداتك:

وكيل يدعم MCP البعيد — الصق هذا النص:
```
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Crypto Merchant API.
```
ويمكنك أيضًا نسخ نص الإعداد داخل التطبيق تحت المزيد ← واجهة التجار ← ربط وكيل ذكاء اصطناعي.
Claude Code — claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
claude.ai وClaude Desktop — أضف الرابط كموصّل مخصص وفق تعليمات إعداد Claude.
ChatGPT وعملاء MCP الآخرون — أضف الرابط كخادم MCP مخصص إذا كان حسابك ومساحة عملك يتيحان ذلك. في ChatGPT، اتبع تعليمات الإعداد الحالية.

للبدء على الشبكة التجريبية، استخدم https://testnet.tgpaycrypto.com/mcp بدلًا منه. يفتح رابط الموافقة @tgpaycrypto_testnet_bot، وتستخدم الوثائق العنوان الأساسي للشبكة التجريبية.

لا تحتاج إلى رمز API مسبقًا، فالوكيل يحصل على رمزه في الخطوة التالية. إذا كنت قد أنشأت تطبيقًا بنفسك، فأنشئ رمزًا محدود الصلاحيات وامنحه فقط الصلاحيات التي يحتاجها الوكيل، ثم استخدمه للتكامل. احتفظ بالرمز الرئيسي على خادمك. صلاحيات الرمز الذي تسلّمه يدويًا هي التي تحدد ما يستطيع الوكيل فعله.

الموافقة على التطبيق

اطلب من الوكيل إعداد المدفوعات. فيقرأ الوثائق ثم يطلب موافقتك.
يعطيك الوكيل رابط t.me. افتحه — يعرض البوت ما هو مطلوب بالضبط — ثم اضغط ✅ إنشاء التطبيق وإصدار الرمز.
عُد إلى الوكيل ليتمكن من استلام رمزه ومتابعة التكامل. يتطلب إنشاء التطبيق حسابًا مؤهلًا؛ أكمل التحقق إذا طُلب منك.

والرابط يأتيك من وكيلك دائمًا — ولا يرسله البوت من تلقاء نفسه أبدًا: فقبل أن تفتحه لا يعرف البوت عن أي حساب يسأل الوكيل. وكل رابط يعمل مرة واحدة. فإن توقف عن العمل قبل أن تضغطه، فاطلب من الوكيل أن يبدأ من جديد — إذ لا يُنشأ شيء قبل موافقتك.

وإن ضغطت ❌ رفض، فلا يُنشأ شيء كذلك، وينتهي ذلك الطلب — وتغيّر رأيك يعني طلبًا جديدًا من الوكيل.

⚠️ لا توافق إلا على طلب بدأته أنت

طلب الربط هو طلب إنشاء تطبيق على حسابك أنت. فلا توافق عليه إلا إذا كنت قد طلبت للتو من وكيلك أنت إعداد المدفوعات. وإن وصلك رابط بأي طريق آخر — محادثة، أو رسالة محوَّلة، أو «دعم» من مجهول — فارفضه.

الرمز الصادر عبر مسار الموافقة هذا لا يسمح بإرسال التحويلات أو إنشاء الشيكات أو استرداد المدفوعات (انظر أدناه). أما الرمز الذي تسلّمه يدويًا فقد يحمل صلاحيات مختلفة. لا مكان لتطبيق لم تطلبه على حسابك.

ما يستطيعه الوكيل وما لا يستطيعه

يحصل الوكيل عبر مسار الموافقة الموضّح أعلاه على رمز محدود الصلاحيات:

يستطيع إنشاء الفواتير وخطط الاشتراك، وقراءة رصيدك وأسعارك وإحصاءاتك، وضبط رابط الويب هوك.
لا يستطيع إرسال التحويلات أو إصدار الشيكات أو استرداد المدفوعات. تتطلب هذه العمليات الصلاحية المقابلة، payouts أو checks أو refunds، أو الرمز الرئيسي كامل الصلاحيات. ولا يحمل الرمز الصادر عبر هذا المسار أيًا من هذه الصلاحيات.

احتفظ بهذا الرمز سرًا، فصلاحياته تسمح بتعديل الفواتير وخطط الاشتراك ورابط الويب هوك. يصلك إشعار من البوت كلما صدر رمز لوكيل، وكلما تغيّر رابط الويب هوك لتطبيق.

لمراجعة صلاحيات رمز الوكيل أو إبطاله، افتح المزيد ← واجهة التجار، وابحث عن التطبيق، وافتح الوصول والرموز، ثم انظر تحت رموز محدودة الصلاحيات — وإبطال يُلغيه فورًا. أما التطبيق نفسه ورصيده وسجل مدفوعاته فتبقى كما هي. لا يمكن عرض قيمة الرمز مجددًا. وإذا كانت له صلاحية محددة، يتوقف عن العمل عند انتهائها.

توقيعات الويب هوك تحتاج رمزك الرئيسي

يستطيع الوكيل توجيه رابط الويب هوك إلى خادمك، لكنه لا يستطيع التحقق مما يصل إليه: فالتسليمات موقّعة برمز تطبيقك الرئيسي، والوكيل لا يراه أبدًا. اطلب من الوكيل كتابة شيفرة التحقق وترك موضع فارغ لك — باسم مثل TGPAY_WEBHOOK_TOKEN — لتملأه.

ولملئه: افتح المزيد ← واجهة التجار، وابحث عن التطبيق الذي أنشأه الوكيل، وافتح الوصول والرموز، ثم اضغط تدوير الرمز وانسخ ما يظهر — فهو لا يظهر إلا مرة واحدة. ضعه في بيئة خادمك، لا في إعداد الوكيل ولا في مستودعك. والتدوير لا يمسّ رمز الوكيل المحدود، فيستمر التكامل في العمل.

وتنتقل التوقيعات إلى الرمز الجديد لحظة التدوير، فدوّر قبل الإطلاق لا بعد أول دفعة حقيقية.

اقرأ بعد ذلك

البدء كمطوّر — المسار اليدوي، وكيف تدير التطبيق بعد إنشائه.
مرجع الواجهة: الويب هوك — أشكال الحمولات وإعادة المحاولات وفحص التوقيع.
مرجع واجهة التجار — كل الطرق، بما فيها ما لا يستطيع الوكيل استدعاءه.