Warp CLI를 Bright Data의 웹 MCP 서버에 연결하는 방법

이 블로그 글에서는 다음을 확인하실 수 있습니다:

워프(Warp)가 무엇이며, AI 기반 코딩 지원을 원하는 50만 명 이상의 개발자에게 선호되는 터미널이 된 이유.
웹 상호작용 및 데이터 추출 기능으로 확장하면 훨씬 더 효과적인 도구로 거듭나는 방법.
Warp CLI를 Bright Data Web MCP 서버와 연결하여 향상된 AI 코딩 에이전트를 만드는 방법.

자, 시작해 보겠습니다!

Warp란 무엇인가?

Warp는 Rust로 처음부터 구축된 현대적인 AI 기반 터미널입니다. 기존 터미널과 달리 Warp는 IDE와 유사한 인터페이스, 지능형 자동 완성 기능, 자연어를 이해하는 내장 AI 에이전트를 통해 명령줄 경험을 재구상합니다.

매일 50만 명 이상의 엔지니어가 Warp를 사용하며, 더 스마트하고 빠른 터미널을 원하는 개발자들에게 빠르게 필수 도구로 자리 잡았습니다.

워프의 특별한 점은 다음과 같습니다:

내장형 AI 에이전트: 워프 에이전트는 자연어 명령어를 이해하여 복잡한 CLI 구문을 외우지 않고도 스크립트 작성, 문제 디버깅, 워크플로 자동화를 지원합니다.
현대적인 텍스트 편집: 기존 터미널과 달리 Warp는 VS Code에서와 같이 멀티 커서 지원, 선택 영역, 구문 강조 표시를 통해 명령어를 편집할 수 있게 합니다.
블록: 명령어와 그 출력을 “블록”으로 그룹화하여 터미널 세션을 쉽게 탐색, 복사, 공유할 수 있습니다.
워프 드라이브: 워프 드라이브를 통해 팀 전체에서 자주 사용하는 명령어, 워크플로, 스크립트를 저장하고 공유하세요.
크로스 플랫폼: Warp는 macOS, Linux 및 Windows에서 실행되므로 운영 체제에 관계없이 워크플로를 일관되게 유지할 수 있습니다.
MCP 지원: Warp는 모델 컨텍스트 프로토콜(MCP)을 기본적으로 지원하므로 외부 도구 및 데이터 소스로 AI 기능을 확장할 수 있습니다.

마지막 요점은 특히 중요합니다. Warp의 기본 MCP 지원은 강력한 데이터 소스를 연결하고 AI 에이전트가 터미널에서 직접 사용할 수 있도록 해줍니다.

웹 MCP로 Warp의 LLM 지식 격차 극복

모든 LLM과 마찬가지로 Warp를 구동하는 AI 모델에도 지식의 한계가 존재합니다. 이들은 과거의 특정 시점을 반영하는 고정된 데이터셋으로 훈련됩니다. 즉, 최근 사건, 새로 출시된 라이브러리, 업데이트된 문서, 최신 모범 사례에 대해서는 알지 못합니다.

이 한계는 빠르게 변화하는 소프트웨어 개발 환경에서 특히 심각합니다. 최신 정보에 접근하지 못하면 AI 어시스턴트가 더 이상 사용되지 않는 API나 구식 구문을 제안하거나, 문제를 더 우아하게 해결할 수 있는 새로운 도구와 프레임워크를 아예 모를 수도 있습니다.

하지만 워프의 AI 에이전트가 웹에서 최신 문서를 검색하고, 웹사이트에서 실시간 데이터를 수집하여 정확한 최신 정보를 바탕으로 도움을 준다면 어떨까요?

바로 Bright Data의 Web MCP 서버를 사용하면 가능합니다. 이 오픈 소스 서버(이제 무료 티어도 제공!)는 웹 상호 작용 및 데이터 수집을 위한 60개 이상의 AI 지원 도구를 제공합니다.

Bright Data 웹 MCP 통합

웹 MCP 서버에서 사용할 수 있는 핵심 도구 두 가지는 다음과 같습니다:

search_engine: SERP API에 연결하여 Google, Bing 또는 Yandex에서 검색을 수행하고 검색 엔진 결과를 HTML 또는 마크다운 형식으로 반환합니다.
scrape_as_markdown: Web Unlocker를 활용하여 모든 웹 페이지의 콘텐츠를 스크래핑합니다. 봇 탐지 시스템을 우회하고 CAPTCHA를 자동으로 해결합니다.

