로그인된 사이트를 클로드가 대신 만지게 — Aside 브라우저

클로드는 기본으로 내 브라우저 안의 로그인 상태를 모릅니다. 그래서 「사내 포털에서 지난달 청구서를 찾아 줘」 같은 부탁은 보통 막힙니다. Aside는 AI 가 일하는 브라우저이고, 내가 로그인해 둔 상태를 그대로 쓸 수 있게 클로드와 연결할 수 있습니다. 아래 말을 순서대로 한 줄씩 치면 됩니다. (예시 자료는 가짜 이름입니다.)

시작 전에

• Aside 설치 (내가 직접): aside.com/download 에 macOS 와 Windows 용이 있습니다. 회사 PC 에서 설치 권한이 없으면 관리자에게 부탁하세요. Aside 를 열면 Sign in or create an account 로 로그인합니다. 처음에는 브라우저 데이터 가져오기와 비밀번호 관리자 설정 순서가 나오는데, 회사 PC 라면 가져오기 전에 무엇이 넘어가는지(방문 기록·쿠키·북마크) 읽고 결정하세요. 무료 요금제는 매달 500 크레딧이 들어 있습니다(공식 구독 안내). Aside 의 AI 에게 일을 시키면 이 크레딧을 씁니다.
• 클로드(Claude Code): 데스크톱 앱의 Code 탭이나 터미널용입니다. 2단계부터 필요합니다. 설치는 아래 「준비물 자세히」를 보세요.
• 클로드가 명령을 실행하거나 설정을 바꾸기 전에 허락을 묻는 창이 뜨면 무엇을 하는지 읽고 허락하세요. 처음에는 이렇게 묻는 방식(Manual)이 안전합니다.
• Claude Code 없이도 됩니다. Aside 안에서 직접 시키려면 새 탭 주소창을 Ask AI 모드로 놓거나, 키보드 Ctrl+E(Mac 은 Cmd+E)로 Ask Aside 를 열고, 열린 페이지를 같이 읽히려면 Aside side panel(사이드 패널)에서 시키면 됩니다. 이 글의 말은 그대로 쓸 수 있습니다.

1단계 · Aside 에 먼저 로그인해 두기 (내가 직접)

이 단계는 클로드에게 말하지 않고 내가 직접 합니다. 클로드가 일할 사이트에 내가 먼저 들어가 로그인해 둡니다.

1. Aside 를 열고 로그인되어 있는지 봅니다(Sign in or create an account 로 들어갔던 계정).
2. 일할 사이트(예: 사내 구매 포털)를 Aside 에서 열고 내가 직접 로그인합니다. 비밀번호와 2단계 인증은 내가 칩니다. 시크릿 창이 아니라 일반 창에서 합니다(시크릿 창에서는 AI 가 비밀번호 관리자를 못 씁니다).
3. Aside 의 Settings → Passwords → Access policy for AI agents 를 열어 봅니다. 고르는 것은 Always allow(기본) · While unlocked(비밀번호 보관함이 열려 있는 동안만) · Never 셋입니다. 이 글에서는 Never 를 권합니다. 그래야 AI 가 저장된 비밀번호로 스스로 로그인하지 못하고, 안전 규칙 1번(로그인은 내가)과 맞습니다. 로그인이 풀리면 내가 다시 로그인합니다(6단계). (제 권유입니다. 공식 문서의 기본값은 Always allow 입니다.)

✅ 이렇게 나오면 성공 — Aside 의 그 사이트 탭에 로그인된 첫 화면이 보이면 다음 단계로. 이 화면은 닫지 말고 두세요.

2단계 · 클로드에게 Aside 를 연결하기 (한 번만)

클로드가 Aside 를 조종하려면 둘을 연결해야 합니다. 이 연결을 MCP 등록이라고 합니다. 등록은 내 PC 의 클로드 설정을 바꾸는 일이니, 클로드가 실행하기 전에 명령을 보여 달라고 하고 허락 창에서 읽어 보세요.

