본문으로 건너뛰기
원포트 AI

MCP 서버 (상품·값 조회)

에이전트가 우리 카탈로그를 직접 물어봐요. 키가 필요 없어요.

AI 에게 넘기기ChatGPT 에서 열기 (새 창)Claude 에서 열기 (새 창)원문 열기

학교·기관이 살 수 있는 AI 구독 상품의 이름·제공사·기간별 값을 MCP 로 엽니다. Claude Desktop·Claude Code·Cursor 처럼 MCP 를 쓰는 도구에 주소만 넣으면 돼요. 인증이 없어 누구나 붙일 수 있어요. 직접 만든 웹 페이지 코드(fetch)로 부르는 건 아래 「안 붙을 때」의 네 곳에서만 돼요 — claude.ai · Claude Desktop 커넥터는 이 제한과 상관없어요.

넣는 곳값
MCP 서버 주소 (Streamable HTTP)https://schoolorder.kr/mcp
인증없음 — 이 서버는 키를 읽지 않아요. sk-so- API 키는 MCP 설정에 적지 마세요.

주소는 https://schoolorder.kr/mcp 를 그대로 적어요. oneport.kr/mcp 는 308 로 학교용(https://schoolorder.kr/mcp)으로 넘겨요. 넘기는 걸 따라가지 않는 도구도 있고, 브라우저 fetch 는 사전 요청이 넘김에서 막혀요. 회사에서 쓰시면 https://officeorder.co.kr/mcp 를 바로 적으세요. www. 를 붙인 주소도 308 로 넘기니 www 없이 적어요. 원포트 문서에 있지만 이 카탈로그는 스쿨오더(학교) · 오피스오더(회사)에서 파는 AI 구독 상품이에요. 회사용 카탈로그는 도구 이름이 달라요 — search_ai_subscriptions · get_ai_subscription_product · quote_ai_subscription · list_ai_subscription_providers 네 개이고(학교 구매 안내는 없어요), serverInfo 이름은 officeorder-catalog 예요. 인자 이름은 아래 학교용과 같고, s2b_only 는 없고 category 는 회사용 분류 이름이에요. 학교용 이름으로 부르면 「그런 도구가 없어요」가 와요. 크레딧을 스쿨오더 · 오피스오더 어디서 샀는지와는 상관없어요 — 카탈로그는 넣은 주소로만 갈려요.

Claude Code 에 붙이기
claude mcp add --transport http schoolorder https://schoolorder.kr/mcp

Claude Code 의 모델까지 원포트로 쓰려면 ANTHROPIC_BASE_URL=https://oneport.kr(끝에 /v1 없이) · ANTHROPIC_AUTH_TOKEN=sk-so-… · ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5 세 줄이에요(「Claude Code」 장 첫 설정). ANTHROPIC_API_KEY 가 같이 있으면 Claude Code 가 그 값을 x-api-key 로도 보내고(Claude Code 동작) 저희는 x-api-key 를 먼저 읽어요 — 예전에 넣어 둔 sk-so- 키여도 그 값이 먼저 읽히니 지우세요. MCP 를 붙이는 일과는 따로예요.

(벤더 동작)은 그 회사 앱이 정하는 부분이라 앱이 바뀌면 달라질 수 있다는 표시예요.

Cursor — ~/.cursor/mcp.json (벤더 동작)
{ "mcpServers": { "schoolorder": { "url": "https://schoolorder.kr/mcp" } } }

회사에서 쓰시면 이름과 주소만 바꿔요.

Claude Code 에 붙이기 — 회사용
claude mcp add --transport http officeorder https://officeorder.co.kr/mcp
Cursor — 회사용 (벤더 동작)
{ "mcpServers": { "officeorder": { "url": "https://officeorder.co.kr/mcp" } } }