이 외에도 브라우저 자동화를 위한 55개 이상의 전문 도구( scraping_browser_click, scraping_browser_type, scraping_browser_screenshot 등)와 Amazon, LinkedIn, Instagram, YouTube, Zillow 등 도메인의 구조화된 데이터 피드가 제공됩니다. 예를 들어 web_data_amazon_product 도구는 제품 URL만으로 Amazon에서 직접 상세한 구조화된 제품 정보를 추출합니다.

Bright Data의 Web MCP를 Warp에 연결하면 다음과 같은 작업을 수행할 수 있습니다:

모든 라이브러리 또는 프레임워크의 최신 문서를 가져와 AI가 현재 사용 가능한 비(非)비추천 코드를 제안하도록 보장합니다.
웹사이트에서 실시간 데이터를 스크래핑하여 분석, 테스트 또는 모킹을 위해 로컬 파일에 저장할 수 있습니다.
터미널에서 직접 전자상거래 사이트의 가격, 리뷰 또는 재고를 모니터링합니다.
명령줄을 벗어나지 않고 경쟁사 조사, 소셜 미디어 데이터 수집 또는 시장 정보 수집을 수행할 수 있습니다.

Warp를 Bright Data의 Web MCP에 연결하는 방법

필수 사항

시작하기 전에 다음 사항을 확인하십시오:

로컬에Node.js 설치 (최신 LTS 버전 권장).
시스템에Warp 설치 (macOS, Linux, Windows 지원).
API 키가 준비된 Bright Data 계정 (아직 계정이 없더라도 생성 과정을 안내해 드리니 걱정하지 마세요).

또한 선택사항이지만 도움이 되는 배경 지식:

MCP 작동 방식에 대한 일반적인 이해.
Bright Data 웹 MCP 서버 및 관련 도구에 대한 기본적인 이해.

1단계: Warp 설치

Warp가 아직 설치되어 있지 않다면 warp.dev로 이동하여 사용 중인 운영 체제에 맞는 버전을 다운로드하세요.

macOS의 경우:

웹사이트에서 .dmg 파일을 다운로드한 후 Warp를 응용 프로그램 폴더로 드래그하세요. 또는 Homebrew를 사용하는 경우:

brew install --cask warp

Linux의 경우:

사용 중인 배포판의 공식 설치 가이드를 따르세요. Warp는 Ubuntu, Fedora, Arch 및 기타 주요 배포판에서 사용할 수 있습니다.

Windows에서:

Warp 웹사이트에서 Windows 설치 프로그램을 다운로드하여 실행하거나 winget을 통해 설치하세요:

winget install Warp.Warp

설치 후 Warp를 실행하고 초기 설정을 완료하세요(로그인하거나 게스트로 계속 진행할 수 있습니다).

2단계: Bright Data API 키 받기

아직 Bright Data 계정이 없다면 무료로 생성하세요. 기존 계정이 있다면 로그인하세요.

다음으로 공식 안내에 따라 Bright Data API 키를 생성하세요:

Bright Data 제어판에서 계정 설정 으로 이동하세요.
API 키 추가를 클릭하세요.
권한 설정(전체 접근 권한을 위해 ‘관리자’ 권장).
저장을 클릭하세요.

API 키가 한 번 표시됩니다. 복사하여 안전한 곳에 보관하세요. 다음 단계에서 필요할 것입니다.

3단계: 로컬에서 웹 MCP 서버 테스트하기

Warp를 구성하기 전에 Bright Data 웹 MCP 서버가 여러분의 컴퓨터에서 작동하는지 확인해 보겠습니다.

먼저 Node.js가 설치되었는지 확인하려면 다음 명령어를 실행하세요:

node --version

v20.x.x 이상의 버전 번호가 표시되어야 합니다.

이제 다음 명령어로 MCP 서버를 테스트하세요:

Bash(macOS/Linux)에서:

API_TOKEN="<YOUR_BRIGHT_DATA_API_KEY>" npx -y @brightdata/mcp

PowerShell (Windows)에서:

$Env:API_TOKEN="<YOUR_BRIGHT_DATA_API_KEY>"; npx -y @brightdata/mcp

