Gemini CLI를 Chrome DevTools MCP에 연결하기

Gemini CLI가 Chrome을 조작할 수 있나요?

Gemini CLI 계정이 현재도 사용 자격을 유지한다면 가능합니다. 최신 문서는 Chrome DevTools MCP가 포함된 실험적 Browser Agent와 별도 MCP 서버 구성을 모두 설명합니다. 페이지를 열기 전에 각 경로가 어떤 Chrome 프로필이나 세션을 쓰는지 확인하세요. Gemini 사용 권한과 브라우저 로그인은 별개입니다. 일부 요금제의 종료일이 지났으므로 먼저 자격을 확인하세요. 한 사용자는 구버전 Gemini CLI가 DevTools MCP에 연결하지 못했지만 다른 클라이언트에서는 연결됐다고 보고했습니다. 연결 실패 단계를 좁히는 참고 사례입니다. GitHub #178

프로젝트에서 도구를 제공하고 계정과 승인 정책이 허용하면 가능합니다. Gemini CLI는 MCP 클라이언트입니다. Chrome DevTools MCP는 브라우저를 시작하거나 연결하고, URL 열기와 접근성 스냅샷 같은 도구를 제공합니다. 모델 인증과 브라우저 연결을 구분하세요. Connected가 보이면 이미 알고 있는 페이지로 브라우저 상태를 확인합니다. 예전 버전의 Gemini CLI에서는 다른 클라이언트가 연결한 MCP 서버에 접속하지 못했다는 제보가 있습니다. 같은 증상이 나타나면 먼저 연결 단계를 확인하세요. GitHub #178

Gemini CLI 확장 목록에도 Chrome DevTools MCP가 있습니다. 여기서는 버전과 실행 인수가 드러나는 프로젝트 설정을 사용합니다. Gemini CLI MCP 안내 Chrome DevTools 설정 브라우저의 Gemini

Google의 전환 공지는 기존 설정을 계속 쓸 수 있는 사용자를 구분합니다. 2026-11-09 기준, Google AI Pro/Ultra와 무료 Gemini Code Assist for individuals 이용자를 위한 Gemini CLI 요청 제공 종료일인 2026-06-18은 지났습니다. Google은 Standard/Enterprise 라이선스와 유료 Gemini 또는 Gemini Enterprise Agent Platform API 키 사용자는 계속 이용할 수 있다고 밝혔습니다. 이 가이드를 따르기 전에 본인의 권한을 확인하세요. 대상 사용자에게는 Gemini CLI의 브라우저 에이전트와 MCP 설정이 계속 제공됩니다. Google 전환 공지 마이그레이션 가이드

핵심 정리

• 프로젝트에 Chrome DevTools MCP를 등록하고 독립 프로필로 시작하세요.

• 연결은 gemini mcp list, 도구는 /mcp desc로 확인하세요.

• 도구가 반환한 최종 URL과 제목을 예상값과 비교하세요.

• 모델 인증, 작업공간 신뢰, 도구 승인을 따로 확인하세요.

검색과 브라우저 조작으로 확인하는 것

검색 결과로 공지를 찾을 수 있습니다. 탭의 계정이나 클릭 후 상태는 알 수 없습니다. 스냅샷은 현재 표시 내용을 보여 주지만 그 문서가 최신 공식 자료인지 판단하지 않습니다. 확인할 사실에 맞춰 도구를 선택하세요. 웹 검색과 브라우저 조작 AI 에이전트의 역할

작은 프로젝트에서 버전 고정하기

공식 문서를 바탕으로 만든 설정 예시입니다. Gemini CLI 0.67.0과 Chrome DevTools MCP 1.12.0을 사용합니다. Node.js와 Chrome 요구 사항을 확인하고 잠금 파일을 보관하세요. Chrome DevTools MCP v1.12.0

mkdir browser-mcp-check
cd browser-mcp-check
npm init -y
npm install --save-exact @google/gemini-cli@0.67.0 chrome-devtools-mcp@1.12.0
./node_modules/.bin/gemini --version
./node_modules/.bin/chrome-devtools-mcp --version

