RemoteGymp · API v1

ایک AI اسسٹنٹ کو جوڑیں۔

ایک MCP کلائنٹ استعمال کریں جو Streamable HTTP کو سپورٹ کرتا ہو اور PKCE کے ساتھ پہلے سے رجسٹرڈ OAuth یا کنفیگرڈ بیئرر ٹوکن۔ کلائنٹ کی حمایت مختلف ہوتی ہے؛ خودکار کلائنٹ رجسٹریشن دستیاب نہیں ہے۔

MCP سرور URL

https://api.remotegymp.com/mcp

خود میزبانی کے لیے، اپنی تنصیب کے عوامی HTTPS ایڈریس پر وہی MCP راستہ استعمال کریں۔ آپ کا کلائنٹ اس تک پہنچنے کے قابل ہونا چاہیے۔ کلاؤڈ ایڈریس آپ کی تنصیب کے لیے پراکسی درخواستیں نہیں کرتا ہے۔

OAuth کے ساتھ جڑیں۔

  1. سیٹنگز میں، ایم سی پی کو فعال کرکے اور صرف اسسٹنٹ کو درکار اجازتوں کے ساتھ ایک سند بنائیں۔ اپنے کلائنٹ کی طرف سے فراہم کردہ عین مطابق کال بیک URL کو رجسٹر کریں۔ اسناد کے صارف نام کو OAuth کلائنٹ ID کے بطور استعمال کریں۔ یہ بہاؤ کلائنٹ کا راز استعمال نہیں کرتا ہے۔
  2. کال بیکس کو ایک واضح لوپ بیک ایڈریس پر HTTPS، یا HTTP کا استعمال کرنا چاہیے۔ مکمل URL کا مماثل ہونا چاہیے، بشمول پورٹ۔ اسے تبدیل کرنے کے لیے، ایک نئی سند بنائیں اور پرانی کو منسوخ کریں۔
  3. اپنے کلائنٹ سے جڑیں، اس مالک کے طور پر سائن ان کریں جس نے اسناد تخلیق کیں اور رضامندی کی اسکرین کا جائزہ لیں۔ کلائنٹ کو S256 PKCE اور MCP ریسورس یو آر ایل استعمال کرنا چاہیے۔ رضامندی اسناد کی اجازتوں کو محدود کر سکتی ہے۔ یہ اجازتیں شامل نہیں کر سکتا۔

Cloud OAuth کے اختتامی پوائنٹس

اجازت
https://app.remotegymp.com/integration/oauth/authorize
ٹوکن کا تبادلہ
https://app.remotegymp.com/integration/oauth/token
اجازت دینے والا سرور میٹا ڈیٹا
https://app.remotegymp.com/.well-known/oauth-authorization-server
محفوظ شدہ وسائل کا میٹا ڈیٹا
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth معیاری ٹوکن فیلڈ کے نام اور گھومنے والے ریفریش ٹوکن استعمال کرتا ہے۔ کلائنٹ کو خود بخود ریفریش کو ہینڈل کرنا چاہئے۔ رسائی کے ٹوکن زیادہ سے زیادہ 30 منٹ تک رہتے ہیں۔ کنکشن سات دنوں کے بعد ریفریش کیے بغیر یا کل 30 دن کے بعد ختم ہو جاتے ہیں۔ پرانے ریفریش ٹوکن کا دوبارہ استعمال کنکشن کو باطل کر دیتا ہے۔ اسے دوبارہ چلانے کے بجائے دوبارہ جڑیں۔

بیئرر ٹوکن کے ساتھ جڑیں۔

اگر آپ کا کلائنٹ کنفیگرڈ بیئرر ٹوکن کو سپورٹ کرتا ہے، تو MCP سامعین کے ساتھ ٹوکن اینڈ پوائنٹ پر MCP- فعال کریڈینشل کا تبادلہ کریں، پھر واپس کیے گئے ٹوکن کو کلائنٹ کی محفوظ بیئرر ٹوکن سیٹنگ میں رکھیں۔ یہ 30 منٹ کے بعد ختم ہوجاتا ہے۔ سرور یو آر ایل میں ٹوکن نہ لگائیں۔ ان کلائنٹس کے لیے OAuth استعمال کریں جنہیں خودکار ریفریش کی ضرورت ہے۔

{
  "username": "<your-credential-username>",
  "password": "<your-credential-secret>",
  "audience": "mcp"
}

تصدیق →

کام کرنے سے پہلے رسائی کی جانچ کریں۔

کلائنٹ سے کہیں کہ وہ اپنے دستیاب ٹولز کی فہرست بنائے اور پہلے صلاحیتوں کو پڑھے۔ صرف پڑھنے کی درخواست کے ساتھ شروع کریں، جیسے آلات کی فہرست۔ ایک غیر حاضر ٹول اجازتوں، دائرہ کار یا دستیابی کی عکاسی کر سکتا ہے۔ صرف MCP کو فعال کرنے سے ریموٹ کنٹرول نہیں ملتا ہے۔

tools/list · get_capabilities

اسکرین دیکھنا آلہ کی رضامندی کے بعد ہوتا ہے۔ اسکرین ان پٹ کو ایک تازہ اسکرین شاٹ کی ضرورت ہے۔ کام کی منظوری دینے سے پہلے اہداف، ڈیلیٹ کرنے کے پیش نظارہ اور حوالہ کردہ AI اخراجات کا جائزہ لیں۔ ایمرجنسی اسٹاپ مزید آٹومیشن کو روکتا ہے۔ پہلے سے چل رہا کام ختم ہو سکتا ہے۔

رسائی منقطع یا منسوخ کریں۔

اپنے کلائنٹ سے رابطہ منقطع کریں اور جب مزید ضرورت نہ ہو تو ترتیبات میں اسناد کو منسوخ کریں۔ منسوخی اس کے متعلقہ ٹوکنز اور OAuth کنکشن کو بعد کی درخواستوں پر روک دیتی ہے۔ غیر متعلقہ انضمام کے درمیان کبھی بھی اسناد کا اشتراک نہ کریں۔

مواد کی نظرثانی 3f225a253 · OpenAPI SHA-256: b12c42306a89