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

أعطِ وكيلك البرمجي رابطًا واحدًا — https://crypto.tgpaybot.com/mcp — ليبني لك تكامل المدفوعات: يقرأ وثائق الواجهة، وينشئ تطبيق التاجر، ويضبط الويب هوك، ويكتب الشيفرة. وأنت توافق على التطبيق الجديد مرة واحدة، بزر واحد في البوت. لا حاجة إلى طرفية، ولا إلى نسخ رمز API بيدك.

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

الربط

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

• أي محادثة مع وكيل — الصق هذا النص:

  Connect the tgpay MCP server (https://crypto.tgpaybot.com/mcp) and integrate payments via the TgPay Merchant API.

  وهو جاهز للنسخ داخل التطبيق تحت المزيد ← واجهة التجار ← ربط وكيل ذكاء اصطناعي.
• Claude Code — claude mcp add --transport http tgpay https://crypto.tgpaybot.com/mcp
• claude.ai و Claude Desktop — Settings → Connectors → Add custom connector ثم الصق الرابط.
• ChatGPT وسائر عملاء MCP — أضف موصّلًا مخصصًا بالرابط نفسه.

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

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

1. اطلب من الوكيل إعداد المدفوعات. فيقرأ الوثائق ثم يطلب موافقتك.
2. يعطيك الوكيل رابط t.me. افتحه — يعرض البوت ما هو مطلوب بالضبط — ثم اضغط ✅ إنشاء التطبيق وإصدار الرمز.
3. عُد إلى الوكيل. يستلم رمزه خلال ثوانٍ ويُتمّ التكامل بنفسه.

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

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

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

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

والضرر محدود بحكم التصميم: فرمز الوكيل يقبض المال ولا يصرفه أبدًا (انظر أدناه). لكن تطبيقًا لم تطلبه لا مكان له على حسابك.

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

الرمز الذي يستلمه الوكيل رمز محدود الصلاحيات:

• يستطيع إنشاء الفواتير وخطط الاشتراك، وقراءة رصيدك وأسعارك وإحصاءاتك، وضبط رابط الويب هوك.
• لا يستطيع إرسال التحويلات ولا إصدار الشيكات ولا استرداد المدفوعات. فكل ما يُخرج المال من رصيد تطبيقك يحتاج رمزك كامل الصلاحيات، وهو يبقى في التطبيق.

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

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

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

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

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

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

اقرأ بعد ذلك

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