Claude Desktop 은 설정 → 커넥터 → 「커스텀 커넥터 추가」에서 이름은 아무거나(예: schoolorder) 적고, 주소 칸에 https://schoolorder.kr/mcp 를 넣어 추가해요. 회사면 이름은 officeorder, 주소는 https://officeorder.co.kr/mcp 예요. 키가 없으니 머리글 · OAuth 칸(고급 설정)은 비워 둬요. 설정 파일(claude_desktop_config.json)에는 이 주소를 바로 넣지 못해요 — 커넥터 화면으로 붙이세요. 커스텀 커넥터는 Anthropic 서버가 대신 붙어서 학교 · 회사 PC 의 방화벽과는 상관없어요(벤더 동작).

Claude Team · Enterprise 계정이면 커스텀 커넥터는 소유자만 추가해요 — 소유자가 관리자 설정 › 커넥터에서 넣으면 멤버는 커넥터 목록에서 그 커넥터의 [연결]만 눌러요. 멤버 화면에서 추가가 막혀 보이면 이 경우예요. 화면이 한국어면 커스텀 커넥터가 「사용자 지정」으로 보이고, 처음 도구를 부를 땐 허용 창이 떠요(셋 다 벤더 동작 · 10월 기준).

부를 수 있는 것#

  • search_school_saas — 이름이나 제공사로 상품을 찾아요.
  • get_school_saas_product — 그 상품의 기간·계정수별 값을 전부 봐요.
  • quote_school_saas — 수량을 넣으면 총액과 함께 결재에 올릴 견적서 링크를 만들어요. 부르기만 해서는 주문이 생기지 않아요 — 링크를 열어 보는 견적서예요. 수량은 계정 수가 아니라 고른 옵션의 개수예요 — 「5계정 묶음」 옵션에 수량 2 면 10계정이에요. 옵션 줄에 「(N계정 묶음)」이 없으면 한 개가 1계정(토큰 팩이면 한 팩)이라 30석이면 수량 30이에요. 계정이 아닌 단위로 파는 상품은 괄호가 그 단위예요 — 「(10명)」 옵션 한 개가 10명, 「(50대)」면 50대예요. 같은 기간 옵션이 플랜마다 따로 있을 수 있어서(옵션 이름으로 갈려요) 어느 플랜인지 모르면 짐작하지 말고 손님께 물어보세요. 옵션 값은 그 기간 · 묶음 전체 값이고(계정당 · 월당 아님), 합계는 단가 × 수량이에요(수량 할인이 있으면 단가에 반영돼요 · 부가세 포함).
  • list_school_saas_providers — 지금 공급하는 제공사를 훑어봐요.
  • school_purchase_guides — 학교장터 구매 흐름 · 예산 · 품의 서류 · 세금계산서 · 계정 발급처럼 「어떻게 사나」를 안내해요. slug 없이 부르면 목록이 나와요. 자주 쓰는 slug 는 s2b-ai-purchase(S2B 로 사는 법) · school-ai-purchase-approval(품의 올리는 법) · school-purchase-documents(증빙 · 서류) · education-office-ai-adoption(교육청 · 기관 단위 도입)이에요.
도구인자
search_school_saasquery(찾을 말) · category(분류 이름 — AI 어시스턴트 · AI 검색·리서치 · AI 글쓰기·문서 · AI 이미지 · AI 영상 · AI 음성·음악 · 영상·이미지 편집 · 디자인·제작 · 수업·학습 도구 · 게임형 학습·퀴즈 · 협업·보드 · 코딩·개발 · 생산성·기타 · 어학·교양 코스 · tools/list 의 inputSchema 와 같은 목록 · 없는 이름이면 「그런 분류가 없어요」와 고를 수 있는 이름이 와요) · s2b_only(학교장터 등록만 · true/false) · limit(기본 20 · 많아야 50). query · category 가운데 하나를 넣거나 s2b_only 를 true 로 넣어요 — s2b_only: false 만 넣으면 「찾을 말이나 분류 중 하나는 넣어 주세요.」가 와요
get_school_saas_productslug(필수 — 찾기 결과에 나와요)
quote_school_saasslug · option_id(둘 다 필수 — option_id 는 상품 보기 결과의 옵션 줄 끝 [option_id: …]) · quantity(기본 1 · 999 까지 — 더 크게 넣으면 999 개로 셈해요 · 견적서와 같은 상한)
school_purchase_guidesslug · query(둘 다 안 넣어도 돼요)
list_school_saas_providers없음

