Install the Sidekick AI extension

Sidekick AI 확장 설치

Install Sidekick AI from Firefox Add-ons, then open the sidebar: View → Sidebar → Sidekick AI. Leave Desktop AI bridge on in Settings.

Firefox 부가 기능에서 Sidekick AI를 설치한 뒤 사이드바를 엽니다: 보기 → 사이드바 → Sidekick AI. 설정의 Desktop AI 연동은 켜 두세요.

Install Sidekick AI from the Chrome Web Store, then open the side panel. Leave Desktop AI bridge on in Settings.

Chrome 웹 스토어에서 Sidekick AI를 설치한 뒤 사이드 패널을 엽니다. 설정의 Desktop AI 연동은 켜 두세요.

Install Sidekick AI from Edge Add-ons, then open the side panel. Leave Desktop AI bridge on in Settings.

Edge 추가 기능에서 Sidekick AI를 설치한 뒤 사이드 패널을 엽니다. 설정의 Desktop AI 연동은 켜 두세요.

You do not need to unpack or sideload the extension. Store installs keep a stable ID.

압축 해제·사이드로드는 필요 없습니다. 스토어 설치는 확장 ID가 고정됩니다.

Install Claude Desktop

Claude Desktop 설치

Install the Claude desktop app (not only claude.ai in a browser). After the bridge command runs, you must fully quit Claude — including the tray icon — then open it again.

브라우저의 claude.ai가 아니라 Claude 데스크톱 앱을 설치합니다. 브리지 명령을 실행한 뒤에는 트레이 아이콘까지 Claude를 완전히 종료한 다음 다시 켭니다.

Install ChatGPT Codex — not regular ChatGPT

ChatGPT Codex 설치 — 일반 채팅이 아닙니다

Use the ChatGPT desktop app’s Codex workspace, or Codex CLI. The normal ChatGPT chat window and web connectors cannot read a local browser tab.

ChatGPT 데스크톱 앱의 Codex 작업 공간, 또는 Codex CLI를 사용합니다. 일반 ChatGPT 채팅과 웹 커넥터는 이 PC의 브라우저 탭을 읽지 못합니다.

Install Node.js 18 or newer

Node.js 18 이상 설치

The local bridge runs on Node.js. Install the LTS build, then reopen the terminal.

로컬 브리지는 Node.js로 동작합니다. LTS를 설치한 뒤 터미널을 다시 여세요.

node -v

The version should start with 18, 20, 22, or newer.

버전이 18, 20, 22 또는 그 이상이어야 합니다.

Keep the bridge folder in a permanent place

브리지 폴더를 고정 위치에 두기

You need the bridge folder from the Sidekick AI project (the folder that contains src/install-windows.js and src/mcp-server.js). Unzip or copy it somewhere you will not delete, then run setup from that folder. Moving it later breaks Claude and Codex.

Sidekick AI 프로젝트의 bridge 폴더가 필요합니다 (src/install-windows.js, src/mcp-server.js가 있는 폴더). 지우지 않을 위치에 풀거나 복사한 뒤, 그 폴더에서 설치를 실행하세요. 나중에 옮기면 Claude·Codex 연결이 깨집니다.

Suggested location: %LOCALAPPDATA%\SidekickAI\app\bridge ~/Library/Application Support/SidekickAI/app/bridge

권장 위치: %LOCALAPPDATA%\SidekickAI\app\bridge ~/Library/Application Support/SidekickAI/app/bridge

Run the Windows setup command

Windows 설치 명령 실행

Firefox is registered automatically. Open Command Prompt or PowerShell in the bridge folder:

Firefox는 자동으로 등록됩니다. 브리지 폴더에서 명령 프롬프트 또는 PowerShell을 여세요:

node src\install-windows.js

Copy the extension ID from chrome://extensions (Developer mode on). Then:

chrome://extensions에서 확장 ID를 복사합니다 (개발자 모드 켜기). 그다음:

node src\install-windows.js --chrome-id YOUR_CHROME_ID

Copy the extension ID from edge://extensions (Developer mode on). Then:

edge://extensions에서 확장 ID를 복사합니다 (개발자 모드 켜기). 그다음:

node src\install-windows.js --edge-id YOUR_EDGE_ID

The script registers the native host, and merges sidekick-browser into Claude and Codex config files when those apps exist. Other MCP servers are left as they are.

스크립트가 Native host를 등록하고, 앱이 있으면 Claude·Codex 설정에 sidekick-browser를 병합합니다. 다른 MCP 서버는 그대로 둡니다.

Firefox on Windows needs a small .exe host. The script builds it with .NET Framework 4 (csc.exe). If the browser has the file locked, close Firefox/Chrome/Edge and run the command again.

Windows Firefox는 .exe host가 필요합니다. 스크립트가 .NET Framework 4(csc.exe)로 빌드합니다. 브라우저가 파일을 잠그면 브라우저를 모두 닫고 명령을 다시 실행하세요.

