Editores de código e agentes de CLI

Editores de código e agentes de linha de comando recebem a URL do servidor e um token em um cabeçalho. Gere um token na sua página de perfil (um por ferramenta, para poder cortar o acesso de qualquer uma delas isoladamente) e mantenha-o fora dos arquivos que você versiona.

Nos exemplos, o token é lido da variável de ambiente PUBLICWWW_TOKEN ou pedido uma única vez; quando um cliente não consegue fazer nenhuma das duas coisas, YOUR_TOKEN representa o próprio token. O Claude Code está na página do Claude.

VS Code

O modo agente do GitHub Copilot. Adicione ao .vscode/mcp.json do projeto ou à configuração do usuário (paleta de comandos: 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}" }
    }
  }
}

O VS Code pede o token na primeira vez que o servidor é iniciado e o guarda no seu armazenamento de segredos, não no arquivo. O mesmo com um clique: Instalar no VS Code.

Cursor

~/.cursor/mcp.json para todos os projetos, ou .cursor/mcp.json em um projeto específico:

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

Ou com um clique: Adicionar ao Cursor; ele lê o token de PUBLICWWW_TOKEN.

Devin Desktop (antigo Windsurf)

~/.config/devin/mcp_config.json; no Windows, %APPDATA%\devin\mcp_config.json:

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

Use url: o antigo serverUrl só é entendido pelo agente Cascade anterior.

Gemini CLI

Como extensão: ela pede o token uma única vez, guarda-o no chaveiro do sistema e traz uma skill com a sintaxe de consulta:

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

Ou manualmente em ~/.gemini/settings.json; a chave para um servidor Streamable HTTP é httpUrl:

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

Com url em vez de httpUrl, o Gemini CLI usaria o antigo transporte SSE, que este servidor não oferece.

Codex CLI

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

ou o mesmo manualmente em ~/.codex/config.toml; o Codex lê o token da variável indicada:

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

O Codex também pode fazer login via OAuth em vez de usar um token:

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

Codex em um servidor via SSH. Depois que você clica em Permitir, o navegador é enviado para http://127.0.0.1:<port>/callback?code=…, um endereço em que só o próprio Codex escuta, no servidor, então o seu navegador mostra um erro de conexão. Copie esse endereço inteiro da barra de endereços e, enquanto o codex mcp login ainda estiver aguardando, abra-o no servidor:

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

O Codex informa que o login foi concluído. O código funciona uma única vez e por dez minutos, e o endereço precisa vir da mesma execução de codex mcp login.

DeepSeek Harness

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

O plugin conecta o servidor pelo cliente MCP do próprio DeepSeek Harness e lê o token de PUBLICWWW_TOKEN; veja a página do plugin.

Outros clientes

Qualquer cliente que consiga adicionar um servidor MCP remoto via Streamable HTTP e definir um cabeçalho de requisição vai funcionar com a URL e o cabeçalho Authorization: Bearer. Um cliente que só inicia servidores locais pode chegar a este pela ponte mcp-remote (requer 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" }
    }
  }
}

Arquivos prontos para todos esses clientes, uma skill de agente com a sintaxe de consulta e os botões de instalação estão no GitHub.

A ausência de espaço depois de Authorization: é proposital: alguns clientes passam incorretamente argumentos que contêm espaços, então a parte com o espaço fica em env.