<YOUR_BRIGHT_DATA_API_KEY> 를 앞서 생성한 API 키로 대체하세요. 이 명령어는 필수 API_TOKEN 환경 변수를 설정하고 @brightdata/mcp npm 패키지를 통해 MCP 서버를 시작합니다.

모든 것이 정상적으로 작동하면 다음과 같은 출력이 표시됩니다:
mcp

첫 실행 시 MCP 서버는 Bright Data 계정에 자동으로 두 개의 영역을 생성합니다:

mcp_unlocker: 웹 언락커용 존.
mcp_browser: 브라우저 API용 영역입니다.

생성 여부를 확인하려면 Bright Data 대시보드에 로그인하여 “프록시 및 스크래핑 인프라” 페이지로 이동하세요. 두 영역이 목록에 표시되어야 합니다.

참고: API 토큰에 관리자 권한이 없는 경우 해당 존이 자동 생성되지 않을 수 있습니다. 이 경우 공식 문서에 설명된 대로 환경 변수를 사용하여 이름을 지정하며 수동으로 설정할 수 있습니다.

중요: 기본적으로 MCP 서버는 4가지 도구(search_engine, search_engine_batch, scrape_as_markdown, scrape_batch)로 Rapid Mode에서 실행됩니다. 브라우저 자동화 및 구조화된 데이터 피드를 포함한 60개 이상의 모든 도구를 사용하려면 PRO_MODE=true로 설정하여 Pro Mode를 활성화하세요:

API_TOKEN="<YOUR_BRIGHT_DATA_API_KEY>" PRO_MODE="true" npx -y @brightdata/mcp

Pro Mode 활성화 시 다음과 같이 표시됩니다:

[Bright Data MCP] 서버가 성공적으로 시작되었습니다
[Bright Data MCP] 사용 가능한 도구: 60개 이상 (프로 모드)

참고: 프로 모드의 추가 도구는 무료 계정에 포함되지 않으며 사용량에 따른 요금이 부과됩니다.

Ctrl+C로 서버를 중지하세요. 이제 Warp 설정을 진행할 준비가 되었습니다.

4단계: Warp에서 웹 MCP 구성

Warp는 MCP 서버 설정을 위한 내장 인터페이스를 제공합니다. Bright Data의 웹 MCP를 추가하는 방법은 다음과 같습니다:

Warp를 엽니다.
Cmd+P (macOS) 또는 Ctrl+P (Windows/Linux)로 명령 팔레트를 엽니다.
“MCP”를 입력하고 Open MCP Servers를 선택하세요.

또는 설정 (기어 아이콘) > AI > MCP 서버 관리로 이동합니다.

MCP 구성 패널에서 다음 JSON 구성을 추가하세요:

{
  "brightdata": {
    "command": "npx",
    "args": ["-y", "@brightdata/mcp"],
    "env": {
      "API_TOKEN": "<YOUR_BRIGHT_DATA_API_KEY>"
    }
  }
}

<YOUR_BRIGHT_DATA_API_KEY> 를 실제 Bright Data API 키로 대체하세요.

프로 모드(60개 이상의 도구):

{
  "brightdata": {
    "command": "npx",
    "args": ["-y", "@brightdata/mcp"],
    "env": {
      "API_TOKEN": "<YOUR_BRIGHT_DATA_API_KEY>",
      "PRO_MODE": "true"
    }
  }
}

선택적 설정:

Warp 실행 시 MCP 서버를 자동으로 시작하려면 "start_on_launch": true를 추가하세요.
수동으로 영역을 생성한 경우 WEB_UNLOCKER_ZONE 및 BROWSER_ZONE으로 사용자 지정 영역 이름을 지정하세요.

구성을 저장하세요.

5단계: MCP 연결 확인

설정을 저장하면 Warp가 Bright Data MCP 서버에 연결을 시도합니다.

연결을 확인하려면:

새로운 Warp 터미널 세션을 엽니다.
AI 패널에서 MCP 표시기를 찾으세요. 사용 가능한 MCP 서버로 “brightdata”가 표시되어야 합니다.
프로 모드 사용 시 55개 이상의 도구가 표시됩니다. 래피드 모드에서는 4개 도구만 표시됩니다.

AI 에이전트와 간단한 프롬프트를 실행하여 연결을 확인할 수도 있습니다. Ctrl+Shift+A (macOS에서는 Cmd+Shift+A )를 눌러 AI 패널을 열고 다음을 입력하세요:

사용 가능한 MCP 도구는 무엇인가요?

