コードエディターとCLIエージェント

コードエディターやコマンドラインエージェントには、サーバーURLと、ヘッダーに設定するトークンを指定します。トークンはアカウントページで、ツールごとに1つずつ発行してください。そうすれば、どれか1つだけを個別に無効化できます。また、トークンはコミットするファイルに含めないでください。

以下の例では、トークンを環境変数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、1つのプロジェクトで使う場合は.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}" }
    }
  }
}

httpUrlの代わりにurlを使うと、Gemini CLIは旧方式のSSEトランスポートで通信しようとします。このサーバーは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

SSH経由でサーバー上のCodexを使う場合。「許可」を押すと、ブラウザはhttp://127.0.0.1:<port>/callback?code=…にリダイレクトされます。このアドレスで待ち受けているのはサーバー上のCodex自身だけなので、ブラウザには接続エラーが表示されます。アドレスバーからそのアドレス全体をコピーし、codex mcp loginが待機している間に、サーバー上で開いてください。

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

Codexにログイン完了と表示されます。コードは10分間有効で、使えるのは1回だけです。また、アドレスは同じcodex mcp loginの実行で取得したものである必要があります。

DeepSeek Harness

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

このプラグインは、DeepSeek Harness自身のMCPクライアントを通じてサーバーに接続し、トークンをPUBLICWWW_TOKENから読み込みます。詳しくはプラグインのページをご覧ください。

その他のクライアント

Streamable HTTPでリモートMCPサーバーを追加でき、リクエストヘッダーを設定できるクライアントであれば、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に入れています。

次へ n8n、Make、Zapier