핑

MCP(Model Context Protocol)에는 어느 쪽이든 상대방이 여전히 응답 가능하고 연결이 유지되고 있는지 확인할 수 있는 선택적 핑 메커니즘이 포함되어 있습니다.

개요

핑 기능은 단순한 요청/응답 패턴으로 구현됩니다. 클라이언트 또는 서버 어느 쪽이든 ping 요청을 전송하여 핑을 시작할 수 있습니다.

메시지 형식

핑 요청은 매개변수가 없는 표준 JSON-RPC 요청입니다.

{
  "jsonrpc": "2.0",
  "id": "123",
  "method": "ping"
}

동작 요건

1. 수신측은 빈 응답으로 즉시 응답해야 합니다(MUST).

{
  "jsonrpc": "2.0",
  "id": "123",
  "result": {}
}

2. 합리적인 제한 시간 내에 응답이 수신되지 않으면 전송측은 다음을 수행할 수 있습니다(MAY). * 연결이 만료된 것으로 간주 * 연결 종료 * 재연결 절차 시도

사용 패턴

sequenceDiagram
    participant Sender
    participant Receiver

    Sender->>Receiver: ping request
    Receiver->>Sender: empty response

구현 고려사항

• 구현체는 연결 상태를 감지하기 위해 주기적으로 핑을 발행해야 합니다(SHOULD).
• 핑 빈도는 구성 가능해야 합니다(SHOULD).
• 제한 시간은 네트워크 환경에 적합하게 설정해야 합니다(SHOULD).
• 네트워크 오버헤드를 줄이기 위해 과도한 핑은 피해야 합니다(SHOULD).

오류 처리

• 제한 시간 초과는 연결 실패로 처리해야 합니다(SHOULD).
• 여러 번의 핑 실패는 연결 재설정을 트리거할 수 있습니다(MAY).
• 구현체는 진단을 위해 핑 실패를 로깅해야 합니다(SHOULD).

원문(영어): https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/ping · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Model Context Protocol)에게 있습니다.

원문(영어): https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/ping