AI가 search_engine, scrape_as_markdown 등 Bright Data 도구가 포함된 목록으로 응답해야 합니다.

훌륭합니다! Warp가 Bright Data의 웹 MCP 서버에 연결되었습니다.

6단계: 첫 웹 기반 작업 실행

이제 통합 기능을 테스트해 보겠습니다. Warp의 AI 에이전트에게 다음을 요청합니다:

아마존 페이지에서 제품 데이터를 스크래핑합니다.
데이터를 로컬 JSON 파일에 저장합니다.
해당 데이터를 읽고 표시하는 Node.js 스크립트 생성.

Warp AI 패널을 열고(Ctrl+Shift+A 또는 Cmd+Shift+A) 다음 프롬프트를 입력하세요:

"https://www.amazon.com/Microfiber-Cleaning-Cloth-Performance-Washes/dp/B08BRJHJF9/"에서 데이터를 스크래핑하여 로컬 "product.json" 파일에 저장하고, 터미널에서 제품 세부 정보를 불러와 출력하는 Node.js "script.js" 파일을 생성하세요.

단계별 진행 과정은 다음과 같습니다:

Warp의 AI가 web_data_amazon_product 도구(Pro 모드) 또는 scrape_as_markdown 도구(Rapid 모드)가 필요함을 식별하고 사용자의 승인을 요청합니다.
승인되면 MCP 통합을 통해 스크래핑 작업이 실행됩니다.
스크래핑된 제품 데이터가 터미널에 표시됩니다.
AI가 구조화된 데이터로 product.json 파일을 생성합니다.
AI가 JSON 내용을 로드하고 출력하는 script.js 파일을 생성합니다.
선택적으로, AI는 스크립트 실행을 제안하여 작동 여부를 확인할 수 있습니다.

작업이 완료되면 작업 디렉터리에 product.json 및 script.js 파일이 생성됩니다.
Screenshot 2025-12-22 135704

product.json에는 스크랩된 정보가 포함되며, script.js 파일에는 다음과 같은 내용이 포함됩니다:

const fs = require('fs');

const data = JSON.parse(fs.readFileSync('product.json', 'utf8'));

console.log('제품 상세 정보:');
console.log('================');
console.log(`제목: ${data.title}`);
console.log(`가격: ${data.price}`);
console.log(`평점: ${data.rating}`);
console.log(`리뷰: ${data.reviews_count}`);
console.log(`재고 상태: ${data.availability}`);
console.log('n특징:');
data.features.forEach((feature, index) => {
  console.log(`  ${index + 1}. ${feature}`);
});

스크립트를 실행하여 모든 것이 정상적으로 작동하는지 확인하세요:

node script.js

터미널에 제품 세부 정보가 출력됩니다:

자, 이제 워크플로가 성공했습니다.

product.json의 데이터는 실제 스크래핑된 제품 정보이며, AI가 생성한 가상의 콘텐츠가 아닙니다. 이는 아마존의 강력한 봇 방지 시스템으로 인해 데이터 수집이 매우 어렵다는 점을 고려할 때 매우 중요합니다. 일반적인 LLM만으로는 이 데이터를 가져올 수 없습니다. Warp의 AI 에이전트와 Bright Data의 Web MCP의 조합이 이를 가능하게 합니다.

결론

이 튜토리얼에서는 Warp와 Bright Data의 Web MCP(이제 무료 티어가 제공됩니다!)를 연결하는 방법을 배웠습니다. 그 결과 실시간으로 웹에 접근하고 상호작용할 수 있는 강력한 CLI 코딩 에이전트가 탄생했습니다. 이 통합은 Warp의 MCP 서버에 대한 기본 지원 덕분에 가능해졌습니다.

본 가이드의 예제 작업은 의도적으로 단순화되었으나, 이 통합을 통해 훨씬 복잡한 사용 사례를 해결할 수 있음을 잊지 마십시오. Bright Data의 Web MCP 도구는 자동화된 리서치부터 경쟁사 정보 수집, 실시간 데이터 모니터링에 이르기까지 다양한 에이전트 시나리오를 지원합니다.

더 고급 에이전트를 구축하려면 Bright Data AI 인프라에서 제공하는 모든 서비스를 살펴보세요.

무료 Bright Data 계정에 가입하고 AI 지원 웹 도구로 오늘 바로 실험을 시작하세요!

문의하기 무료 체험 시작하기