다음 서버를 프로젝트의 .gemini/settings.json에 추가하세요. 경로는 실제 로컬 실행 파일의 절대 경로로 바꿉니다. 이미 다른 설정이 있으면 서버 항목만 합칩니다.

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "/absolute/path/browser-mcp-check/node_modules/.bin/chrome-devtools-mcp",
      "args": ["--headless", "--isolated", "--no-usage-statistics"],
      "includeTools": ["new_page", "take_snapshot", "list_pages", "close_page"],
      "trust": false
    }
  }
}

includeTools는 Gemini CLI에 노출하는 도구를 제한하며 접속 도메인은 제한하지 않습니다. --isolated는 임시 프로필을 사용합니다. 직접 관리하거나 접근이 허가된 페이지에서 시작하세요. 기존 세션은 별도로 연결하고 계정을 확인합니다. Google Codelab은 전체 테스트 앱을 다룹니다. 최초 연결 점검은 제목과 링크를 아는 페이지 하나로 충분합니다. 기존 브라우저 연결 Google Codelab

작업공간을 신뢰하면 Gemini가 프로젝트 설정을 불러올 수 있습니다. trust: false에서는 도구 호출에 현재 정책이 적용됩니다. 대화 모드에서 시작하고 승인 요청이 나오면 서버 이름, 동작, URL을 확인하세요. 비대화 모드에서는 ask_user 규칙이 호출을 거부합니다. URL을 제한해야 한다면 Chrome DevTools MCP에서 별도로 설정하세요. --allowed-url-pattern 옵션에는 Chrome 149 이상이 필요합니다. Gemini CLI 정책 Chrome DevTools MCP 설정

연결을 확인한 뒤 실제 페이지 확인하기

프로젝트에서 ./node_modules/.bin/gemini mcp list를 실행하세요. 신뢰하는 작업공간에서는 프로젝트 설정을 불러올 수 있습니다. Gemini CLI 대화 화면에서 /mcp desc를 실행해 도구와 매개변수를 확인하세요. 모델 접근은 별도로 설정합니다. 인증 방법

같은 조건에서 다시 확인하려면 두 번째 터미널에서 테스트 프로젝트를 열고 로컬 페이지를 띄우세요. 제목은 “MCP browser check”이고 링크는 #details를 가리킵니다. 도구 결과에서 두 항목을 확인하세요.

mkdir -p fixture
cat > fixture/index.html <<'HTML'
<!doctype html>
<meta charset="utf-8">
<title>MCP browser check</title>
<h1>MCP browser check</h1>
<a href="#details">Details</a>
<p id="details">Local fixture</p>
HTML
python3 -m http.server 8765 --bind 127.0.0.1 --directory fixture

이 예시의 버전에서는 new_page가 반환한 ID를 pageId로 take_snapshot에 전달합니다. 리디렉션이 발생할 수 있으므로 실제 반환된 URL과 제목을 확인하세요. v1.12.0 도구 문서

chrome-devtools MCP로 http://127.0.0.1:8765/을 여세요. 페이지 ID, 최종 URL, 주요 제목과 예상 링크를 반환하세요. 받은 페이지 ID로 스냅샷을 읽습니다. 접근에 실패하면 오류를 알려 주세요. 로그인 정보를 입력하거나 제출, 변경하지 마세요.

기본 Browser Agent와 기존 MCP 설정 중 고르기

현재 Gemini CLI 문서에는 번들된 Chrome DevTools MCP를 실행하는 실험적 browser_agent가 나옵니다. 기본적으로 꺼져 있고 Chrome 144 이상이 필요하며 처음 사용할 때 동의를 요청합니다. persistent는 Gemini CLI 프로필, isolated는 임시 프로필, existing은 원격 디버깅을 켠 실행 중인 Chrome에 연결합니다. 별도 MCP 서버 설치보다 간단한 경로지만 여전히 Chrome 경로이며 Tabbit 프로필을 자동으로 선택하지 않습니다. Browser Agent 안내와 최신 릴리스 노트를 확인하세요.

같은 컴퓨터의 로그인된 Tabbit에는 Tabbit CLI 사용

