REZICS로 이동

개발자

AI 에이전트는 /mcp로 연결합니다.

REZICS는 /mcp에서 원격 MCP 서버를 제공합니다. 에이전트는 승인된 토큰으로 연결하고, 현재 권한에 따라 사용할 수 있는 도구를 확인합니다. 각 도구는 하나의 HTTP 작업에 대응합니다.

중계

MCP는 중계만 담당합니다.

도구 호출은 같은 토큰과 멱등성 키를 담아 해당 HTTP 작업으로 한 번만 전달됩니다. 누가 작업하는지, 무엇을 할 수 있는지, 요청 한도를 얼마나 사용하는지는 해당 작업이 결정합니다.

도구가 읽은 작품 본문과 웹페이지 텍스트는 모두 데이터로 취급하며 명령으로 사용하지 않습니다.

짙은 청회색 종이에 줄지어 뚫린 구멍 사이로 연한 파란 종이 띠가 위아래로 지나갑니다.

연결

네 단계로 연결

  • 리소스 메타데이터 읽기

    GET /.well-known/oauth-protected-resource/mcp

    토큰이 없는 요청은 401을 받습니다. 헤더는 승인 서버와 지원 범위가 적힌 메타데이터를 가리킵니다.

  • 등록하고 토큰 받기

    RFC 7591 · PKCE

    에이전트 클라이언트는 직접 등록한 뒤 승인 코드와 PKCE로 토큰을 받을 수 있습니다. 등록만으로 리소스 권한이 부여되지는 않습니다.

  • 도구 목록 표시

    tools/list

    목록에는 현재 이 ID로 사용할 수 있는 도구만 표시됩니다.

  • 도구 호출

    tools/call

    HTTP 상태 코드, 헤더, 본문을 그대로 결과에 담아 반환하며 상태 코드가 400 이상이면 오류로 표시합니다.

같은 작업

에이전트 호출도 같은 HTTP 작업으로 전달됩니다.

  • 프로그램

    GET /v1/search/catalogue
  ?q=여행&limit=5

  • 에이전트

    {
  "name": "search_catalogue",
  "arguments": {
    "query": {
      "q": "여행",
      "limit": 5
    }
  }
}
    tools/call로 이 매개변수를 보냅니다.

같은 응답

operationId
  getV1SearchCatalogue
profile
  public-catalogue-ranked-v1

“여행”으로 목록을 검색합니다(예시). 에이전트도 같은 응답을 받고, 바깥에 HTTP 상태 코드와 헤더가 추가됩니다. 매개변수는 HTTP 작업에 따라 path, query, headers, body로 나뉩니다.

도구

도구 목록

도구는 API 기능 선언에서 생성됩니다. 선언에는 도구 이름, 용도, 필요한 권한 범위가 적힙니다. 이름이 중복되거나 해당 작업이 없으면 생성에 실패합니다.

목록 읽기

  • search_catalogue

    키워드로 목록 검색

    GET /v1/search/catalogue · work:read

  • read_resource

    리소스 하나 읽기

    GET /v1/resources/{resource} · work:read context:read

  • resource_summaries

    여러 리소스 요약을 한 번에 읽기

    POST /v1/resources/summaries · work:read context:read

  • resource_relations

    리소스 연결 읽기

    GET /v1/resources/{resource}/relations · work:read

  • work_editions

    작품의 여러 버전 읽기

    GET /v1/works/{id}/releases · work:read

서재

  • library_export

    서재 전체 내보내기

    GET /v1/me/library-export · work:read rating:read

  • library_import_create

    서재 파일 업로드

    POST /v1/me/library-imports · work:read library:write

  • library_import_rows

    행별 대조 결과 확인

    GET /v1/me/library-imports/{id}/rows · work:read

  • library_import_resolve

    행에 작품 지정

    PUT /v1/me/library-imports/{id}/rows/{row} · work:read library:write

  • library_import_adopt

    목록에 없는 후보 작품 추가

    POST /v1/me/library-imports/{id}/rows/{row}/adoptions · work:read library:write work:create

  • library_import_apply

    검토한 가져오기 적용

    POST /v1/me/library-imports/{id}/apply · work:read library:write collection:edit rating:read rating:submit

  • library_import_status

    가져오기 진행 상태 확인

    GET /v1/me/library-imports/{id}/apply · work:read

  • library_import_delete

    업로드한 파일 삭제

    DELETE /v1/me/library-imports/{id} · work:read library:write

Wiki+

  • wiki_candidates

    추출한 이름 대조

    POST /v1/wiki/candidates · wiki:propose

  • wiki_validate

    추출 결과 사전 검사

    POST /v1/wiki/validations · wiki:propose

  • wiki_history

    승인된 Wiki+ 내용 읽기

    GET /v1/wiki/{work}/history · work:read

  • wiki_evidence

    주장의 출처와 인용문 읽기

    GET /v1/wiki/evidence/{id} · work:read

한도

호출별 한도

  • 30초

    도구 호출 한 번의 제한 시간입니다.

  • 1 MiB

    일반 도구 요청의 크기 한도입니다. 서재 파일 업로드는 별도로 계산합니다.

  • 무상태

    각 요청에서 토큰을 확인하며 서버는 세션을 보관하지 않습니다.

개발자

다른 페이지

같은 API로 도구를 만드세요.

프로그램으로 작품, 서재, 커뮤니티 데이터를 읽고 쓰세요. 모든 작업에 REZICS의 ID와 권한 규칙이 적용됩니다.

REZICS로 이동

제품

모듈

언어