Kod düzenleyiciler ve CLI ajanları

Kod düzenleyiciler ve komut satırı ajanları sunucu URL'sini ve başlıkta bir token alır. Profil sayfanızda bir token oluşturun (her araç için ayrı bir token; böylece herhangi birinin erişimini tek başına kesebilirsiniz) ve token'ı commit ettiğiniz dosyalara koymayın.

Örneklerde token PUBLICWWW_TOKEN ortam değişkeninden okunur ya da bir kez sorulur; istemcinin ikisini de yapamadığı yerlerde YOUR_TOKEN token'ın kendisi yerine geçer. Claude Code, Claude sayfasında anlatılıyor.

VS Code

GitHub Copilot'un ajan modu. Projedeki .vscode/mcp.json dosyasına ya da kullanıcı yapılandırmasına (komut paleti: MCP: Open User Configuration) ekleyin:

{
  "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, sunucu ilk kez başlatıldığında token'ı sorar ve onu dosyada değil, kendi gizli bilgi deposunda saklar. Aynısı tek tıklamayla: VS Code'a yükle.

Cursor

Tüm projeler için ~/.cursor/mcp.json, tek bir proje için .cursor/mcp.json:

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

Ya da tek tıklamayla: Cursor'a ekle; token'ı PUBLICWWW_TOKEN değişkeninden okur.

Devin Desktop (eski adıyla Windsurf)

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

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

url anahtarını kullanın: eski serverUrl anahtarını yalnızca önceki Cascade ajanı anlar.

Gemini CLI

Uzantı olarak: token'ı bir kez sorar, sistem anahtar zincirinde saklar ve sorgu sözdizimini içeren bir beceri (skill) getirir:

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

Ya da elle ~/.gemini/settings.json dosyasında; Streamable HTTP sunucusu için anahtar httpUrl olmalıdır:

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

httpUrl yerine url yazılırsa Gemini CLI, bu sunucunun sunmadığı eski SSE aktarımını kullanır.

Codex CLI

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

ya da aynısı elle ~/.codex/config.toml dosyasında; Codex token'ı kendisine belirtilen değişkenden okur:

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

Codex token yerine OAuth ile de giriş yapabilir:

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

SSH ile bağlanılan bir sunucuda Codex. “İzin ver” düğmesine bastıktan sonra tarayıcı http://127.0.0.1:<port>/callback?code=… adresine yönlendirilir; bu adresi yalnızca sunucudaki Codex dinler, bu yüzden tarayıcınız bir bağlantı hatası gösterir. Adres çubuğundaki adresin tamamını kopyalayın ve codex mcp login hâlâ beklerken bu adresi sunucuda açın:

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

Codex girişin tamamlandığını bildirir. Kod yalnızca bir kez ve on dakika boyunca geçerlidir; adres de aynı codex mcp login çalıştırmasından gelmelidir.

DeepSeek Harness

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

Eklenti sunucuyu, DeepSeek Harness içindeki yerleşik MCP istemcisi üzerinden bağlar ve token'ı PUBLICWWW_TOKEN değişkeninden okur; ayrıntılar eklenti sayfasında.

Diğer istemciler

Streamable HTTP üzerinden uzak bir MCP sunucusu ekleyebilen ve bir istek başlığı ayarlayabilen her istemci, bu URL ve Authorization: Bearer başlığıyla çalışır. Yalnızca yerel sunucu başlatabilen bir istemci bu sunucuya mcp-remote köprüsüyle ulaşabilir (Node.js gerekir):

{
  "mcpServers": {
    "publicwww": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.publicwww.com/mcp",
               "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_TOKEN" }
    }
  }
}

Bunların hepsi için hazır dosyalar, sorgu sözdizimini içeren bir ajan becerisi ve kurulum düğmeleri GitHub üzerinde.

Authorization: sonrasında boşluk bilerek yok: bazı istemciler içinde boşluk olan argümanları yanlış aktarır, bu yüzden boşluklu kısım env içinde duruyor.