✅ 이렇게 나오면 성공 — 「Connected」(연결됨)와 「새 대화를 여세요」라는 말이 나오면 됩니다. 확인을 직접 하려면 터미널에서 claude mcp list 를 쳤을 때 aside 줄에 ✔ Connected 가 보여야 합니다. (공식 문서의 명령 꼴은 claude mcp add [옵션] <이름> -- <명령> [인자] 입니다. aside 가 길 찾기에 안 걸리면 「막히면」 1번.)

3단계 · 새 대화에서 연결 확인하고 열린 탭 읽기

지금 대화를 닫고 새 대화를 엽니다. 터미널이면 /exit 로 나갔다가 다시 claude 를 입력하고, 데스크톱 앱이면 새 대화를 시작하세요. 새 대화에서 가장 약한 일부터 시킵니다. 열려 있는 탭의 제목만 알려 달라고 합니다.

✅ 이렇게 나오면 성공 — 1단계에서 열어 둔 사이트 탭 제목이 보이면 됩니다. 「Aside 도구가 없다」고 하면 새 대화가 아닌 경우가 흔합니다(「막히면」 1번).

4단계 · 로그인된 사이트에서 읽어 오기

이제 로그인된 사이트에서 읽기만 시킵니다. 해도 되는 것과 하면 안 되는 것을 같이 말합니다.

✅ 이렇게 나오면 성공 — 내가 같은 사이트에서 직접 본 목록과 표가 맞으면 됩니다. 숫자는 한 번 눈으로 대조하세요. 클로드가 표를 옮겨 적다 틀릴 수 있습니다.

5단계 · 보내기 직전에 멈추게 하기

메일이나 게시글처럼 밖으로 나가는 일은 초안까지만 시킵니다. 공식 문서의 사용 예에도 「사내 지원 대시보드에서 답장을 쓰되 게시하지 않기」가 있습니다.

✅ 이렇게 나오면 성공 — 메일 창에 초안이 들어 있고 보내지지 않았으면 됩니다. 받는 사람 칸은 꼭 내 눈으로 확인한 뒤 내가 보냅니다.

6단계 · 사람 몫이 나오면 멈추기 (로그인 만료 · 결제)

일하다 보면 로그인이 풀리거나 결제 단추가 나옵니다. 클로드가 멈추고 나에게 넘기는 것이 정상입니다. 아래는 제 대화 기록에서 줄여 옮긴 실제 답입니다. 첫째는 2026-09-19 클라우드 저장소 구독 화면에서, 둘째는 2026-09-18 로그인이 만료됐을 때였습니다.

✅ 이렇게 나오면 성공 — 클로드가 「누르지 않는다」「사람이 해야 한다」고 말하고 화면만 열어 두면 됩니다. 내가 직접 누르거나 로그인한 뒤 「됐어」라고 말하면 이어서 합니다. 클로드가 비밀번호를 대신 쳐 보겠다고 하면 멈추고 거절하세요.

7단계 · 끝나면 탭 닫고 확인하기

일이 끝나면 클로드가 연 탭을 닫게 하고, 내가 Aside 화면에서도 확인합니다.

✅ 이렇게 나오면 성공 — Aside 의 탭 줄에서 클로드가 연 탭이 사라졌으면 됩니다. 내가 열어 둔 사이트 탭은 남겨 둬도 되지만, 일이 모두 끝났으면 닫으세요. 로그인은 Aside 에 남아 있어 다음에 다시 열 수 있습니다.

다 됐습니다 — 이제 이렇게 말하면 됩니다

Aside 를 켜고 사이트에 로그인해 둔 상태에서 말합니다.

• 「Aside 에 열린 ○○ 사이트에서 ○○ 현황을 표로 정리해 줘. 읽기만 하고 저장·제출·삭제·결제는 누르지 마.」
• 「이 화면에서 이번 주에 바뀐 것만 알려 줘. 아무것도 누르지 마.」
• 「메일 창에 초안만 써 줘. 보내기는 내가 직접 할게.」
• 「다 했으면 네가 연 탭은 닫아 줘.」

일을 시키다가 방향이 틀리면 중간에 바로잡습니다. 공식 문서의 예는 이렇습니다. 「청구 페이지 말고 송장 페이지를 써. 이메일은 보내지 마.」

