STREAMABLE HTTP

MCP 서버 체크

원격 MCP 서버에 연결해 어떤 도구가 있는지 살펴보고, 검토를 거친 뒤 호출합니다.

연결되지 않음

서버 연결

443 포트의 공개 HTTPS 엔드포인트만 지원합니다. 리디렉션과 사설망 주소는 차단됩니다.

  1. URL 및 보안대기 중
  2. 인증대기 중
  3. 프로토콜 협상대기 중
  4. 도구 탐색대기 중

인증 정보는 요청한 연결에만 쓰이도록 ComUtil을 거치며, 암호화된 브라우저 세션 안에만 보관됩니다.

MCP 서버 체크란?

Model Context Protocol 서버는 AI 클라이언트가 호출할 수 있는 도구, 리소스, 프롬프트를 제공합니다. 서버 체크는 원격 엔드포인트가 MCP 핸드셰이크를 완료하는지 확인하고, 협상된 프로토콜 버전을 알려주며, 서버가 공개한 도구 목록을 보여주고, 실제 호출에서 쓸 만한 결과가 돌아오는지 확인합니다. 모두 Claude Code나 Codex 등 클라이언트 설정에 서버를 넣기 전에 끝낼 수 있습니다.

검사가 진행되는 방식

검사는 단계별로 진행됩니다. 먼저 URL을 검증합니다. 443 포트의 공개 HTTPS 엔드포인트만 허용하고, 리디렉션과 IP 주소 형태의 호스트, 사설·예약 주소는 거부합니다. 그다음 Streamable HTTP 세션을 열어 initialize로 프로토콜 버전을 협상하고, tools/list를 호출해 각 도구를 입력 스키마와 함께 보여줍니다. tools/call은 도구 이름과 인수를 직접 확인한 뒤에만 실행됩니다. 서버가 자기 도구에 붙여 놓은 주석은 신뢰하지 않기 때문입니다.

주요 사용 사례
  • 막 배포한 원격 MCP 엔드포인트가 initialize와 tools/list에 응답하는지 확인
  • 클라이언트 설정에 추가하기 전에 OAuth 2.1 서버가 인가를 끝까지 완료하는지 확인
  • 로컬 클라이언트 설정을 건드리지 않고 실패하는 도구 호출 재현
  • 프롬프트나 코드를 작성하기 전에 서버가 공개한 입력 스키마 확인
  • 개발용 장비가 아닌 다른 환경에서 호스팅형 MCP 엔드포인트 확인
검사가 알려주는 정보
  • initialize 과정에서 협상된 프로토콜 버전
  • 공개된 모든 도구와 그 설명, 입력 JSON Schema
  • 기존 SSE는 지원하지 않으므로, 엔드포인트가 Streamable HTTP를 받아들였는지 여부
  • Bearer 토큰, API 키, OAuth 2.1의 인증 결과
  • 확인을 거친 도구 호출이 반환한 텍스트, 구조화된 콘텐츠, 메타데이터
예시
입력: https://mcp.example.com/mcp
출력: 프로토콜 협상 완료, 도구 12개 발견
입력: Authorization: Bearer <token>
출력: 자격 증명 확인됨, tools/list가 도구 3개 반환
입력: {"query": "release notes", "limit": 5}
출력: 텍스트와 구조화된 콘텐츠를 412 ms 만에 반환
자주 묻는 질문

이 도구가 MCP 서버를 대신 호스팅하거나 실행해 주나요?

아닙니다. 이미 운영 중이거나 구독하고 있는 서버에 접속해 그 서버의 응답을 보여줄 뿐입니다. 여기서 배포하거나 호스팅하는 것은 없습니다.

왜 443 포트의 HTTPS 엔드포인트만 허용하나요?

연결은 ComUtil 쪽에서 열리기 때문에 localhost, 사설 대역, IP 주소 형태의 호스트, 리디렉션을 거부합니다. 이런 제한이 없으면 이 검사가 남의 인프라를 향해 쓰일 수 있습니다.

제 토큰과 API 키는 어디에 저장되나요?

요청하신 연결에만 사용되며, 암호화된 브라우저 세션 안에만 보관됩니다. 여덟 시간 이내에 만료되고, 연결을 끊거나 브라우저 세션이 끝나면 더 이상 쓸 수 없습니다.

예전 HTTP+SSE 전송 방식도 지원하나요?

아닙니다. Streamable HTTP만 지원합니다. 서버가 아직 예전 SSE 엔드포인트를 제공하더라도, 검사는 Streamable HTTP 경로로 지정하세요.

제 승인 없이 도구가 실행될 수도 있나요?

아닙니다. 모든 호출은 도구 이름과 인수를 그대로 보여주는 최종 확인을 거칩니다. 서버가 자기 도구를 부정확하게 설명할 수 있기 때문입니다.

최종 확인

이 도구를 실행하시겠습니까?

MCP 서버가 외부 시스템을 실제로 변경할 수 있습니다. 계속하기 전에 도구와 인수를 정확히 확인하세요.

도구
인수