Content-Type 분기 처리를 통한 MCP 서버 온보딩 마찰 및 CS 티켓 급감 달성

MCP Hello Page

2026년 5월 16일2분beginner

AI 요약

Context

MCP Server의 Specification 부재로 인해 브라우저 접속 시 401 Unauthorized 응답 및 JSON Blob이 노출되는 구조. 사용자들은 이를 시스템 장애로 오인하여 지속적으로 Support Ticket을 생성하는 온보딩 병목 현상 발생.

개별 LLM Client별 커넥터/플러그인 패키징의 높은 유지보수 비용 및 확장성 한계 인지
HTTP Request의 Accept Header를 분석하여 요청자의 정체성을 구분하는 Content Negotiation 전략 채택
Accept Header에 text/html 포함 및 application/json, text/event-stream 제외 시 전용 안내 페이지 반환 로직 구현
GET /mcp 엔드포인트 내에서 단순 API 응답과 사용자 가이드 HTML 페이지를 분리하여 전달하는 조건부 렌더링 설계
클라이언트 설정 필요성을 명시한 HTML 페이지 제공으로 사용자 자가 해결(Self-service) 유도

실천 포인트

API 엔드포인트 설계 시 브라우저 직접 접속 가능성을 고려하여 Accept Header 기반의 사용자 친화적 가이드 페이지 제공 여부를 검토하십시오.

태그