막히면

1. 클로드가 Aside 도구가 없다고 한다 → 등록한 직후의 그 대화에는 도구가 안 붙습니다. 새 대화를 여세요. 그래도 안 되면 터미널에서 claude mcp list 로 aside 줄이 ✔ Connected 인지 보세요. 연결 줄이 없으면 이렇게 다시 말하세요: "claude mcp get aside 로 aside 등록이 있는지 보여 줘. 없으면 등록 명령을 실행하기 전에 보여 줘." Aside 명령이 안 잡히면 설치 직후에 새 터미널을 열지 않은 경우가 많습니다(공식 안내: 설치 프로그램이 사용자 PATH 에 추가하므로 새 터미널을 엽니다).
2. 클로드가 「로그인이 필요하다」고 하는데 나는 로그인돼 있다 → 제가 겪은 일입니다(2026-09-24). 처음엔 클로드가 화면을 너무 일찍 봤다고 짐작했지만, 30초를 기다려도 같았습니다. 진짜 이유는 Aside 가 구글에 로그인돼 있는 것과, 그 사이트(회사 시스템) 자체에 로그인된 것이 따로였기 때문입니다. 그 사이트 탭에서 내가 직접 로그인하면 풀립니다. 이렇게 말하세요: "그 탭에서 로그인된 계정 이름이 보이는지만 알려 줘. 로그인은 하지 마."
3. 인증 번호·패스키·CAPTCHA·본인 확인 화면이 나온다 → 내가 직접 합니다. 공식 문서도 그런 단계는 내가 마친 뒤 작업이 이어진다고 합니다. 이렇게 말하세요: "멈춘 곳을 알려 줘. 내가 인증하고 「됐어」라고 하면 이어서 해 줘."
4. 클로드가 엉뚱한 화면을 누르고 있다 → 바로 멈추게 하세요. 이렇게 말하세요: "멈춰. 지금까지 누른 것을 목록으로 알려 주고, 앞으로는 ○○ 화면에서만 읽어. 아무것도 보내거나 바꾸지 마." Aside 안에서 시키는 중이면 진행 중인 일에 끼어드는 Steer(바로 고치기)와 끝난 뒤에 적용하는 Queue(줄 세우기) 중 급하면 Steer 를 씁니다(공식 설명).
5. 「크레딧이 없다」고 하거나 Aside 의 AI 가 안 돈다 → 무료 요금제는 매달 크레딧이 정해져 있습니다. 제가 겪은 때(2026-09-24)에는 AI 에게 맡기는 쪽(exec)이 「402 Insufficient credits」(크레딧 부족)로 막혔고, 열린 화면을 클로드가 직접 읽는 쪽(repl)은 되었습니다. 이렇게 말하세요: "Aside 의 AI 에게 맡기지 말고, 열려 있는 탭을 직접 읽기만 해 줘."
6. 파일을 올려야 하는데 안 된다 → 제가 겪은 일입니다(2026-10-02). 클로드가 내 PC 의 파일을 업로드 칸에 넣는 것이 막혔습니다(「세션 폴더를 벗어난다」는 오류). 이렇게 말하세요: "파일 올리기는 내가 직접 할게. 올리는 화면까지만 열어 줘."
7. 크롬과 Aside 가 자꾸 꺼진다 → 제가 겪은 일입니다(2026-09-21). 공공기관 사이트에 들어가자 접속만으로 설치된 보안 프로그램이 브라우저를 계속 끝내고 있었습니다. 이렇게 말하세요: "윈도우 이벤트 로그에서 최근 Aside·크롬 오류를 찾아 원인 후보만 알려 줘. 아무것도 지우거나 끄지 마."
8. 끝났는데 사이트가 뒤에서 계속 일하는 것 같다 → 클로드가 열고 안 닫은 탭일 수 있습니다. 이렇게 말하세요: "지금 Aside 에 열린 탭을 모두 알려 주고, 네가 연 탭은 닫아 줘."

한 번에 맡기기 (익숙해진 다음에)