Gemini CLI가 Tabbit이 설치된 컴퓨터에서 실행되면 사용자 ~/.agents/skills/의 Agent Skills를 검색할 수 있습니다. /skills list로 확인한 다음 Tabbit Skill을 활성화하도록 요청하고 권한 안내가 나오면 승인하세요. Skill 검색은 안내를 읽을 수 있다는 뜻일 뿐입니다. CLI 프로세스가 로컬 Tabbit 실행기를 호출할 권한이 있어야 하고, 실행기가 목표 사이트에 로그인된 Tabbit 인스턴스에 연결되어야 합니다. 항목별로 확인하세요. 원격 Gemini CLI는 지원되는 로컬 핸드오프가 구성되지 않으면 데스크톱 Tabbit에 자동 연결되지 않습니다. Gemini CLI Skill 검색 Tabbit CLI 설정

공개 릴리스 노트 한 페이지를 읽고 검토용 초안을 만드는 예시입니다. Gemini 전용 /tabbit 명령은 가정하지 않습니다.

이 로컬 Gemini CLI 세션에서 설치된 Tabbit Skill과 Tabbit CLI를 사용하세요. 별도 작업 탭으로 릴리스 노트 페이지를 열고 현재 버전의 날짜와 기능 항목만 읽으세요. 버전, 날짜, 기능, 출처 URL, 사람이 확인해야 할 항목을 담은 "Release notes review — draft 01" 초안을 만드세요. 원본 페이지를 편집하거나 초안을 게시하지 마세요. 검토할 수 있도록 초안과 링크를 보여 주세요. Skill이 없거나 shell에서 Tabbit 실행기를 실행할 수 없거나 페이지가 로그아웃이면 실패한 항목을 알리고 멈추세요.

작업 탭은 평소 Tabbit 창과 분리되어 계속 작업할 수 있습니다. 이 환경에서는 로컬 테스트 페이지로 Tabbit CLI의 로그인 세션 재사용을 확인했지만 Gemini CLI를 통해 테스트하지 않았으므로 두 제품의 통합을 입증하지는 않습니다. 실제 로컬 runtime과 계정을 확인한 뒤 사용하세요. 이전하는 방법은 Antigravity CLI 가이드를 참고하세요. 그 CLI의 브라우저 기능은 Tabbit CLI와 별도입니다.

오류가 난 단계 확인하기

등록에 실패하면 설정 범위, 버전과 전송을 점검하세요. 한 사용자는 이전 Gemini CLI에서 연결되지 않았지만 다른 클라이언트에서는 연결됐다고 보고했습니다. Apple Silicon을 쓰는 다른 사용자는 PATH의 Intel용 Node가 MCP 실행에 쓰인 것을 발견했습니다. 각각의 환경에서 생긴 일입니다. 설정을 바꾸기 전에 실행 파일과 아키텍처를 확인합니다. 원래 이슈 Reddit 원문

페이지가 열려도 스냅샷에 실패하면 스키마를 확인하고 응답의 페이지 ID를 사용하세요. 로그인 화면이 뜨면 작업을 중단하고 필요한 사용자 조치를 기록합니다. 로그인 세션 확인

재현할 수 있는 결과 남기기

CLI, 서버, 브라우저 버전, 설정 범위, 모드, 도구 목록, 최종 URL, 페이지 ID와 기대 결과를 저장합니다. 승인과 실패가 발생한 단계를 기록하면 다시 실행할 때 차이를 좁힐 수 있습니다. 첫 브라우저 작업 연결 방법 선택 에이전트 브라우저란

Gemini CLI에서 Chrome의 현재 상태가 필요하다면 프로젝트에 서버를 등록하고 결과를 아는 페이지부터 확인하세요. 도구를 하나씩 추가할 때도 확인 가능한 결과를 정하세요.

Secholar.L

Tabbit 그로스 & 콘텐츠

Secholar.L은 AI 브라우저와 에이전트 워크플로우에 대한 실용적인 가이드를 작성하며, 실제 조사와 검증 가능한 출처를 바탕으로 도구를 비교합니다.