RemoteGymp · API v1

เชื่อมต่อผู้ช่วย AI

ใช้ไคลเอนต์ MCP ที่รองรับ Streamable HTTP และ OAuth ที่ลงทะเบียนล่วงหน้าด้วย PKCE หรือโทเค็นผู้ถือที่กำหนดค่าไว้ การสนับสนุนลูกค้าแตกต่างกันไป การลงทะเบียนลูกค้าอัตโนมัติไม่พร้อมใช้งาน

URL เซิร์ฟเวอร์ MCP

https://api.remotegymp.com/mcp

สำหรับ Self-Hosted ให้ใช้พาธ MCP เดียวกันกับที่อยู่ HTTPS สาธารณะของการติดตั้งของคุณ ลูกค้าของคุณต้องสามารถเข้าถึงได้ ที่อยู่คลาวด์ไม่ได้ร้องขอพรอกซีไปยังการติดตั้งของคุณ

เชื่อมต่อกับ 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 นาที อย่าใส่โทเค็นใน URL ของเซิร์ฟเวอร์ ใช้ OAuth สำหรับไคลเอนต์ที่ต้องการรีเฟรชอัตโนมัติ

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

การยืนยันตัวตน →

ตรวจสอบการเข้าถึงก่อนทำงาน

ขอให้ลูกค้าแสดงรายการเครื่องมือที่มีอยู่และอ่านความสามารถก่อน เริ่มต้นด้วยคำขอแบบอ่านอย่างเดียว เช่น การแสดงรายการอุปกรณ์ เครื่องมือที่ขาดหายไปอาจสะท้อนถึงสิทธิ์ ขอบเขต หรือความพร้อมใช้งาน การเปิดใช้งาน MCP เพียงอย่างเดียวไม่ได้ให้การควบคุมระยะไกล

tools/list · get_capabilities

การดูหน้าจอเป็นไปตามความยินยอมของอุปกรณ์ การป้อนข้อมูลหน้าจอต้องมีภาพหน้าจอใหม่ ตรวจสอบเป้าหมาย ลบตัวอย่าง และเสนอราคาต้นทุน AI ก่อนอนุมัติงาน การหยุดฉุกเฉินจะขัดขวางการทำงานอัตโนมัติเพิ่มเติม งานที่กำลังดำเนินอยู่อาจเสร็จสิ้นแล้ว

ตัดการเชื่อมต่อหรือเพิกถอนการเข้าถึง

ตัดการเชื่อมต่อในไคลเอนต์ของคุณและเพิกถอนข้อมูลประจำตัวในการตั้งค่าเมื่อไม่ต้องการอีกต่อไป การเพิกถอนจะหยุดโทเค็นที่เกี่ยวข้องและการเชื่อมต่อ OAuth ในคำขอที่ตามมา อย่าเปิดเผยข้อมูลประจำตัวระหว่างการบูรณาการที่ไม่เกี่ยวข้อง

3f225a253 แก้ไขเนื้อหา · OpenAPI SHA-256: b12c42306a89