Редактори коду та CLI-агенти

Редактори коду й агенти командного рядка приймають 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

Як розширення - воно один раз запитує токен, зберігає його в системному сховищі ключів і додає навичку із синтаксисом запитів:

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

Codex на сервері через SSH. Після того як ви натиснете «Дозволити», браузер перейде на 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

Плагін підключає сервер через власний MCP-клієнт DeepSeek Harness і читає токен із PUBLICWWW_TOKEN - див. сторінку плагіна.

Інші клієнти

Будь-який клієнт, що вміє додавати віддалений MCP-сервер через Streamable HTTP і задавати заголовок запиту, працюватиме з цим 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.