MCP 서버에 'Hello 페이지'를 만들자는 제안, 왜 이게 의미 있을까

MCP가 뭔지부터 짚고 갈게요

요즘 AI 개발 쪽에서 MCP(Model Context Protocol)라는 말이 자주 들리죠. 작년에 Anthropic이 발표한 표준인데, 한 줄로 설명하면 "AI 모델이 외부 도구나 데이터에 접근할 때 쓰는 공통 규격"이에요. 예전에는 각 AI마다 "이 도구는 이렇게 호출하세요" 하고 제각각이었거든요. ChatGPT 플러그인은 ChatGPT 방식대로, Claude는 Claude 방식대로. MCP는 이걸 USB-C 케이블처럼 표준화해서, 한 번 만든 MCP 서버를 여러 AI 클라이언트에서 그대로 쓸 수 있게 한 거예요.

그런데 이번에 hybridlogic.co.uk 블로그에 올라온 "MCP Hello Page"라는 글이 흥미로운 제안을 합니다. MCP 서버 URL에 사람이 브라우저로 접속하면 도대체 무슨 일이 일어나야 하느냐는 거예요. 별것 아닌 것 같지만, 곱씹어보면 꽤 깊은 이야기거든요.

지금은 어떤 상황이냐면

MCP 서버는 기본적으로 AI 클라이언트(예: Claude Desktop, Cursor 같은 도구)가 접속하라고 만든 거예요. JSON-RPC라는 프로토콜로 통신하고, 도구 목록을 주고받고, 함수를 호출하는 식이죠. 그래서 사람이 브라우저로 https://my-mcp-server.com 같은 URL을 직접 열면, 보통 빈 페이지가 나오거나 에러가 떠요. 또는 정체불명의 JSON이 출력되거나요.

글쓴이가 지적하는 건 이게 좀 이상한 상황이라는 점이에요. 우리는 웹의 오랜 전통에서 URL은 사람이 열 수도 있어야 한다고 배워왔잖아요. API 엔드포인트도 보통 그 URL에 접속하면 "이건 무슨 API다, 어떻게 쓰면 된다, 문서는 여기 있다" 같은 안내 페이지를 보여주는 게 좋은 관행이거든요. GitHub API도, Stripe API도 다 그래요. 그런데 MCP는 아직 그런 관행이 없어요.

'Hello 페이지'가 해야 할 일

글쓴이가 제안하는 Hello 페이지는 단순한 환영 인사가 아니에요. 몇 가지 실용적인 정보를 담아야 한다고 봅니다. 첫째, 이게 MCP 서버라는 사실을 명확히 알려줘야 해요. 둘째, 어떤 MCP 클라이언트로 어떻게 접속하면 되는지 가이드가 있어야 하고요. 셋째, 이 서버가 제공하는 도구(tool) 목록과 설명이 사람이 읽을 수 있는 형태로 있어야 합니다. 넷째, 인증 방법(OAuth, API 키 등)이 있다면 그 안내도요.

생각해보면 이건 거의 API 문서 페이지랑 비슷한 역할이에요. 다만 MCP라는 맥락에 맞춰진 거죠. 예를 들어 GitHub의 MCP 서버 URL에 브라우저로 접속하면 "이 서버는 GitHub의 리포지토리 검색, 이슈 생성, PR 리뷰 도구를 제공합니다. Claude Desktop에서 쓰려면 설정 파일에 이렇게 추가하세요" 같은 안내가 나오면 얼마나 좋을까요. 지금은 이런 게 다 외부 문서나 README로 흩어져 있어서, 처음 쓰는 사람은 한참 찾아야 해요.

비슷한 사례를 보면

이 아이디어가 새로운 건 아니에요. 비슷한 전례가 꽤 있거든요. OpenAPI(Swagger)가 대표적이죠. REST API의 명세를 기계가 읽을 수 있는 JSON/YAML로 작성하면, Swagger UI가 그걸 자동으로 사람이 읽기 좋은 페이지로 렌더링해줘요. GraphQL의 Playground나 GraphiQL도 마찬가지로, 엔드포인트에 브라우저로 접속하면 스키마를 탐색하고 쿼리를 실행해볼 수 있죠. 더 거슬러 올라가면 WSDL이나 robots.txt, .well-known/ 같은 "표준 위치에 메타정보를 두는" 패턴도 같은 철학을 공유해요.

MCP는 아직 어려서 이런 관행이 정립되지 않았어요. 표준 자체가 작년에 나왔으니까요. 그래서 지금이 "공통 약속"을 만들기 좋은 타이밍이라는 게 글의 핵심이에요. 나중에 MCP 서버가 수만 개가 되고 나면 표준을 도입하기가 훨씬 어려워지거든요.

한국 개발자가 챙겨봐야 할 부분

MCP 서버를 만들고 있거나, 만들 계획이 있다면 이 제안은 진지하게 받아들일 만해요. 당장 표준이 정해지지 않았더라도 본인의 MCP 서버 루트 URL에 간단한 HTML 페이지 하나 띄우는 건 어려운 일이 아니에요. Express나 FastAPI 같은 데서 GET / 라우트 하나 추가해서, 이 서버가 뭐 하는 놈인지 한 페이지 설명을 넣어두면 됩니다. 사용자가 설치 과정에서 헷갈릴 때 그 페이지만 보고도 자가 해결할 수 있게 되거든요.

또 하나, MCP 생태계가 빠르게 커지면서 사내 MCP 서버를 만드는 기업도 늘어날 거예요. 회사 내부 데이터베이스, 사내 위키, 사내 도구를 AI에게 연결하는 통로로 MCP만큼 표준화된 게 없으니까요. 이때 Hello 페이지 같은 "사람을 위한 진입점"은 사내 개발자들의 온보딩 비용을 확 줄여줍니다. 누가 "이 MCP 어떻게 써?"라고 물어볼 때마다 문서 링크 던지는 것보다, 그냥 "서버 URL 열어봐" 한마디가 훨씬 깔끔하잖아요.