개발자용

클라이언트가 서버에 대해 알아야 할 내용과, 어시스턴트 없이 서버를 직접 호출하는 방법입니다.

저희 서버가 제공하는 프로토콜

  • https://api.publicwww.com/mcp의 Streamable HTTP입니다. POST 한 번에 JSON-RPC 메시지 하나(배치도 허용)를 보내며, 응답은 일반 application/json입니다. 서버 전송 이벤트(SSE)도, 세션도 없으며 모든 요청에 토큰이 들어갑니다. GET은 405를 반환합니다.
  • 두 세대의 프로토콜을 같은 URL에서 제공합니다. initialize 핸드셰이크를 쓰는 개정판(2024-11-05부터 2025-11-25까지)과, server/discover를 쓰는 2026-07-28 개정판입니다. 후자에서는 버전과 클라이언트 기능이 모든 요청의 params._meta에 담기며, Mcp-Method / Mcp-Name이 본문과 일치해야 합니다.
  • 토큰이 없거나 삭제된 토큰이면 모든 요청에 401이 반환되며, 보호된 리소스 메타데이터(RFC 9728)를 가리키는 WWW-Authenticate 헤더가 포함됩니다. OAuth 클라이언트는 이 메타데이터에서 인가 서버를 찾습니다. 인증 흐름은 애플리케이션용 OAuth 2.1에 있습니다.
  • 도구는 search와 account이며, 도구에 설명되어 있습니다. 리소스와 프롬프트는 없으며, 도구 목록은 호출 사이에 바뀌지 않습니다.
  • 토큰 없이도 서버 카드에서 서버의 이름, 주소, 프로토콜 버전, 링크를 확인할 수 있습니다. 서버 카드는 https://publicwww.com/.well-known/ai-catalog.json에 등록되어 있습니다. 도구 목록은 카드에 포함되지 않으며, 클라이언트가 토큰을 받은 뒤 tools/list로 가져옵니다.

curl로 호출하기

서버는 호출 사이에 상태를 저장하지 않으므로, 핸드셰이크 없이 바로 도구를 호출할 수 있습니다. 

curl https://api.publicwww.com/mcp \
     -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
          "params":{"name":"search","arguments":{"query":"\"angular.min.js\"","rows":3}}}'

입력 스키마를 포함한 도구 목록: 

curl https://api.publicwww.com/mcp \
     -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

이 호출들과 계정 확인을 하나로 묶은 스크립트: mcp-curl.sh.

검색 결과만 필요한 스크립트라면 REST API가 더 간단합니다. 같은 검색과 같은 토큰을 쓰며, CSV, NDJSON 등 다양한 형식을 지원합니다.

다음 언어