Streamable HTTP를 지원하고 PKCE로 사전 등록된 OAuth 또는 구성된 베어러 토큰을 지원하는 MCP 클라이언트를 사용합니다. 클라이언트 지원은 다양합니다. 자동 클라이언트 등록을 사용할 수 없습니다.
MCP 서버 URL
https://api.remotegymp.com/mcp셀프 호스팅의 경우 설치의 공용 HTTPS 주소에 동일한 MCP 경로를 사용합니다. 귀하의 고객이 연락할 수 있어야 합니다. 클라우드 주소는 설치에 대한 요청을 프록시하지 않습니다.
OAuth로 연결
- 설정에서 MCP가 활성화된 자격 증명과 보조자에게 필요한 권한만 생성합니다. 클라이언트가 제공한 정확한 콜백 URL을 등록하세요. 자격 증명 사용자 이름을 OAuth 클라이언트 ID로 사용합니다. 이 흐름은 클라이언트 암호를 사용하지 않습니다.
- 콜백은 명시적인 루프백 주소에서 HTTPS 또는 HTTP를 사용해야 합니다. 포트를 포함하여 전체 URL이 일치해야 합니다. 이를 변경하려면 새 자격 증명을 만들고 이전 자격 증명을 취소하세요.
- 클라이언트에서 연결하고 자격 증명을 생성한 소유자로 로그인한 후 동의 화면을 검토합니다. 클라이언트는 S256 PKCE 및 MCP 리소스 URL을 사용해야 합니다. 동의하면 자격 증명의 권한이 좁아질 수 있습니다. 권한을 추가할 수 없습니다.
클라우드 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분 동안 지속됩니다. 연결은 새로 고치지 않고 7일 후에 또는 총 30일 후에 만료됩니다. 이전 새로 고침 토큰을 재사용하면 연결이 무효화됩니다. 재생하는 대신 다시 연결하세요.
Bearer 토큰으로 연결
클라이언트가 구성된 베어러 토큰을 지원하는 경우 토큰 엔드포인트에서 MCP 지원 자격 증명을 MCP 대상과 교환한 다음 반환된 토큰을 클라이언트의 보안 베어러 토큰 설정에 넣습니다. 30분 후에 만료됩니다. 서버 URL에 토큰을 넣지 마십시오. 자동 새로 고침이 필요한 클라이언트에는 OAuth를 사용하세요.
{
"username": "<your-credential-username>",
"password": "<your-credential-secret>",
"audience": "mcp"
}작업 전 접근권한 확인
고객에게 먼저 사용 가능한 도구와 읽기 기능을 나열하도록 요청하십시오. 장치 나열과 같은 읽기 전용 요청으로 시작하세요. 없는 도구는 권한, 범위 또는 가용성을 반영할 수 있습니다. MCP만 활성화하면 원격 제어가 허용되지 않습니다.
tools/list · get_capabilities
화면 시청은 기기 동의를 따릅니다. 화면 입력에는 새로운 스크린샷이 필요합니다. 작업을 승인하기 전에 대상, 삭제 미리보기 및 견적된 AI 비용을 검토하세요. 비상 정지는 추가 자동화를 차단합니다. 이미 실행 중인 작업이 완료될 수 있습니다.
연결 끊기 또는 접근권한 철회
클라이언트 연결을 끊고 더 이상 필요하지 않은 경우 설정에서 자격 증명을 취소합니다. 취소하면 후속 요청에서 연결된 토큰 및 OAuth 연결이 중지됩니다. 관련되지 않은 통합 간에 자격 증명을 공유하지 마십시오.