찾기 → 상품 보기에서 option_id 받기 → 견적 순서로 불러요. 답은 글 줄로 와요 — 찾기는 상품마다 「- <상품 이름> (<제공사>) · slug: <slug> · 최저 <값>원부터」 한 줄(학교장터에 등록된 상품은 끝에 「 · 🏫 학교장터 등록」), 상품 보기는 「가격 옵션 (부가세 포함):」 아래로 옵션마다 「- <옵션 이름> · <N>개월 · <값>원 [option_id: <id>]」 한 줄(묶음이면 개월 뒤에 「 (N계정 묶음)」 — 계정이 아닌 단위로 파는 상품은 「 (10명)」 · 「 (50대)」처럼 그 단위로 · 기간이 없는 옵션엔 개월이 없어요), 견적은 「<상품 이름> · <옵션 이름> · <수량>개」 · 「단가 <값>원」(수량 할인이 걸리면 뒤에 「 (수량 할인 적용)」) · 「합계 <값>원 (부가세 포함)」 · 빈 줄 · 「견적서·품의 서류: https://schoolorder.kr/store/quote-sheet?option=<option_id>&qty=<수량>&pack=1」이에요. 도구(tools)만 열어요 — resources · prompts 는 없어요(부르면 -32601 Method not found). 학교용에 회사 · 기관 전용 상품 slug 를 넣으면 값 대신 「회사·기관용 상품이라 스쿨오더에서는 팔지 않아요」와 오피스오더 상품 주소가 와요. 구매를 잠시 멈춘 상품 · 옵션은 값 · 합계 · 견적서 링크 대신 멈춘 까닭 한 줄과 「견적문의: <주소>」가 와요(찾기 줄엔 「최저 … 원부터」가 없어요 — 스토어에서 준비중 · 일시중지인 상품도 같아요 · 상품 보기에서 옵션 하나만 멈췄으면 나머지 옵션 줄은 그대로 와요) — 그 주소로 문의를 남겨 주세요. 판매를 끝낸 상품과 스토어에서 준비중 · 일시중지인 상품은 「<이름> — 지금 판매하지 않는 상품이에요.」(준비중 · 일시중지는 다음 줄에 「상세: <상품 주소>」가 붙어요 · 2026-11-01 부터), 다시 열리면 알려 드리는 상품은 「<이름>은 지금 구매가 멈춰 있어요. 알림 받기: <주소>」로 와요 — 모두 값 · 견적서 링크가 없어요. 그 견적 구성으로는 주문이 안 서면 합계 다음에 그 까닭이 한 줄 와요 — 추가 상품만 담았으면 「추가 상품은 기본 요금제와 함께 주문해 주세요.」, 새 ChatGPT Business 워크스페이스를 2석 미만으로 담았거나 기관 전체 이용 상품을 2 이상 담았어도 그 조건을 말하는 한 줄이 와요(견적서 링크는 그대로 와요 · 2026-11-01 부터). 상품 보기에서 추가 상품(예: 클라우드 녹화)은 요금제 옵션과 섞이지 않고 「함께 쓰면 좋은 추가:」 아래로 따로 와요. 분류나 s2b_only 로 좁힌 찾기에 맞는 상품이 없으면 견적문의 줄 없이 「… 에 맞는 상품이 없어요.」만 와요 — 좁힌 조건을 풀고 다시 찾아요. 회사용 도구도 같아요.

