Lab 04. MCP 체험

• MCP 첫 경험: 이론보다 먼저, 일단 하나 붙여 본다
• Browser MCP (Playwright): 가장 가벼운 MCP. 자체 Chromium 포함
• 첫 사용: 에이전트가 실제 웹페이지를 열어 내용을 읽어 온다
• 보안 감각: 브라우저 MCP 의 신뢰 경계

MCP(Model Context Protocol)는 Claude 에 외부 도구·데이터를 붙이는 표준 프로토콜입니다. 왜·어떻게는 Lab 05 에서 깊이 봅니다. 지금은 하나 붙여서 동작을 눈으로 확인합니다.

가장 쉬운 첫 MCP 는 브라우저입니다. 자체 Chromium 을 포함하므로 기존 Chrome 설치와 무관합니다.

npx playwright install chromium

처음 한 번만 받아 두면 됩니다.

claude mcp add 로 붙입니다. claude 세션 밖, 일반 터미널에서 실행합니다.

claude mcp add playwright -- npx @playwright/mcp@latest --browser chromium --headless

• --browser chromium: “Chrome not found” 회피
• --headless: 화면 없는 환경(WSL2)에서도 동작

연결 상태를 확인합니다.

claude mcp list

playwright: connected 가 보이면 됩니다. 이제 세션을 엽니다.

claude

세션에서 이렇게 요청합니다.

https://example.com 을 열어서 페이지 제목과 대표 헤딩 텍스트를 알려줘.

에이전트가 페이지를 직접 열어 내용을 읽어 옵니다.

AWS 문서·지식을 에이전트가 바로 참고하게 하면 아키텍처를 구상하거나 비용을 추정할 때 편합니다. 공식 AWS Labs MCP 서버 2개를 붙여 봅니다.

claude 세션 밖, 일반 터미널에서 실행합니다. --scope user 는 전역 설치(내 모든 프로젝트)를 뜻합니다: 빼면 현재 프로젝트에만 붙습니다.

# uv 설치 (uvx 실행에 필요 — 이미 있으면 건너뜀, Lab 06 에서도 사용)
curl -LsSf https://astral.sh/uv/install.sh | sh

# AWS 공식 문서 검색·조회
claude mcp add aws-documentation-mcp-server --scope user -e AWS_DOCUMENTATION_PARTITION=aws -e FASTMCP_LOG_LEVEL=ERROR -- uvx awslabs.aws-documentation-mcp-server@latest

# AWS 지식(베스트프랙티스·리전 정보 등) — 원격 HTTP 서버
claude mcp add --transport http aws-knowledge-mcp-server --scope user https://knowledge-mcp.global.api.aws

붙인 뒤 확인합니다.

claude mcp list

세션에서 이렇게 활용해 봅니다.

“S3 + CloudFront 정적 호스팅 구성을 추천하고, 서울 리전 기준 월 예상 비용을 개략적으로 추정해줘.”

브라우저 MCP 는 신뢰 경계가 아닙니다. 임의의 사이트를 방문하면 그 페이지 내용이 간접 프롬프트 인젝션으로 작동할 수 있습니다. 데모·실습은 신뢰된 사이트만 여세요.

자세한 MCP 보안은 Lab 05 이론에서 이어집니다.