RemoteGymp · API v1

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

از یک سرویس گیرنده MCP استفاده کنید که از HTTP قابل پخش و OAuth از پیش ثبت شده با PKCE یا یک توکن حامل پیکربندی شده پشتیبانی می کند. پشتیبانی مشتری متفاوت است. ثبت نام خودکار مشتری در دسترس نیست.

آدرس سرور MCP

https://api.remotegymp.com/mcp

برای Self-Hosted، از همان مسیر MCP در آدرس HTTPS عمومی نصب خود استفاده کنید. مشتری شما باید بتواند به آن دسترسی پیدا کند. آدرس Cloud درخواست های پروکسی برای نصب شما نمی کند.

با OAuth ارتباط برقرار کنید

  1. در تنظیمات، یک اعتبار با فعال بودن MCP و فقط مجوزهایی که دستیار نیاز دارد ایجاد کنید. URL دقیق پاسخ تماس ارائه شده توسط مشتری خود را ثبت کنید. از نام کاربری اعتبار به عنوان شناسه مشتری OAuth استفاده کنید. این جریان از رمز مشتری استفاده نمی کند.
  2. تماس‌های برگشتی باید از HTTPS یا HTTP در یک آدرس برگشتی صریح استفاده کنند. URL کامل باید مطابقت داشته باشد، از جمله پورت. برای تغییر آن، یک اعتبار جدید ایجاد کنید و اعتبار قبلی را لغو کنید.
  3. از مشتری خود وصل شوید، به عنوان مالکی که اعتبارنامه را ایجاد کرده است وارد شوید و صفحه رضایت را بررسی کنید. مشتری باید از S256 PKCE و URL منبع 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