🏫 학교장터 등록 표시와 s2b_only 는 옵션을 보고 붙어요 — 학교장터에 아직 안 올린 옵션만 있는 상품엔 안 붙어요(2026-11-01 부터). 상품 보기에서 그런 옵션 줄 끝엔 「 · 학교장터 등록은 준비 중이에요」가 붙고, 그 옵션으로 낸 견적엔 합계 다음에 「이 플랜은 홈페이지에서 주문해요. 학교장터 등록은 준비 중이에요.」가 와요 — 학교장터로 사실 거면 다른 옵션을 골라요. 상품 보기의 「학교장터(S2B) 물품번호: …」 줄엔 등록을 마친 번호만 오고, 어느 옵션 번호인지 알면 「번호 (옵션 · N개월)」로 와요 — 등록 상태를 못 읽으면 이 줄이 없어요. 🏫 는 등록 상태까지 보지는 않아서, 🏫 인데 물품번호 줄이 없을 수 있어요. 학교장터에서 살 때 쓸 번호는 견적서 품목 줄 아래 「S2B 물품식별번호 …」로 확인하세요 — 그 줄에 번호가 안 찍혔으면 고객센터로 물어 주세요.

quote_school_saas 의 견적서 링크는 열 때의 판매가와 날짜로 그려져요 — 발행일은 연 날, 유효기간은 그날부터 14일이고, 다른 날 다시 열면 발행일 · 견적 번호가 바뀌어요(같은 날 같은 구성이면 번호가 같아요). 링크는 로그인 없이 열려요. 그사이 값이 바뀌었으면 도구가 말한 합계와 다를 수 있어요. 결재에 올릴 땐 링크를 열어 견적서의 「PDF로 저장 / 인쇄」로 저장한 장을 쓰세요. 저장하면 종이의 QR · 링크가 그날 번호 · 금액을 얼린 주소로 바뀌어요 — 나중에 그 QR 로 열어도 종이와 같은 번호 · 금액이 나와요(그 주소를 못 만들면 지금 견적서 주소로 찍혀요). 견적서 위 편집 칸에서 기관명 · 기간 · 수량을 바꿀 수 있고(품목이 여럿인 견적서는 기관명 · 시작일만), 기관명을 넣으면 「OO 귀중」 · 안 넣으면 「귀 기관 귀중」으로 나와요. 주문은 견적서의 「이 견적으로 주문하기」로 이어가요(그 단추 대신 문의 안내가 서는 견적도 있어요). 이 링크는 서류 세트라 견적서 뒤에 상품 소개 · 거래·증빙 안내 장이 한 벌로 같이 저장돼요. 회사용 quote_ai_subscription 도 같은 견적서예요. 주소가 https://officeorder.co.kr/store/quote-sheet 로 오고, 유효기간 14일과 「PDF로 저장 / 인쇄」도 같아요.

여러 상품을 한 장에 담으려면 견적서 주소에 option=<option_id>:<수량> 을 품목마다 하나씩 이어 붙여요(예: https://schoolorder.kr/store/quote-sheet?option=<id1>:20&option=<id2>:5&pack=1). 한 장에 30줄까지이고 합계가 한 줄로 나와요(상품 소개 장은 상품마다 한 장). 합계 대신 「하나를 고르는 안」으로 놓으려면 &compare=1 을 붙여요 — 주문도 고른 안 하나로 해요. 링크 끝에 &to=<기관명>(60자까지)을 붙이면 처음부터 「<기관명> 귀중」으로 열려요. 예산이 정해져 있으면 품목이 한 줄인 견적서 위 「품의 문구·예산 확인」을 펼쳐 「예산이 정해져 있나요?」에 금액을 넣어요 — 그 예산에 담기는 수량 · 기간 안을 바로 보여 줘요(PDF 엔 안 찍혀요).

붙었는지 확인하기#

도구 목록 받아 보기
curl -s -X POST https://schoolorder.kr/mcp -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
도구 하나 불러 보기
curl -s -X POST https://schoolorder.kr/mcp -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_school_saas","arguments":{"query":"ChatGPT","limit":3}}}'
Windows PowerShell 5.1 에서 — 도구 이름 다섯 줄이 나오면 붙은 거예요(PowerShell 의 curl 은 다른 명령의 별칭이라 위 curl 줄은 그대로 안 돼요 · PowerShell 동작)
$r = Invoke-RestMethod -Method Post -Uri 'https://schoolorder.kr/mcp' -ContentType 'application/json' -Body '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
$r.result.tools.name
브라우저에서 (localhost 개발 화면) — 회사 도메인에 올리면 이 코드는 서버로 옮겨요(아래 「안 붙을 때」)
const res = await fetch("https://schoolorder.kr/mcp", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/list" }),
});
const { result } = await res.json(); // result.tools