역할: 너는 내 PC 에서 일하는 도우미다. 클로드가 Aside 브라우저를 조종할 수 있게 연결되어 있는지 확인하고, 없으면 내가 허락한 뒤에만 연결하며, Aside 를 쓸 때 지킬 안전 규칙을 이 폴더의 CLAUDE.md 에 적어 준다. 나는 초보자이니 어려운 말은 풀어서, 한 단계씩 말해 줘.

맥락: Aside 는 AI 브라우저이고 `aside mcp` 명령이 MCP 서버로 클로드와 이어진다. 연결(MCP 등록)은 내 PC 의 클로드 설정을 바꾸는 일이다. MCP 서버는 대화가 시작될 때 한 번만 불러오므로 연결한 직후의 이 대화에는 Aside 도구가 안 붙는다. 비밀번호·키·토큰은 다루지 않는다.

입력: <운영체제>, <쓰는 클로드: Claude Code 터미널 / 데스크톱 앱의 Code 탭>, <Aside 를 이미 설치하고 로그인했는지: 예 / 아니오 / 모름>

작업:
① 확인 — 아무것도 바꾸기 전에 먼저 본다. 이 폴더의 전체 경로를 말해 준다. `aside --version` 으로 Aside 명령이 있는지, `claude mcp get aside` 로 이미 등록돼 있는지 확인한다(읽기만 하는 명령이다). 확인 명령은 실행하기 전에 한 줄로 알려 준다.
② 설치 안내 — Aside 가 없으면 설치는 하지 말고 aside.com/download 에서 내가 직접 받아 설치하고 로그인하라고만 안내한 뒤 멈춘다.
③ 연결 — 이미 등록돼 있으면 다시 등록하지 말고 ④로 간다. 없으면 등록 명령 `claude mcp add --scope user aside -- aside mcp` 를 실행 전에 내게 보여 주고 허락을 받은 뒤에만 실행한다. `aside` 가 안 잡히면 Aside 의 개발자 설정이 알려 주는 전체 경로를 쓰도록 안내만 한다.
④ 안전 규칙 — 이 폴더에 CLAUDE.md 가 이미 있으면 먼저 읽고 기존 내용을 지우지 말고 맨 아래에 「Aside 안전 규칙」 절을 덧붙인다. 없으면 새로 만든다. 절의 내용은 정확히 아래와 같다.
  - 사이트 로그인·비밀번호·2단계 인증·CAPTCHA·본인 확인은 사람이 한다. 사용자에게 비밀번호를 묻거나 파일에 적지 않는다.
  - 보내기·게시·결제·삭제·신청은 하지 않는다. 마지막 단추 직전에 멈추고 사용자에게 알린다.
  - 처음에는 읽기만 한다. 사용자가 시키지 않은 저장·제출·삭제·결제·발송 단추는 누르지 않는다.
  - 일이 끝나면 내가 연 탭을 닫고, 닫은 뒤 열린 탭 목록을 알려 준다.
⑤ 사람이 할 일 안내 — 내가 직접 할 일을 말해 준다. 가) 이 대화를 닫고 같은 폴더에서 새 대화를 연다. 나) 새 대화에서 「Aside 에 지금 열려 있는 탭 제목만 알려 줘. 아무것도 누르거나 입력하지 마」라고 시켜 본다. 지금 이 대화에서는 Aside 도구를 호출해 시험하지 않는다.

제약: 비밀키·토큰·비밀번호를 출력하거나 파일에 쓰지 않기. 오류를 건너뛰지 않기. 기존 파일을 지우거나 덮어쓰지 않기. 이 폴더 밖의 파일을 읽지도 쓰지도 않기. 프로그램을 대신 설치하지 않기. 어떤 사이트도 열거나 로그인하지 않기.

출력: 한 일, 확인된 상태(Aside 명령 있음/없음 · 등록돼 있음/없음), 바뀐 파일, 검증 결과((가)~(다) 각각 통과/실패), 내가 해야 할 일(⑤ 그대로), 남은 문제와 다음 조치.

