RemoteGymp · API v1

חבר עוזר AI

השתמש בלקוח MCP שתומך ב-HTTP שניתן להזרים או ב-OAuth רשום מראש עם PKCE או באסימון נושא מוגדר. תמיכת לקוחות משתנה; רישום לקוח אוטומטי אינו זמין.

כתובת URL של שרת MCP

https://api.remotegymp.com/mcp

עבור Self Hosted, השתמש באותו נתיב MCP בכתובת ה-HTTPS הציבורית של ההתקנה שלך. הלקוח שלך חייב להיות מסוגל להגיע אליו. כתובת הענן אינה מבקשת פרוקסי להתקנה שלך.

התחבר עם OAuth

  1. בהגדרות, צור אישור עם MCP מופעל ורק את ההרשאות שהעוזר צריך. רשום את כתובת האתר המדויקת להתקשרות חוזרת שסופקה על ידי הלקוח שלך. השתמש בשם המשתמש של האישור כמזהה הלקוח של OAuth. זרימה זו אינה משתמשת בסוד לקוח.
  2. התקשרויות חוזרות חייבות להשתמש ב-HTTPS, או ב-HTTP על כתובת לולאה מפורשת. כתובת האתר המלאה חייבת להתאים, כולל היציאה. כדי לשנות אותו, צור אישור חדש ובטל את הישן.
  3. התחבר מהלקוח שלך, היכנס בתור הבעלים שיצר את האישור ועיין במסך ההסכמה. הלקוח חייב להשתמש ב-S256 PKCE ובכתובת ה-URL של משאב MCP. הסכמה יכולה לצמצם את ההרשאות של האישור; זה לא יכול להוסיף הרשאות.

נקודות קצה בענן 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, ולאחר מכן הכנס את האסימון שהוחזר בהגדרת ה-Bearer-token המאובטח של הלקוח. התוקף יפוג לאחר 30 דקות. אל תכניס אסימון לכתובת האתר של השרת. השתמש ב-OAuth עבור לקוחות הזקוקים לרענון אוטומטי.

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

אימות →

בדוק גישה לפני ביצוע עבודה

בקשו מהלקוח לרשום תחילה את הכלים הזמינים ויכולות הקריאה שלו. התחל עם בקשה לקריאה בלבד, כגון רישום מכשירים. כלי נעדר עשוי לשקף הרשאות, היקף או זמינות. הפעלת MCP בלבד אינה מעניקה שליטה מרחוק.

tools/list · get_capabilities

צפייה במסך באה בעקבות הסכמת המכשיר. קלט מסך צריך צילום מסך חדש. סקור יעדים, תצוגות מקדימות של מחיקה ועלויות AI לפני אישור עבודה. עצירת החירום חוסמת אוטומציה נוספת; העבודה שכבר פועלת עשויה להסתיים.

נתק או שלל גישה

נתק את החיבור בלקוח שלך ובטל את האישור בהגדרות כאשר אין בו עוד צורך. ביטול מפסיק את האסימונים המשויכים שלו וחיבורי OAuth בבקשות עוקבות. לעולם אל תשתף את האישור בין אינטגרציות לא קשורות.

תיקון תוכן 3f225a253 · OpenAPI SHA-256: b12c42306a89