당신의 AI 어시스턴트를 살아있는 예술 카탈로그에 연결하세요: Mus3ums MCP 서버 및 API

30초 만에 얻는 답변

박물관은 150년 전, 카드 카탈로그를 통해 이 문제를 해결한 적이 있습니다. 이는 어떤 방문자라도 방대한 컬렉션에 정밀한 질문을 던지고 정확한 답변을 얻을 수 있는 표준화된 방식이었습니다. Model Context Protocol — MCP — 는 AI 어시스턴트를 위한 카드 카탈로그입니다. 이는 Claude와 같은 어시스턴트가 대화 범위를 넘어, 학습 과정에서 어렴풋이 기억하는 정보에 의존하는 대신 실시간의 구조화된 신뢰할 수 있는 출처(source of truth)에 접근하여 질의할 수 있게 해주는 개방형 표준입니다. Mus3ums는 이제 바로 그러한 카탈로그를 발행합니다. https://direct.Mus3ums.com/mcp/에 위치한 MCP 서버에는 7개의 도구가 포함되어 있습니다. 그중 5개는 컬렉션 내의 예술 작품, 작가, 박물으로, 또는 이 네 가지 모두를 동시에 검색합니다. 하나는 카탈로그에 있는 모든 작품의 복제본(아트 프린트 또는 수작업 유화)에 대해 우리가 지정한 크기와 통화로 정확한 실제 금액 견적을 제공합니다. 그리고 우리의 정체성을 묻는 유일한 도구인 나머지 하나는 사용자 자신의 주문 내역을 확인할 수 있게 해줍니다. 모든 공개 도구에는 키, 등록, 결제가 필요하지 않습니다. 어시스턴트를 한 번만 연결해 두면, 그 이후부터 "카이보트의 비 내리는 파리 거리를 찾아주고, 폭 1미터 크기의 수작업 유화 복제본이 몇 유로인지 알려줘"라는 질문은 정확한 답변을 가진 질문이 됩니다.

1. 전문 용어 없이 설명하는 MCP란 무엇인가

AI 어시스턴트는 그대로 두면, 학습이 종료된 날 이후로 더 이상 책을 들여오지 않는 도서관에 갇힌 학자와 같습니다. 카라바조의 생애에 대해 물으면 잘 대답하겠지만, 70 × 90 cm 크기의 성 마태오의 부름 수작업 복제본이 오늘날 캐나다 달러로 얼마인지 물으면, 그저 추측할 뿐입니다. 물론 아주 정중하고 유창하게, 하지만 검증할 수는 없는 방식으로 말이죠.

2024년 말 Anthropic에 의해 도입되어 이후 업계 전반에 채택된 개방형 표준인 MCP는 이 문제를 가장 단순한 방식으로 해결합니다. 바로 어시스턴트에게 '전화기'를 쥐여주는 것입니다. 카탈로그, 데이터베이스, 가격표 등 질문할 가치가 있는 정보를 가진 웹사이트는 이름이 지정된 일련의 작은 도구(tools) 세트를 공개하며, 각 도구에는 기능과 입력해야 할 정보에 대한 설명이 포함되어 있습니다. 어시턴트는 우리가 메뉴판을 읽듯 그 목록을 읽고, 질문에 필요할 경우 전화를 겁니다. 즉, 하나의 구조화된 요청을 보내고, 숫자가 정확히 유지된 하나의 구조화된 답변을 돌려받는 것입니다. 어시스턴트는 사이트의 서버를 뒤지지 않습니다. 오직 사이트가 답변하기로 선택한 질문만을 던질 수 있습니다. 바로 이 제약이 핵심입니다. 카드 카탈로그가 방문객에게 아카이브의 열쇠를 넘겨주는 것이 아니라, 카드에 적힌 질의에 답을 해주는 것과 같은 원리입니다.

2. 일곱 가지 도구와 각 도구가 답하는 내용

서버는 일곱 가지 도구를 제공합니다. 이 세트의 구성을 살펴보십시오. 다섯 가지는 무언가를 찾는 방법이며, 하나는 검색 결과를 가격으로 변환하고, 마지막 하나 — 유일한 개인용 도구 — 는 컬렉션이 아닌 우리 자신에 관한 것입니다.

모든 검색 결과에는 관련성 점수가 포함되어 있으며, 도구는 목록을 채우기 위해 불확실한 정보를 나열하는 대신 신뢰도가 높은 일치 항목만을 반환합니다. 따라서 결과를 읽는 어시스턴트는 확실한 식별과 모호한 정보를 구분할 수 있습니다. 결과는 요청한 언어로 반환됩니다: language 파라미터는 사이트 인터페이스의 모든 언어를 지원하며, 링크는 해당 언어로 된 페이지를 가리킵니다.

3. 견적 도구는 자세히 살펴볼 가치가 있습니다

