코드 에디터와 CLI 에이전트

코드 에디터와 명령줄 에이전트에는 서버 URL과 헤더에 넣을 토큰을 설정합니다. 프로필 페이지에서 도구마다 토큰을 하나씩 발급하면 필요할 때 하나만 따로 차단할 수 있습니다. 토큰은 커밋하는 파일에 넣지 마세요.

예시에서는 토큰을 환경 변수 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, 특정 프로젝트에만 적용하려면 그 프로젝트의 .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분 동안 한 번만 사용할 수 있으며, 주소는 같은 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