اتصال یک عامل هوش مصنوعی

به عامل کدنویسی هوش مصنوعی‌تان فقط یک آدرس بدهید — 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.

  همین متن در برنامه، زیر بیشتر ← 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. به عامل برگردید. ظرف چند ثانیه توکنش را می‌گیرد و باقی یکپارچه‌سازی را خودش تمام می‌کند.

لینک همیشه از خود عامل شما می‌آید — ربات هیچ‌وقت بدون درخواست شما لینکی نمی‌فرستد: تا وقتی آن را باز نکنید، ربات نمی‌داند عامل درباره‌ی حساب چه کسی می‌پرسد. هر لینک یک بار کار می‌کند. اگر پیش از آنکه روی آن بزنید از کار افتاد، از عامل بخواهید از نو شروع کند — تا تأیید نکنید چیزی ساخته نمی‌شود.

اگر ❌ رد کردن را بزنید هم چیزی ساخته نمی‌شود و آن درخواست تمام است — اگر نظرتان عوض شد، عامل باید درخواست جدیدی بفرستد.

⚠️ فقط درخواستی را تأیید کنید که خودتان شروع کرده‌اید

درخواست اتصال یعنی درخواست ساخت یک برنامه روی حساب شما. فقط وقتی آن را تأیید کنید که همین حالا از عامل خودتان خواسته باشید پرداخت را راه‌اندازی کند. اگر لینکی از راه دیگری رسید — در یک چت، به‌صورت فوروارد، از «پشتیبانیِ» یک غریبه — آن را رد کنید.

دامنه‌ی خسارت از پیش محدود است: توکن عامل می‌تواند پول به داخل بیاورد، اما هرگز نمی‌تواند پول بیرون بفرستد (پایین‌تر توضیح داده شده). با این حال برنامه‌ای که خودتان نخواسته‌اید، جایی روی حساب شما ندارد.

عامل چه کاری می‌تواند انجام دهد و چه کاری نه

توکنی که عامل می‌گیرد یک توکن محدود است:

• می‌تواند صورت‌حساب و طرح اشتراک بسازد، موجودی، نرخ‌ها و آمار شما را بخواند و آدرس وب‌هوک را تنظیم کند.
• نمی‌تواند انتقال بفرستد، چک صادر کند یا پرداختی را برگرداند. هر کاری که پول را از موجودی برنامه بیرون ببرد به توکن دسترسی کامل شما نیاز دارد و آن توکن در خود برنامه می‌ماند.

این تفکیک عمدی است: توکن عامل‌ها در فایل‌های پیکربندی و کانتکست مدل نگهداری می‌شود و رسیدن به آن‌ها از رسیدن به سرور شما آسان‌تر است. نشت چنین توکنی حداکثر به قیمت یک آدرس وب‌هوک اشتباه برایتان تمام می‌شود، نه موجودی‌تان. هر بار که توکنی به یک عامل داده شود و هر بار که آدرس وب‌هوک برنامه‌ای عوض شود، ربات به شما پیام می‌دهد.

برای دیدن یا پس‌گرفتن توکن عامل، بیشتر ← API پذیرنده را باز کنید، برنامه را پیدا کنید و بخش توکن‌های محدود را ببینید — ابطال آن را بی‌درنگ از کار می‌اندازد. خود برنامه، موجودی و تاریخچه‌ی پرداخت‌هایش حفظ می‌شوند.

امضای وب‌هوک به توکن اصلی شما نیاز دارد

عامل می‌تواند آدرس وب‌هوک را روی سرور شما تنظیم کند، اما نمی‌تواند آنچه را که به آنجا می‌رسد بررسی کند: ارسال‌ها با توکن اصلی برنامه‌ی شما امضا می‌شوند و عامل هرگز آن را نمی‌بیند. یک عامل خوب کد بررسی امضا را می‌نویسد و یک جای خالی — چیزی مثل TGPAY_WEBHOOK_TOKEN — برایتان می‌گذارد تا آن را پر کنید.

برای پر کردن آن: بیشتر ← API پذیرنده را باز کنید، برنامه‌ای را که عامل ساخته پیدا کنید، روی تعویض توکن بزنید و آنچه را نشان داده می‌شود کپی کنید — فقط یک بار دیده می‌شود. آن را در متغیرهای محیطی سرورتان بگذارید، هرگز در پیکربندی عامل یا مخزن کدتان. تعویض به توکن محدود عامل دست نمی‌زند، پس یکپارچه‌سازی بی‌وقفه کار می‌کند.

از همان لحظه‌ی تعویض، امضاها با توکن جدید انجام می‌شوند، پس بهتر است پیش از راه‌اندازی نهایی تعویض کنید، نه بعد از اولین پرداخت واقعی.

در ادامه

• شروع کار برای توسعه‌دهنده‌ها — مسیر دستی و اینکه بعد از ساخت برنامه چطور آن را مدیریت کنید.
• مرجع API: وب‌هوک‌ها — شکل محتواها، تلاش‌های دوباره و بررسی امضا.
• مرجع API پذیرنده — همه‌ی متدها، از جمله آن‌هایی که عامل نمی‌تواند فراخوانی کند.