도구 다섯 개 이름(search_school_saas · get_school_saas_product · quote_school_saas · school_purchase_guides · list_school_saas_providers)이 오면 붙은 거예요. initialize 를 보내면 serverInfo 이름이 schoolorder-catalog 로 와요. Streamable HTTP 방식이고, 그 안에서 스트림 없이 JSON 한 덩어리로 답하는 모양이라 세션 · SSE 를 열지 않아요. initialize 없이 tools/call · tools/list 를 바로 불러도 돼요. initialize 의 protocolVersion 은 보낸 값(YYYY-MM-DD 꼴)을 그대로 돌려줘요 — 안 보내면 2025-06-18 이에요. tools/list 는 도구를 한 번에 다 줘요(nextCursor 없음) — 도구마다 name · description · inputSchema 셋이에요. Accept 에 text/event-stream 을 넣어도 답은 늘 application/json 이고, notifications/initialized 같은 알림엔 202 빈 몸통이라 안 보내도 돼요. id 없이(알림 꼴로) 보낸 tools/call 은 돌리지 않고 답도 없어요 — 도구를 부를 땐 id 를 붙여요. JSON-RPC 묶음(배열)은 20개까지예요 — 넘거나 빈 배열이면 하나도 돌리지 않고 HTTP 400 · error.code -32600(Invalid Request)이에요. 찾을 말(query)은 앞 200자만 봐요. 답은 result.content[0].text 에 글로 와요. isError: true 는 없는 도구 이름(「그런 도구가 없어요: <이름>」)과 도구 안 실패 둘뿐이고, JSON-RPC 오류가 아니라 글로 와요. 찾을 말이 비었거나 없는 분류(고를 수 있는 이름이 같이 와요) · 상품 · 옵션이면 isError 없이 글로 와요 — 없는 상품이면 「그런 상품이 없어요: <slug>」, 그 상품에 없는 옵션이면 「그 상품에 그런 옵션이 없어요: <option_id>」예요. 글을 읽고 인자를 고쳐 다시 불러요. 상품 보기 · 견적에서 상품 정보를 잠깐 못 읽으면 「그런 상품이 없어요」가 아니라 isError: true 로 「도구 실행에 실패했어요: 현재 상품 정보를 불러오지 못했어요.」가 와요(2026-11-01 부터) — 인자는 그대로 두고 잠시 뒤 다시 불러요. 회사용에서는 오피스오더가 팔지 않는 상품도 「그런 상품이 없어요」에 견적문의 주소가 붙어요. 학교용에서 찾은 slug 는 회사용 찾기로 다시 받으세요. 회사용은 위 curl 의 주소를 https://officeorder.co.kr/mcp 로, 도구 이름을 search_ai_subscriptions 로 바꿔요. 도구 네 개가 오고 initialize 의 serverInfo 이름은 officeorder-catalog 예요.