가격은 대부분의 "AI와 쇼핑의 결합" 통합 과정에서 조용히 오류가 발생하는 지점입니다. 따라서 이 도구가 정확히 무엇을 하는지 명시할 가치가 있습니다. 견적은 구매 페이지 자체의 가격을 책정하는 것과 동일한 코드로 계산되며, 반올림 방식도 동일합니다. 즉, 어시스턴트가 읽어주는 수치는 추정치가 아니라 웹사이트에서 실제로 보게 될 수치입니다. 이 도구의 세 가지 추가적인 특징은 주목할 만합니다:

• 돈에 대해 추측하는 것을 거부합니다. 환율 정보를 확인할 수 없는 통화를 요청하면, 도구는 이를 알리고 중단합니다. 사용자가 눈치채지 못하기를 바라며 조용히 미국 달러로 대체하여 계산하지 않습니다.
• 무엇이 판매 가능하고 무엇이 불가능한지 알려줍니다. 모든 작품이 모든 형태로 제공되는 것은 아닙니다. 프린트로만 가능한 작품에 대해 수작업 유화 제작을 요청하면, 도구는 해당 문제를 지적하며 만약 가능하다면 프린트 옵션에 대해 언급합니다.
• 크기를 정직하게 유지합니다. 각 치수는 작업실에서 실제로 제작 가능한 범위인 25~250cm(약 10~98인치) 사이여야 합니다. 도구는 누군가의 암산에 의존하는 대신 우리를 위해 인치를 변환해 줍니다.

따라서 다음과 같은 대화가 일상적인 작업이 됩니다: "귀스타브 카유보트의 비 내리는 파리 거리 장면을 찾아줘. 그다음 100 × 70cm 크기의 수작업 유화를 유로로 견적 내주고, 프린트와 동일한 크기로도 견적을 내서 그 차이점을 알려줘." 어시스턴트는 한 번의 검색 호출과 두 번의 견적 호출을 수행하며, 결과로 제공하는 비교는 지클레이 프린트와 수작업 유화의 차이 가이드에서 수동으로 설명하는 것과 동일한 실제 가격에 기반한 산술적 비교입니다.

4. 어시스턴트 연결 실습

서버는 일반 HTTPS를 통해 상태가 없는(stateless) MCP를 제공합니다. POST 본문에 담긴 JSON-RPC 방식이며, 그 외에 특별한 것은 없습니다. 즉, 두 종류의 사용자층이 이를 사용할 수 있음을 의미합니다.

MCP 클라이언트를 사용하는 경우

MCP 기능을 지원하는 모든 클라이언트는 엔드포인트 URL만으로 연결할 수 있습니다. Claude의 경우, https://direct.Mus3ums.com/mcp/를 가리키는 커스텀 커넥터를 추가하면 됩니다. Claude Code에서는 단 한 줄의 명령어로 가능합니다:

claude mcp add --transport http Mus3ums https://direct.Mus3ums.com/mcp/

그 순간부터 7개의 도구가 어시스턴트의 기능 목록에 나타나며, 어시스턴트는 질문에 따라 각 도구를 사용할 시점을 스스로 결정합니다. 추가 설정은 필요 없으며, 공개 도구의 경우 별도의 인증 정보도 필요하지 않습니다.

일반 API로 사용하는 경우

MCP 클라이언트 없이 카탈로그를 사용하고자 하는 개발자는 동일한 엔드 კომპ포넌트(endpoint)를 직접 호출할 수 있습니다. 다음의 curl 명령 한 번으로 컬렉션을 검색할 수 있습니다:

curl -s https://direct.Mus3ums.com/mcp/ \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
      "name": "search_artworks",
      "arguments": {"query": "Caillebotte Paris street rainy day"}
    }
  }'

응답은 구조화된 JSON 형식으로 제공됩니다. 카탈로그 번호, 제목, 작가, 절대 URL, 점수 등이 포함되어 있어 우리가 구축하려는 어떤 서비스에도 즉시 활용할 수 있습니다.

주문 전용 개인 토큰

어시스턴트가 사용자의 주문 내역을 확인하게 하려면, 웹사이트에 로그인한 후 Profile → MCP / API (/profile/mcp/)로 이동하여 표시된 개인 토큰을 복사한 뒤, 이를 Authorization 헤더에 담아 전송하면 됩니다. 이 설계는 의도적으로 범위를 좁게 제한했습니다. 토큰은 특정 계정을 식별하며, 주문 도구는 해당 계정에 대해서만 응답합니다. 반면 검색 및 견적 도구는 보호해야 할 개인 정보가 없으므로 토큰을 완전히 무시합니다. 만약 본인의 것이 아닌 주문 번호에 대해 문의할 경우, 서버는 존재하지 않는 주문에 대해 응답하는 것과 동일하게 대응합니다. 즉, 타인의 구매 내역에 대해서는 최소한의 확인조차 거부합니다.

