Editores de código y agentes CLI

Los editores de código y los agentes de línea de comandos usan la URL del servidor y un token en un encabezado. Crea un token en tu página de perfil (uno por herramienta, para poder cortar el acceso a cualquiera de ellas por separado) y no lo guardes en archivos que subas al repositorio.

En los ejemplos, el token se lee de la variable de entorno PUBLICWWW_TOKEN o se pide una vez; cuando un cliente no puede hacer ninguna de las dos cosas, YOUR_TOKEN representa el propio token. Claude Code está en la página de Claude.

VS Code

El modo agente de GitHub Copilot. Añade esto a .vscode/mcp.json en el proyecto, o a la configuración de usuario (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}" }
    }
  }
}

VS Code pide el token la primera vez que se inicia el servidor y lo guarda en su almacenamiento de secretos, no en el archivo. Lo mismo en un clic: Instalar en VS Code.

Cursor

~/.cursor/mcp.json para todos los proyectos, o .cursor/mcp.json para uno solo:

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

O en un clic: Añadir a Cursor; lee el token de PUBLICWWW_TOKEN.

Devin Desktop (antes Windsurf)

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

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

Usa url: el antiguo serverUrl solo lo entiende el agente Cascade anterior.

Gemini CLI

Como extensión: pide el token una vez, lo guarda en el llavero del sistema e incluye una skill con la sintaxis de consultas:

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

O a mano en ~/.gemini/settings.json; la clave para un servidor Streamable HTTP es httpUrl:

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

Con url en lugar de httpUrl, Gemini CLI usaría el antiguo transporte SSE, que este servidor no ofrece.

Codex CLI

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

o lo mismo a mano en ~/.codex/config.toml; Codex lee el token de la variable que se le indique:

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

Codex también puede iniciar sesión con OAuth en lugar de usar un token:

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

Codex en un servidor por SSH. Después de hacer clic en «Permitir», el navegador va a http://127.0.0.1:<port>/callback?code=…, una dirección en la que solo escucha el propio Codex, en el servidor, así que tu navegador muestra un error de conexión. Copia esa dirección completa de la barra de direcciones y, mientras codex mcp login sigue esperando, ábrela en el servidor:

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

Codex indica que el inicio de sesión se ha completado. El código funciona una sola vez y durante diez minutos, y la dirección tiene que proceder de la misma ejecución de codex mcp login.

DeepSeek Harness

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

El plugin conecta el servidor a través del cliente MCP propio de DeepSeek Harness y lee el token de PUBLICWWW_TOKEN; consulta la página del plugin.

Cualquier otro cliente

Cualquier cliente que pueda añadir un servidor MCP remoto por Streamable HTTP y definir un encabezado de solicitud funcionará con la URL y el encabezado Authorization: Bearer. Un cliente que solo inicia servidores locales puede llegar a este a través del puente mcp-remote (necesita 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" }
    }
  }
}

Los archivos listos para usar de todos ellos, una skill para agentes con la sintaxis de consultas y los botones de instalación están en GitHub.

Sin espacio después de Authorization: a propósito: algunos clientes pasan mal los argumentos que contienen espacios, así que la parte con el espacio va en env.