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

اربط وكيلًا برمجيًا يدعم خوادم 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 مسبقًا، فالوكيل يحصل على رمزه في الخطوة التالية. إذا كنت قد أنشأت تطبيقًا بنفسك، فأنشئ رمزًا محدود الصلاحيات وامنحه فقط الصلاحيات التي يحتاجها الوكيل، ثم استخدمه للتكامل. احتفظ بالرمز الرئيسي على خادمك. مهما كان الرمز الذي يستخدمه الوكيل، يمكنه عبر خادم MCP استقبال المدفوعات فقط (انظر أدناه).

لتمرير هذا الرمز إلى خادم MCP، أضف الخادم في إعدادات الاتصال بعميلك مع الترويسة TgPayCrypto-API-Token: <token> أو Authorization: Bearer <token>. عندها لا تحتاج إلى خطوة الموافقة. وليس لكل العملاء حقل لترويسات مخصّصة (فموصلات claude.ai و ChatGPT تخلو منه، والخادم لا يوفّر تسجيل الدخول عبر OAuth)؛ فاستخدم فيها خطوات الموافقة أدناه. ويمكن للوكيل أيضًا تمرير رمز في الوسيط api_token عند استدعاء أداة واحدة، إذا سمح له عميله بإرسال وسيط لا تعرّفه الأداة.

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

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

يُنشأ التطبيق ورمز الوكيل حين يتحقق الوكيل من الطلب مجددًا بعد ضغطك — عادةً خلال ثوانٍ. ويبقى الطلب صالحًا 10 دقائق من لحظة إنشاء الوكيل له: فإن لم يتحقق منه الوكيل في الوقت المناسب، لا يُنشأ شيء، حتى لو أكّد البوت ضغطتك، وعلى الوكيل أن يبدأ من جديد. يتطلب إنشاء التطبيق حسابًا مؤهلًا؛ وإذا لزم التحقق من الهوية، يتلقى الوكيل خطأ عند الاستعلام عن حالة الطلب. أكمل التحقق من الهوية، ثم اطلب من الوكيل الاستعلام مجددًا ضمن مهلة الـ10 دقائق نفسها، أو البدء من جديد.

بموافقتك على الطلب تقبل شروط واجهة التجار للتطبيق الذي يُنشأ به، تمامًا كما عند إنشاء تطبيق بنفسك في التطبيق المصغّر.

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

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

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

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

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

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

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

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

ويفرض خادم MCP قيدًا إضافيًا: أدوات إرسال الأموال من رصيد التطبيق — transfer وtransferBatch وcreateCheck وrefundInvoice — معطّلة حاليًا. لا تظهر هذه الأدوات للوكيل، ويُرفض استدعاؤها مهما كان الرمز المستخدم، حتى لو كان الرمز الرئيسي كامل الصلاحيات. لذلك لا يمكن إخراج أموال من تطبيقك عبر MCP باستخدام رمز وكيل تسرّب، ولا بتعليمات خبيثة مخفية في نص يقرؤه الوكيل، مثل تعليق من أحد الدافعين.

تبقى التحويلات والشيكات واسترداد المدفوعات متاحة مباشرة عبر API: استدعِ /pay/api من شيفرة خادمك برمز يحمل الصلاحية المناسبة للعملية، payouts أو checks أو refunds. ولإرسال المدفوعات من التطبيق، افتح المزيد ← واجهة التجار، واختر تطبيقك، ثم المدفوعات.

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

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

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

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

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

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

اقرأ بعد ذلك

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