검증: 아래가 확인돼야 「자동 확인 통과」라고 보고한다. 하나라도 실패하면 완료로 보고하지 말 것.
 (가) `claude mcp get aside` 가 aside 등록을 보여 준다(등록하지 않았다면 「등록하지 않았다」고 이유와 함께 적는다).
 (나) 이 폴더의 CLAUDE.md 에 「Aside 안전 규칙」 절이 있고 위 네 줄이 모두 들어 있으며, 기존 내용은 그대로다.
 (다) CLAUDE.md 와 출력 어디에도 비밀번호·키·토큰처럼 보이는 글자가 없다.
 단, 사람이 직접 할 ⑤는 네가 확인할 수 없으므로 「완료」가 아니라 「남은 일」로 적는다. 새 대화에서 Aside 가 열린 탭 제목을 보여 줘야 비로소 전체 완료다.

내가 만들 때는

처음엔 이렇게 시켰습니다. 2026-09-16 아침, Aside 의 윈도우판이 나와서 깔았습니다. 「내가 윈도우 aside를 깔았어.. 너가 이거 mcp나 이런거에 등록좀해줘」(08:38) 클로드가 연결을 마쳤지만 그 대화에는 도구가 안 붙었고, 새 대화부터 붙었습니다. 이 편 2단계의 「새 대화를 여세요」가 거기서 나왔습니다. 연결 뒤에 클로드가 한 말이 이 편의 출발점입니다. 그동안 로그인이 필요한 사내 페이지는 클로드가 못 건드렸는데, Aside 는 자기 브라우저에 로그인 세션을 들고 있어서 그 벽이 없어진다는 것이었습니다.

이틀 뒤 2026-09-18, 클로드는 구글과 클라우드플레어 로그인이 만료되자 「로그인은 제가 하지 않는 일」이라며 두 줄만 직접 치라고 했습니다. 저는 이렇게 말했습니다. 「aside 블라우저로 해.. 그럼 되잖아..」 클로드는 이미 로그인돼 있던 Aside 로 콘솔을 열어 올라가 있는 규칙을 읽어 왔습니다. 로그인은 사람이 했고 그 뒤의 읽기는 클로드가 했습니다. 이 편의 역할 나눔과 같습니다(6단계의 두 번째 답이 이때 클로드가 한 말입니다). 이튿날 새벽에는 한 번 더 있었습니다. 「R2 키쟈.. 안되겠다.. aside에서 데시보드 결제 페이지 까직 열어줘」(2026-09-19 00:47) 클로드는 구독 화면까지 열고, 요금표를 읽어 준 다음 약관 동의와 결제는 직접 하셔야 한다며 멈췄습니다. 6단계의 첫 번째 답이 그것입니다.

실패도 있었습니다. 9월 26일 새벽 플랫폼에 429(너무 많이 읽었다는 거절)가 났습니다. 장부로는 맞지 않아 코드를 네 갈래로 훑었지만 못 잡았고, Firebase 콘솔 사용량이 답이었습니다. 24시간 읽기 16만, 새벽 2시대 한 시간에 2.2만, 그 시간 쓰기는 0, 스냅샷 리스너(데이터가 바뀌면 알려 주는 연결)가 48개였습니다. 검증하고 닫지 않은 사내 시스템 탭 셋이 뒤에서 연결이 끊겼다 이어지기를 되풀이하며 구독을 다시 걸고 있었습니다. 그 뒤로 Aside 로 검증을 마치면 탭을 닫는 것을 규칙으로 했고, 이 편 7단계가 그 규칙입니다. 같은 일이 있은 뒤 30분 넘게 가려진 탭은 데이터 연결을 쉬게 하는 고침도 넣었지만, 사람이 닫는 것이 먼저입니다. Aside 로 파일을 올리는 일은 10월 2일에 막혔고(「세션 폴더를 벗어난다」), 제가 연결 프로그램에서 파일을 받아 화면 칸에 넣는 우회로를 찾았지만 이 글에는 넣지 않았습니다. 막히면 사람이 직접 올리는 편이 안전합니다.

→ 뒷이야기 16단계에서 이 강좌 작업에 쓴 도구를 볼 수 있고, Aside 로 콘솔을 다룬 이야기는 13단계에 있습니다.