5. 카탈로그 사이트가 API를 공개하는 이유

질문의 방식이 이미 변화했기 때문입니다. 구매를 계획하는 사람들의 비중이 점점 늘어나면서, 이제는 검색 엔진이 아닌 어시스턴트와 함께 시작하는 경우가 많아졌습니다. "모나리자의 박물관급 복제본은 비용이 얼마나 들까?"라는 문장이 채팅창에 입력되면, 어시/스턴트는 자신이 확인할 수 있는 모든 소스를 바탕으로 답변을 내놓습니다. 카탈로그와 가격 정보를 어시스턴트가 조회할 수 있는 형태로 공개하는 사이트는, 과거 박물관들이 첫 공개 카탈로그를 인쇄했을 때 했던 것과 똑같은 일을 하고 있는 것입니다. 즉, 방문객이 이미 머무르고 있는 곳에서 그들을 만나고, 막연한 설(folklore)보다는 정확한 답변을 제공하는 것입니다. 어시스턴트가 오래된 학습 데이터를 바탕으로 가격과 재고를 추측하는 대안은 그 누구에게도 도움이 되지 않으며, 특히 답변에 따라 실제 돈을 지불하려는 사람에게는 더욱 그렇습니다. 저희는 다른 글을 통해 복제 매체와 가격 책정이 실제로 어떻게 이루어지는지, 그리고 복제품에서 품질과 가치가 무엇을 의미하는지에 대해 기술한 바 있습니다. MCP 서버는 바로 그 답변들을 기계가 읽을 수 있는 형태로 제공하는 것입니다.

연결 전 확인해야 할 세 가지 질문

Mus3ums MCP 서버를 사용하려면 계정이나 API 키가 필요한가요?

대부분은 필요하지 않습니다. 5개의 검색 도구와 인용(quotation) 도구는 공개되어 있으며 별도의 토큰이 필요하지 않은데, 이는 웹사이트가 모든 방문자에게 이미 공개하고 있는 정보만을 제공하기 때문입니다. 개인 토큰이 필요한 경우는 단 하나의 도구뿐입니다. 바로 이름, 전화번호, 배송 주소가 포함된 사용자의 주문 내역을 반환하는 도구입니다. 해당 토큰은 로그인 후 /profile/mcp/ 페이지에서 발급받을 수 있으며, 오직 해당 토큰이 속한 계정의 주문 내역만 확인할 수 있습니다.

어시스턴트가 제시하는 가격이 실제 가격인가요?

네, 그렇습니다. 인용 정보는 구매 페이지와 동일한 가격 산출 코드를 통해 생성되며 반올림 방식도 동일하므로, 어시스턴트가 읽어주는 숫자는 웹사이트의 숫자와 일치합니다. 이 서비스는 한 변의 길이가 25cm에서 250cm 사이인 프린트 및 수작업 유화 작품을 지원하는 모든 통화에 대해 적용됩니다. 특정 통화의 환율 정보를 사용할 수 없는 경우, 도구는 임의로 달러로 전환하여 표시하는 대신 해당 사실을 사용자에게 알립니다.

어떤 어시스턴트가 연결 가능한가요?

HTTP를 통해 MCP를 지원하는 모든 클라이언트가 가능합니다. 커스텀 커넥터를 통한 Claude, 단 한 번의 claude mcp add 명령어로 사용 가능한 Claude Code, 그리고 점점 확대되고 있는 MCP 지원 데스크톱 및 개발자 도구들이 포함됩니다. 또한 전송 방식이 일반적인 HTTPS POST 기반의 JSON-RPC이므로, 엄격한 의미에서 별도의 MCP 클라이언트가 반드시 필요한 것은 아닙니다. curl 명령어나 모든 프로그래밍 언어의 몇 줄 안 되는 코드로도 동일한 7가지 도구에 접근할 수 있습니다.

Mus3ums.com 관련 정보

• 견적 도구가 산정하는 가격 기준: 지클레이 프린트와 수작업 유화 걸작의 정직한 비교.
• 매체 및 주문 제작 선택에 따른 복제화 가격 형성 방식: 예술품 복제 해독 — 매체, 가격 및 주문 제작 가이드.
• 사용자 친화적인 검색 도구: API와 동일한 방식으로 아티스트 카탈로그 찾아보기.
• 이미 로그인하셨나요? 토큰 및 실시간 도구 목록은 사용자 프로필의 MCP / API 페이지에서 확인하실 수 있습니다.

출처

• Model Context Protocol — 공식 사양 및 문서
• Model Context Protocol 소개 — Anthropic
• Claude Code를 MCP 서버에 연결하기 — Claude Docs
• 원격 MCP를 사용한 커스텀 커넥터 시작하기 — Claude 도움말 센터