읽기 액세스로 시작
카탈로그, 위치 및 상태 조회는 제한된 초기 도구 세트를 구성할 수 있습니다. 클라이언트는 리소스를 생성, 취소 또는 자금 지원할 권한을 얻기 전에 무엇이 지원되는지 알 수 있어야 합니다.
결과가 따르는 작업은 분리
서버 취소, 재설치 및 결제 작업에는 명시적 범위와 이해하기 쉬운 확인이 필요합니다. 도구 설명은 그 효과를 명시해야 하며, 서버는 클라이언트의 선의를 신뢰하기보다 권한 부여를 직접 시행해야 합니다.
불확실한 결과 처리
작업 식별자와 읽을 수 있는 오류를 반환하세요. 재시도로 추가 리소스나 결제가 생성될 수 있는 경우 멱등성을 사용하세요. 도구 응답이나 로그에 비밀을 포함하지 않고 결과를 기록하세요.
출시 정보는 사실이어야 합니다
출시에는 검증된 엔드포인트, 인증 지침, 지원되는 프로토콜 버전 및 문서화된 제한이 필요합니다. 여기서는 차용한 엔드포인트, 가짜 SDK 릴리스 또는 다운로드 링크를 제공하지 않습니다.
도구 설명과 실행 권한을 분리하세요
MCP 서버는 카탈로그 및 관리 도구를 설명할 수 있지만, 인증된 계정이 클라이언트가 실행할 수 있는 호출을 결정합니다. create_server라는 도구에는 서버 권한과 유효한 주문 결정이 필요합니다. read_catalogue 도구에는 취소 또는 결제 권한이 있는 자격 증명이 필요하지 않아야 합니다.
인프라 에이전트를 위한 유용한 도구 그룹
설계상의 목적은 요금제와 이미지 조회, 주문 및 운영 확인, SSH 공개 키 관리, 서버 상태 관찰을 포함합니다. 서비스 생성 또는 취소와 결제 시작은 적절한 권한이 필요한 중대한 작업입니다. 클라이언트가 추측해야 하는 설명문 대신 구조화된 식별자와 명확한 종료 상태를 반환합니다.
전송 및 인증을 문서화해야 합니다
향후 원격 엔드포인트에는 HTTPS, 지원되는 전송 및 명시적 토큰 메커니즘이 필요합니다. 자격 증명은 공개 구성 예시가 아닌 승인된 인증 채널에 속합니다. OAuth 등록, 프로토콜 버전, 다운로드 가능한 stdio 패키지 및 호환성 배지는 KoalaVPS이 이를 구현하고 검증한 후에만 게시해야 합니다.
재시도는 동일한 작업으로 돌아가야 합니다
서버가 요청을 수락한 후 에이전트의 연결이 끊길 수 있습니다. 유료 작업을 재시도하기 전에 작업 또는 멱등성 식별자를 영구 저장하세요. 불확실한 응답 후에는 상태를 다시 읽으세요. 타임아웃과 메시지 누락은 원래 작업이 실패했음을 증명하지 않습니다.
호스팅된 KoalaVPS MCP 엔드포인트가 여기에 연결되어 있지 않습니다
이 페이지는 계획된 통합을 설명합니다. 에이전트를 등록하거나 서버 패키지를 설치하거나 자격 증명을 제공하거나 실제 관리 도구를 연결하지 않습니다. 배포 가이드는 고객이 VPS에서 자체 MCP 애플리케이션을 호스팅하는 방법을 설명하며, 해당 애플리케이션은 KoalaVPS 컨트롤 플레인 서비스와 별개입니다.
조금 더 명확하게.
이 페이지 자체가 MCP 프로토콜 엔드포인트인가요?
아니요. 이는 설명용 웹 페이지입니다. 향후 머신 엔드포인트는 별도로 구현, 문서화 및 인증되어야 합니다.
AI 에이전트가 연결만으로 지출 권한을 받나요?
아니요. 도구 검색 및 인증은 요청된 작업에 대한 계정 범위, 청구 확인 또는 승인 규칙을 대체하지 않습니다.