開發人員

用戶端需要了解的伺服器資料，以及如何在沒有助理居中的情況下直接呼叫它。

我們所提供的協定

Streamable HTTP，位於 https://api.publicwww.com/mcp：每個 POST 一則 JSON-RPC 訊息（亦接受批次），回應為一般的 application/json。沒有伺服器推送事件（server-sent events），也沒有工作階段——每個請求都附帶其 Token。GET 會返回 405。
同一網址同時支援兩代協定：使用 initialize 交握的修訂版（2024-11-05 至 2025-11-25），以及使用 server/discover 的 2026-07-28 版——後者的版本及用戶端功能會隨每個請求放在 params._meta 中傳送，而 Mcp-Method / Mcp-Name 必須與內容相符。
沒有 Token 或 Token 已被刪除時，任何請求都會返回 401，並附上 WWW-Authenticate 標頭，指明受保護資源中繼資料（RFC 9728）；OAuth 用戶端可從中找到授權伺服器。流程請參閱供應用程式使用的 OAuth 2.1。
工具：search 及 account，詳見工具。沒有 resources，也沒有 prompts，而且工具列表在各次呼叫之間不會改變。
無須 Token，伺服器名片（server card）即可描述伺服器：名稱、位址、協定版本及連結。它列於 https://publicwww.com/.well-known/ai-catalog.json 中。工具列表不屬於名片的一部分；用戶端取得 Token 後，可經 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 是更簡單的途徑：同樣的搜尋及 Token，並提供 CSV、NDJSON 等格式。

下一頁語言