MCP 서버 URL을 브라우저에서 열면 401 오류 대신 안내 HTML을 보여줘 고객 온보딩과 지원 티켓을 개선한 사례

본 기사는 업무용 도구에 MCP Server를 제공한 뒤, 사용자가 엔드포인트를 브라우저에서 열고 401 JSON 오류를 보고 지원 티켓을 제출하는 문제가 반복됐다고 설명합니다. 작성자는 GET /mcp 요청 중 Accept 헤더가 HTML을 선호하는 경우 안내 페이지를 반환하도록 처리해, 사용자가 해당 URL을 LLM client에 추가해야 한다는 점을 명확히 알렸습니다. 이 변경 이후 지원 요청이 크게 줄고 고객 설정 속도도 개선됐습니다.

이번 사례는 AI 도구 생태계에서 기계 간 통신용 프로토콜도 결국 사람의 온보딩 경로와 맞물린다는 점을 보여줍니다. MCP 같은 신흥 표준이 빠르게 확산되는 과정에서 명세 자체의 완성도뿐 아니라 오류 메시지, 브라우저 접근, 인증 흐름 같은 제품적 완성도가 채택률을 좌우할 가능성이 큽니다.