안 붙을 때#

  • 주소는 POST 로만 받아요 — 브라우저로 열면 405 가 정상이에요.
  • Claude Code · Cursor 는 쓰시는 PC 에서 바로 schoolorder.kr 로 붙어요(벤더 동작) — 학교망이 막고 있으면 안 붙으니 같은 PC 에서 위 curl 을 불러 보세요. 저희 서버는 IP 를 가리지 않아요. 응답은 Content-Type: application/json; charset=utf-8 로 와서 Windows PowerShell 5.1 의 Invoke-RestMethod 로 확인해도 한글 설명을 그대로 읽어요(PowerShell 동작).
  • SSE 방식으로는 못 붙어요. HTTP(Streamable HTTP)로 붙이세요 — Claude Code 는 --transport http 예요.
  • 브라우저 페이지에서 받는 Origin 은 schoolorder.kr · officeorder.co.kr · localhost · 127.0.0.1 네 곳이에요 — 포트 · http/https 는 안 보고, www. 가 붙은 주소는 아니에요. 이 네 곳에서 부르면 응답에 CORS 머리글(Access-Control-Allow-Origin 에 그 페이지의 Origin)이 와서 fetch 로 답을 읽어요. 다른 주소(손님 회사 도메인 · 192.168… 같은 내부 주소 · [::1] · 파일로 연 페이지)에서는 CORS 머리글이 안 와서 fetch 가 TypeError 로 끝나요(문장은 브라우저마다 달라요 — 크롬은 Failed to fetch) — 화면 코드에는 403 이 안 보여요. 403 origin not allowed 는 curl 처럼 Origin 을 직접 실어 부를 때만 보여요. Origin 머리글이 없는 요청(데스크톱 · 터미널 도구 · 서버에서 부른 요청)은 다 받아요.
  • 사전 요청에 실을 수 있는 머리글은 Content-Type · Accept · Mcp-Protocol-Version · Mcp-Session-Id 넷이에요. Mcp-Session-Id 는 막히지 않게 열어 둔 것뿐이고 서버가 세션 id 를 주지 않으니 안 실어도 돼요. Authorization, AI API 를 브라우저에서 부를 때 싣는 anthropic-dangerous-direct-browser-access, 추적 도구가 붙이는 traceparent · sentry-trace 같은 머리글이 실리면 사전 요청에서 막혀요. 쿠키는 받지 않으니 credentials: "include" 로 부르지 마세요. 사전 요청 답은 600초 동안 다시 묻지 않아요.
  • 손님 회사 웹 화면(운영 도메인)에서 쓰려면 손님 서버가 대신 불러 화면에 넘겨 주세요 — 손님 도메인을 더하는 설정은 없어요. 브라우저의 Origin 머리글을 그대로 넘기는 프록시 · rewrite 는 403 이니 Origin 을 빼고 넘겨요. 같은 화면에서 원포트 API(sk-so- 키)도 부르신다면 그 키는 브라우저에 두지 말고 서버에서만 써요.
  • Claude Desktop 에서 붙었는지는 새 대화의 도구(커넥터) 메뉴에 붙일 때 적은 이름(예: schoolorder · 회사면 officeorder)이 켜져 있는지로 봐요(벤더 동작). 위 curl 로 도구(학교용 다섯 개 · 회사용 네 개)가 오는데 거기 안 보이면 Claude 쪽 커넥터 설정부터 보세요. 새 대화에서 「스쿨오더에서 ChatGPT 찾아 줘」처럼 물어 「slug: …」가 든 줄이 오면 도구가 불린 거예요 — PC 에서 curl 이 되는 건 서버가 살아 있다는 뜻일 뿐이에요(커넥터가 붙는 길은 위 Claude Desktop 문단).

모델을 부르는 API 요청(https://oneport.kr/v1) 안에 쓰시는 원격 MCP 서버를 붙일 수는 있어요 — /v1/messages 는 tools 의 mcp_toolset 과 몸통 맨 위 mcp_servers, /v1/responses 는 tools 의 type "mcp" 예요. 이 도구엔 따로 요금이 없고 토큰만 사용해요. 학생 키로는 403 student_key_blocked 예요. 스페이스 전송 정책을 켠 키도 이 칸 · 도구를 실으면 403 space_content_policy(code unsupported_capability)예요. 싣는 모양(베타 머리글 등)은 모델 회사 문서를 따라요(벤더 동작).