前往 REZICS

開發者

你的 AI 代理，從 /mcp 進來。

REZICS 在 /mcp 提供遠端 MCP 伺服器。代理帶著你授權的權杖連線，看到的工具依它目前的權限列出，每個工具都對應一個 HTTP 操作。

轉接

MCP 只負責轉接，不是另一條寫入的路。

每次工具呼叫只轉送一次到對應的 HTTP 操作，帶著同一個權杖與冪等鍵。誰在行動、能做什麼、用掉多少請求額度，都由那個操作決定。

工具讀到的作品內文與網頁文字一律當成資料，不會當成指令。

一張深藍灰色的紙上打了一排圓孔，一條淺藍色紙帶在孔間一上一下穿過。

連線

連線的四個步驟

  • 讀取資源中繼資料

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

    沒有權杖的請求會收到 401，標頭指向這份中繼資料，裡面寫明授權伺服器與支援的範圍。

  • 登記並取得權杖

    RFC 7591 · PKCE

    代理的用戶端可以自行登記，再以授權碼加 PKCE 取得權杖。登記本身不給任何資源權限。

  • 列出工具

    tools/list

    清單只列出這個身分目前能用的工具。

  • 呼叫工具

    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 的身分與授權規則。

前往 REZICS

產品

模組

語言