程式碼編輯器及 CLI 代理

程式碼編輯器及命令列代理需要伺服器網址，以及放在標頭中的 Token。請在您的帳戶頁面建立 Token——每個工具一個，以便單獨切斷任何一個——並且不要把它寫在會提交到程式碼庫的檔案中。

在以下範例中，Token 從環境變數 PUBLICWWW_TOKEN 讀取，或只詢問一次；如用戶端兩者都做不到，YOUR_TOKEN 代表 Token 本身。Claude Code 的說明在 Claude 頁面。

VS Code

GitHub Copilot 的代理模式。加入到專案中的 .vscode/mcp.json，或加入到用戶設定（命令選擇區：MCP: Open User Configuration）：

{
  "inputs": [
    { "type": "promptString", "id": "publicwww-token",
      "description": "PublicWWW token", "password": true }
  ],
  "servers": {
    "publicwww": {
      "type": "http",
      "url": "https://api.publicwww.com/mcp",
      "headers": { "Authorization": "Bearer ${input:publicwww-token}" }
    }
  }
}

VS Code 會在伺服器首次啟動時詢問 Token，並把它保存在其密鑰儲存區，而不是檔案中。一鍵完成同樣設定：Install in VS Code。

Cursor

~/.cursor/mcp.json 適用於所有專案，.cursor/mcp.json 則只適用於單一專案：

{
  "mcpServers": {
    "publicwww": {
      "url": "https://api.publicwww.com/mcp",
      "headers": { "Authorization": "Bearer ${env:PUBLICWWW_TOKEN}" }
    }
  }
}

或一鍵完成：Add to Cursor——它會從 PUBLICWWW_TOKEN 讀取 Token。

Devin Desktop（前稱 Windsurf）

~/.config/devin/mcp_config.json；在 Windows 上為 %APPDATA%\devin\mcp_config.json：

{
  "mcpServers": {
    "publicwww": {
      "url": "https://api.publicwww.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

請使用 url：較舊的 serverUrl 只有上一代的 Cascade 代理才能理解。

Gemini CLI

以擴充功能形式安裝——它只會詢問 Token 一次，並把它保存在系統鑰匙圈中，同時附帶一個包含查詢語法的技能：

gemini extensions install https://github.com/publicwww-com/publicwww-mcp

或手動寫入 ~/.gemini/settings.json——Streamable HTTP 伺服器所用的鍵是 httpUrl：

{
  "mcpServers": {
    "publicwww": {
      "httpUrl": "https://api.publicwww.com/mcp",
      "headers": { "Authorization": "Bearer ${PUBLICWWW_TOKEN}" }
    }
  }
}

如用 url 代替 httpUrl，Gemini CLI 會改用較舊的 SSE 傳輸方式，而本伺服器並不支援。

Codex CLI

codex mcp add publicwww --url https://api.publicwww.com/mcp \
     --bearer-token-env-var PUBLICWWW_TOKEN

或手動在 ~/.codex/config.toml 中寫入同樣設定；Codex 會從指定的變數讀取 Token：

[mcp_servers.publicwww]
url = "https://api.publicwww.com/mcp"
bearer_token_env_var = "PUBLICWWW_TOKEN"

Codex 也可以用 OAuth 登入，而不用 Token：

codex mcp add publicwww --url https://api.publicwww.com/mcp
codex mcp login publicwww

經 SSH 在伺服器上使用 Codex。按「允許」後，瀏覽器會被導向 http://127.0.0.1:<port>/callback?code=…——這個位址只有伺服器上的 Codex 本身在監聽，因此您的瀏覽器會顯示連線錯誤。請從網址列複製整個位址，並趁 codex mcp login 仍在等待時，在伺服器上開啟它：

curl "http://127.0.0.1:<port>/callback?code=...&state=..."

Codex 會報告登入完成。授權碼只能使用一次，有效期為十分鐘，而且位址必須來自同一次 codex mcp login 執行。

DeepSeek Harness

dsh plugin --profile web add github:publicwww-com/dsh-publicwww

此插件透過 DeepSeek Harness 自己的 MCP 用戶端連接伺服器，並從 PUBLICWWW_TOKEN 讀取 Token——請參閱插件頁面。

其他用戶端

任何能透過 Streamable HTTP 新增遠端 MCP 伺服器並設定請求標頭的用戶端，只要使用上述網址及 Authorization: Bearer 標頭即可運作。只能啟動本機伺服器的用戶端，可以透過 mcp-remote 橋接程式連接本伺服器（需要 Node.js）：

{
  "mcpServers": {
    "publicwww": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.publicwww.com/mcp",
               "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_TOKEN" }
    }
  }
}

以上所有用戶端的現成設定檔、包含查詢語法的代理技能，以及安裝按鈕，都在 GitHub 上。

Authorization: 後面刻意不加空格：有些用戶端無法正確傳遞含空格的參數，因此含空格的部分放在 env 中。