代码编辑器与命令行智能体

代码编辑器和命令行智能体需要服务器 URL，以及放在请求头中的令牌。请在您的个人中心生成令牌，每个工具一个，以便单独停用其中任何一个；并且不要把令牌写入要提交到代码仓库的文件。

在示例中，令牌从环境变量 PUBLICWWW_TOKEN 读取，或者只询问一次；如果客户端两者都不支持，YOUR_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 会在服务器首次启动时询问令牌，并将其保存在自身的密钥存储中，而不是文件里。也可以一键完成同样的配置：在 VS Code 中安装。

Cursor

对所有项目生效请使用 ~/.cursor/mcp.json，仅对单个项目生效请使用该项目中的 .cursor/mcp.json：

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

或者一键添加：添加到 Cursor，令牌从 PUBLICWWW_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

以扩展形式安装：它只询问一次令牌，将其保存在系统钥匙串中，并附带一项包含查询语法的技能（skill）：

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 会从指定的环境变量读取令牌：

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

Codex 也可以不用令牌，而是通过 OAuth 登录：

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 读取令牌，详见插件页面。

其他客户端

任何能够通过 Streamable HTTP 添加远程 MCP 服务器并设置请求头的客户端，只要配置上述 URL 和 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 中。