Code-Editoren und CLI-Agenten

Code-Editoren und Kommandozeilen-Agenten erhalten die Server-URL und ein Token in einem Header. Erstellen Sie ein Token auf Ihrer Profilseite - eines pro Tool, sodass jedes einzeln gesperrt werden kann - und halten Sie es aus Dateien heraus, die Sie committen.

In den Beispielen wird das Token aus der Umgebungsvariablen PUBLICWWW_TOKEN gelesen oder einmalig abgefragt; wo ein Client beides nicht kann, steht YOUR_TOKEN für das Token selbst. Claude Code finden Sie auf der Seite Claude.

VS Code

Der Agent-Modus von GitHub Copilot. Fügen Sie dies in .vscode/mcp.json im Projekt ein oder in die Benutzerkonfiguration (Befehlspalette: 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 fragt beim ersten Start des Servers nach dem Token und legt es in seinem Geheimnisspeicher ab, nicht in der Datei. Dasselbe mit einem Klick: In VS Code installieren.

Cursor

~/.cursor/mcp.json für alle Projekte oder .cursor/mcp.json für ein einzelnes:

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

Oder mit einem Klick: Zu Cursor hinzufügen - das Token wird aus PUBLICWWW_TOKEN gelesen.

Devin Desktop (ehemals Windsurf)

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

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

Verwenden Sie url: Das ältere serverUrl versteht nur der frühere Cascade-Agent.

Gemini CLI

Als Erweiterung - sie fragt einmalig nach dem Token, legt es im Schlüsselbund des Systems ab und bringt einen Skill mit der Suchsyntax mit:

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

Oder von Hand in ~/.gemini/settings.json - der Schlüssel für einen Streamable-HTTP-Server ist httpUrl:

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

Mit url statt httpUrl würde Gemini CLI den älteren SSE-Transport verwenden, den dieser Server nicht anbietet.

Codex CLI

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

oder dasselbe von Hand in ~/.codex/config.toml; Codex liest das Token aus der angegebenen Variablen:

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

Codex kann sich statt mit einem Token auch per OAuth anmelden:

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

Codex auf einem Server über SSH. Nachdem Sie auf „Zulassen“ geklickt haben, wird der Browser zu http://127.0.0.1:<port>/callback?code=… weitergeleitet - einer Adresse, auf der nur Codex selbst lauscht, und zwar auf dem Server; Ihr Browser zeigt daher einen Verbindungsfehler. Kopieren Sie die gesamte Adresse aus der Adressleiste und öffnen Sie sie auf dem Server, solange codex mcp login noch wartet:

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

Codex meldet die Anmeldung als abgeschlossen. Der Code funktioniert nur einmal und nur zehn Minuten lang, und die Adresse muss aus demselben Lauf von codex mcp login stammen.

DeepSeek Harness

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

Das Plugin verbindet den Server über den eigenen MCP-Client von DeepSeek Harness und liest das Token aus PUBLICWWW_TOKEN - siehe die Plugin-Seite.

Alles andere

Jeder Client, der einen Remote-MCP-Server über Streamable HTTP hinzufügen und einen Request-Header setzen kann, funktioniert mit der URL und dem Authorization: Bearer-Header. Ein Client, der nur lokale Server startet, erreicht diesen über die Brücke mcp-remote (erfordert 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" }
    }
  }
}

Fertige Dateien für all diese Clients, ein Agent-Skill mit der Suchsyntax und die Installations-Buttons finden Sie auf GitHub.

Das fehlende Leerzeichen nach Authorization: ist Absicht: Manche Clients geben Argumente mit Leerzeichen fehlerhaft weiter, daher steht der Teil mit dem Leerzeichen in env.