Using more than one browser? Pass both IDs in one command:

브라우저를 여러 개 쓰나요? 한 명령에 ID를 같이 넣으세요:

node src\install-windows.js --chrome-id YOUR_CHROME_ID --edge-id YOUR_EDGE_ID

macOS setup is not ready yet

macOS 설치는 아직 준비 중입니다

The current setup script is Windows-only. A signed helper for macOS is planned with the one-click installer. You can still install the browser extension and use sidebar chat today.

지금 설치 스크립트는 Windows 전용입니다. macOS용 서명된 도우미는 원클릭 설치기와 함께 제공할 예정입니다. 브라우저 확장과 사이드바 채팅은 지금 바로 사용할 수 있습니다.

When the helper ships, native-host files will go under ~/Library/Application Support/Google/Chrome/NativeMessagingHosts, Microsoft Edge, and Mozilla, and MCP config will use ~/Library/Application Support/Claude/claude_desktop_config.json and ~/.codex/config.toml.

도우미가 나오면 Native host는 ~/Library/Application Support/Google/Chrome/NativeMessagingHosts, Microsoft Edge, Mozilla 아래에 두고, MCP 설정은 ~/Library/Application Support/Claude/claude_desktop_config.json 과 ~/.codex/config.toml 을 사용합니다.

Reload the browser, then restart the desktop app

브라우저 다시 로드 후 데스크톱 앱 재시작

1. In Firefox: about:addons → Sidekick AI → Reload (or restart Firefox).
2. Firefox: about:addons → Sidekick AI → 다시 로드 (또는 Firefox 재시작).
3. In Chrome: chrome://extensions → Sidekick AI → Reload.
4. Chrome: chrome://extensions → Sidekick AI → 새로고침.
5. In Edge: edge://extensions → Sidekick AI → Reload.
6. Edge: edge://extensions → Sidekick AI → 새로고침.
7. Open a normal https:// page (not about: or chrome:).
8. 일반 https:// 페이지를 엽니다 (about:, chrome: 아님).
9. Sidekick Settings should say the local bridge is connected.
10. Sidekick 설정에 로컬 브리지가 연결되었다고 나와야 합니다.
11. Quit Claude Desktop completely (tray icon too), then open it again.
12. Claude Desktop을 트레이까지 완전히 종료한 뒤 다시 실행합니다.
13. Quit the ChatGPT app completely, then open Codex again.
14. ChatGPT 앱을 완전히 종료한 뒤 Codex를 다시 엽니다.

Confirm Claude MCP

Claude MCP 확인

Settings → Local MCP servers: sidekick-browser should be running. Tools appear in the chat composer (Connectors / tools), not on the settings card.

설정 → Local MCP servers에서 sidekick-browser가 running이어야 합니다. 도구는 설정 카드가 아니라 채팅 입력의 도구/Connectors에 있습니다.

If you need to paste the config yourself:

직접 붙여넣어야 하면:

Win32

%APPDATA%\Claude\claude_desktop_config.json

Microsoft Store

%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sidekick-browser": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Users\\YOUR_NAME\\AppData\\Local\\SidekickAI\\app\\bridge\\src\\mcp-server.js"]
    }
  }
}

Replace the paths with the node.exe and mcp-server.js printed by the setup command. Do not use npx.

경로는 설치 명령이 출력한 node.exe와 mcp-server.js로 바꾸세요. npx는 쓰지 마세요.

Confirm Codex MCP

Codex MCP 확인

In the ChatGPT app open Codex → Settings → MCP servers and look for sidekick-browser. Approve the tool the first time it runs.

ChatGPT 앱에서 Codex → Settings → MCP servers에 sidekick-browser가 보여야 합니다. 처음 도구를 쓸 때 승인을 요청할 수 있습니다.

Shared config file (CLI and the app use the same file):

공유 설정 파일 (CLI와 앱이 같습니다):

%USERPROFILE%\.codex\config.toml

[mcp_servers.sidekick-browser]
command = "C:\\Program Files\\nodejs\\node.exe"
args = ["C:\\Users\\YOUR_NAME\\AppData\\Local\\SidekickAI\\app\\bridge\\src\\mcp-server.js"]

Try it

사용해 보기

On an https:// page, start a new Claude or Codex chat and say:

https:// 페이지를 연 뒤 Claude 또는 Codex 새 채팅에서 이렇게 말하세요:

Use the Sidekick browser tool to read the page that is open now and summarize it. Do not use web search.

You should get the current tab’s URL and title. Change the page and ask again — it should follow the new tab without an extra “read this” step.

현재 탭 URL과 제목이 나와야 합니다. 페이지를 바꾼 뒤 다시 물으면, 따로 “읽어줘”를 말하지 않아도 새 탭을 따릅니다.