증상: Toolkit은 깔렸는데 MCP·npm·AWS API만 따로 실패할 때

2026년 5월 6일 전후로 AWS Agent Toolkit과 AWS MCP Server GA 소식이 겹치면서, 국내 검색에도 «Cursor에 AWS 붙이기», «Claude Code MCP aws», «Codex Bedrock» 같은 조합이 빠르게 늘었습니다. 공식 흐름은 단순해 보입니다. npm이나 패키지 매니저로 Toolkit CLI·Skills 번들을 받고, IDE 설정에 MCP 엔드포인트를 등록한 뒤, IAM·SSO로 자격 증명을 맞추고 Bedrock·Lambda·CDK 같은 AWS API를 에이전트가 대신 호출합니다. 그러나 현장에서는 «설치 로그는 끝났는데 IDE 패널만 Connecting», «npm install은 ECONNRESET», «MCP tools list는 되는데 InvokeModel만 403»처럼 부분 실패가 훨씬 흔합니다.

이 패턴은 회선 전체가 죽었다기보다, Clash 분류에서 서로 다른 호스트 묶음이 DIRECT·GEOIP·광역 프록시 줄에 엇갈려 매칭될 때 자주 나타납니다. 브라우저로 AWS 콘솔은 열리는데 터미널 에이전트만 끊기면, OS 시스템 프록시와 TUN·HTTPS_PROXY 무시 조합을 함께 의심해야 합니다. AI coding agent는 한 화면처럼 보여도 TLS 레벨에서는 npm CDN·GitHub 릴리스·MCP 전송·리전별 API 엔드포인트가 동시에 움직입니다.

아래 접미사·YAML은 출발점일 뿐입니다. 반드시 본인 세션의 SNI·Host로 다시 적고, 회사 SSL 검사·사내 패키지 프록시·금지 리전 정책을 먼저 확인하세요. 규제 우회·약관 위반 용도로 쓰면 안 됩니다.

AWS Agent Toolkit과 MCP Server가 네트워크를 나누는 이유

AWS Agent Toolkit은 Skills·워크플로 템플릿·CLI 래퍼를 묶어 Cursor, Claude Code, OpenAI Codex, Windsurf 등에 «AWS 작업» 컨텍스트를 넣는 쪽에 가깝습니다. 같은 날 GA된 AWS MCP Server는 도구 목록·리소스 읽기·일부 제어 평면 호출을 Model Context Protocol로 IDE에 노출합니다. 로컬에서는 stdio 파이프로 붙는 경우가 많지만, 초기 설치·업데이트·원격 브리지·자격 증명 갱신 순간에는 여전히 HTTPS가 열립니다.

한 줄로 «amazonaws.com만 프록시»라고 묶으면 Bedrock·STS·S3·사내에 이미 DIRECT로 두었던 다른 AWS SaaS까지 같이 끌려와 오탐이 커집니다. 반대로 npm·GitHub만 직결로 두고 API만 해외 노드를 타면, 패키지 설치 중 REST가 우연히 같은 그룹을 타거나, API는 빠른데 npm CDN tarball만 다른 출구로 가며 재현 로그가 꼬입니다. 실무에서는 AWS-MCP·AWS-API·NPM-REGISTRY·GITHUB-CDN처럼 역할별 select 그룹을 두고, OpenClaw 에이전트 분리 글이나 Cursor 3 에디터·API 분리 글과 같은 뼈대를 AWS 축에 맞게 바꿉니다.

장기적으로는 Rule Providers로 접미사 목록을 밖으로 빼고, 로컬 YAML에는 충돌이 적은 최소 행만 남기면 팀 공유·감사에 유리합니다.

축 설계: npm·GitHub·MCP·AWS API를 proxy-group으로 나누기

디버깅 로그에 읽히는 이름만 맞추면 그룹 라벨은 자유롭지만, 아래 네 덩어리로 시작하면 MCP 분류 해석이 쉽습니다.

  • NPM-REGISTRY: registry.npmjs.org, npmjs.com 등 패키지 메타·tarball. Toolkit·MCP 서버 npm 패키지 설치가 여기서 먼저 막히면 IDE는 «MCP 설정 오류»처럼 보이기도 합니다. npm·pnpm 레지스트리 분리 글과 교차 검토하세요.
  • GITHUB-CDN: github.com, githubusercontent.com, 릴리스 바이너리·raw 스크립트. Skills 저장소나 예제 워크플로를 clone·fetch할 때 대역폭이 MCP keep-alive와 경쟁합니다.
  • AWS-MCP: MCP HTTP/SSE 브리지, 문서에 나온 MCP 호스트, IDE가 띄운 MCP 헬스체크 URL. stdio만 쓰더라도 래퍼가 원격을 치면 이 축 로그가 남습니다.
  • AWS-API: aws.amazon.com, console.aws.amazon.com, docs.aws.amazon.com, Bedrock·STS·IAM 등 실제 세션에서 확인한 리전 API 호스트. 광역 amazonaws.com 한 줄은 최후 수단으로만 쓰고, 가능하면 리전·서비스별로 좁힙니다.

DOMAIN-KEYWORD,aws처럼 너무 넓은 키워드는 사내 모니터링·타사 위젯까지 잡을 수 있어 초기에는 DOMAIN-SUFFIX 위주로 쌓으세요.

교육용 YAML: Verge Rev 프로필에 넣을 스켈레톤

아래는 개념용 예시입니다. 더 넓은 DIRECT·GEOIP,CN 블록보다 위에 와야 하며, 실제 Host는 Verge Rev 연결 탭에서 복사해 교체하세요.

# Example — replace suffixes with hosts from your connection / rule hit log
proxy-groups:
  - name: NPM-REGISTRY
    type: select
    proxies:
      - 🛰 Registry-stable
      - ♻️ Auto
      - DIRECT
  - name: GITHUB-CDN
    type: select
    proxies:
      - 🛰 High-throughput
      - ♻️ Auto
      - DIRECT
  - name: AWS-MCP
    type: select
    proxies:
      - 🇯🇵 Low-latency
      - ♻️ Auto
      - DIRECT
  - name: AWS-API
    type: select
    proxies:
      - 🌐 Global-AWS
      - ♻️ Auto
      - DIRECT

rules:
  - DOMAIN-SUFFIX,registry.npmjs.org,NPM-REGISTRY
  - DOMAIN-SUFFIX,npmjs.com,NPM-REGISTRY
  - DOMAIN-SUFFIX,github.com,GITHUB-CDN
  - DOMAIN-SUFFIX,githubusercontent.com,GITHUB-CDN
  - DOMAIN-SUFFIX,aws.amazon.com,AWS-API
  - DOMAIN-SUFFIX,console.aws.amazon.com,AWS-API
  - DOMAIN-SUFFIX,docs.aws.amazon.com,AWS-API
  # Add verified Bedrock / STS / regional API hosts from your session:
  # - DOMAIN-SUFFIX,bedrock-runtime.us-east-1.amazonaws.com,AWS-API

rule-provider를 병합했다면 GUI가 보여 주는 최종 규칙 순서로 검증하세요. 파일을 팀이 공유한다면 YAML 백업·롤백 글과 맞춰 변경 이력을 남깁니다.

MCP 엔드포인트·Skills 연결에서 자주 막히는 지점

IDE 설정 화면에는 «MCP Server URL» 한 줄만 보여도, 뒤에서는 (1) npm으로 받은 서버 바이너리 기동, (2) SSO·aws sso login 토큰 갱신, (3) 도구 목록 JSON, (4) Bedrock 등 AWS API 호출이 겹칩니다. (1)(2)가 NPM·IAM 축, (3)이 MCP 전송, (4)가 AWS-API 축에 해당하는 경우가 많습니다.

«tools/list는 되는데 invoke만 실패»면 MCP 줄은 살아 있고 API 줄만 DIRECT·차단 리전·만료 자격 증명 쪽을 봅니다. 반대로 «서버 프로세스가 바로 종료»면 npm postinstall·GitHub raw 다운로드가 먼저 실패했을 수 있어, 설치 직후 Clash Verge Rev 연결 목록에서 첫 수십 초 Host를 캡처하세요. Claude Code CLI·npm·GitHub 분리 글의 «설치 축 vs API 축» 순서가 그대로 이식됩니다.

원격 MCP(SSE·Streamable HTTP)를 쓰면 유휴 타임아웃에 민감합니다. AWS-MCP 그룹에는 핑이 안정적인 노드를 고정하고, url-test 간격을 지나치게 짧게 두어 노드가 승인·해제를 반복하지 않게 조정하세요.

npm CDN·GitHub: Toolkit 설치가 먼저 흔들릴 때

npx·npm i -g로 Toolkit을 올릴 때 실패 메시지가 ETIMEDOUT·ECONNRESET이면, MCP나 Bedrock 이전에 npm CDN 줄부터 봅니다. 사내 Verdaccio·미러를 쓰면 registry.npmjs.org 대신 사내 호스트가 NPM-REGISTRY 그룹에 들어가야 하고, 회사 라우팅과 Clash DIRECT가 겹치지 않는지 확인합니다.

GitHub에서 Skills 템플릿·워크플로 예제를 받을 때 git clone·curl -L이 GITHUB-CDN과 AWS-API와 다른 노드를 타면, 에이전트 첫 실행만 수 분 지연되는 체감이 납니다. Codex·GPT 계열 CLI와 겹치는 패턴은 GPT‑5.5 Codex Verge 분리 글에서 패키지·아티팩트 축 설명을 이어 읽으면 됩니다.

AWS 공식 문서·블로그의 도메인·엔드포인트는 리전·서비스 GA에 따라 바뀝니다. 글의 예시 Host는 교육용이며, 본인 rule hit 한 줄을 정본으로 삼으세요.

Bedrock·STS·콘솔 API: AWS-API 그룹을 좁게 유지하기

AWS API 호출은 리전·VPC 엔드포인트·PrivateLink 여부에 따라 호스트 문자열이 달라집니다. Bedrock Runtime, STS, CloudFormation, CDK bootstrap이 한 세션에 섞이면 «에이전트가 AWS 전체를 못 쓴다»고 느껴지지만, 로그를 나누면 특정 서비스 접미사만 다른 정책에 걸린 경우가 많습니다.

엔터프라이즈에서는 «해외 리전 API만 프록시» 같은 정책이 있어, 광역 amazonaws.com 규칙이 사내 게이트웨이와 충돌하기도 합니다. Slack·AWS CDN 분리 글에서 말한 것처럼 «전체 amazonaws 블록»보다 검증된 CDN·API 접미사 묶음을 나누는 편이 안전합니다. IAM 거부(403)와 네트워크 타임아웃은 증상이 비슷하므로, 동일 Host에 curl -v로 mixed port·TUN 중 어디를 탔는지 먼저 가르세요.

Clash Verge Rev에서 rule hit로 검증하는 순서

Clash Verge Rev는 연결 카드·규칙 적중 로그를 한 화면에서 보기 쉬워, 2026년 국내 «에이전트 + 프록시» 검색 시나리오에서 자주 언급됩니다. 재현 절차는 짧게 유지합니다.

  1. Toolkit 설치·MCP 등록·첫 Bedrock 호출 중 실패한 시각과 명령을 메모합니다.
  2. Verge Rev 연결 탭에서 해당 시각 전후 Host·SNI를 복사합니다.
  3. 규칙 적중 로그에서 어떤 줄·어떤 proxy-group으로 나갔는지 확인합니다.
  4. NPM·GITHUB·AWS-MCP·AWS-API 그룹을 일시적으로 같은 노드에 묶었다가 다시 나눠 체감 차이를 봅니다.
  5. 브라우저 AWS 콘솔과 터미널 에이전트가 같은 프로필·같은 TUN 상태인지 확인합니다.

GUI만 켜 두고 코어가 다른 프로필을 읽으면 로그가 비어 보입니다. 팀 위키에 «Verge 프로필 경로·코어 로그 위치»를 한 번만 적어 두면 AWS MCP Server 이슈 대응 시간이 줄어듭니다. Windows·macOS 설치 흐름은 각각 Verge Rev Windows·Intel Mac Verge 글을 참고하세요.

TUN 모드·터미널 CLI: 에이전트 하위 프로세스가 프록시를 안 탈 때

많은 AI coding agent 하위 프로세스는 OS 시스템 프록시를 무시합니다. 브라우저 콘솔은 되는데 aws CLI·MCP 래퍼만 끊기면, TUN을 켜 전역으로 잡거나, 셸에 export HTTPS_PROXY=127.0.0.1:7890을 맞춘 뒤 같은 mixed port인지 확인합니다. TUN과 시스템 프록시를 동시에 켜면 경로가 이중으로 갈라지기도 하니 TUN 가이드와 macOS 터미널 프록시 환경을 함께 읽으세요.

Microsoft Build·Azure 스트림을 다룬 Build Azure CDN 분리 글과 달리, AWS 쪽은 리전 API와 글로벌 콘솔·문서 호스트가 섞이기 쉽습니다. «한 클라우드 = 한 줄 규칙»으로 끝내지 말고 세션 로그 기준으로 쪼개세요.

DNS·fake-ip와 리전 엔드포인트

fake-ip 모드에서 코어 resolver와 OS resolver가 다른 A/AAAA를 들고 있으면, 동일 Bedrock 호스트라도 세션마다 다른 출구로 보입니다. redir-host로 바꿔 재현되는지, fake-ip-filter에 협업·클라우드 호스트를 넣어야 하는지 비교하세요. DoH 업스트림이 리전별로 다른 답을 주면 «같은 API 키인데만 간헐적 403»처럼 느껴질 수 있습니다.

문제 순간에 코어가 실제로 어떤 질의를 보냈는지 로그로 고정한 뒤 규칙을 수정하세요. QUIC·HTTP/3 선호 클라이언트는 UDP 경로 이슈로 멈춘 것처럼 보일 때가 있어 QUIC·HTTP/3 글과 교차 확인합니다.

재현 가능한 자가 점검 체크리스트

팀 채널에 붙여 넣기 쉽게 단계만 정리했습니다. 각 단계마다 rule hit 한 줄을 남기면 이관이 빨라집니다.

  • npm install 실패인지, MCP panel만인지, Bedrock·STS만인지 축을 먼저 가릅니다.
  • Verge Rev에서 실패 시각의 Host와 매칭된 규칙 이름을 캡처합니다.
  • 광역 DIRECT·GEOIP가 AWS·npm 줄보다 위에 있지 않은지 확인합니다.
  • AWS-API 그룹 노드를 바꿔 IAM 403과 네트워크 타임아웃을 구분합니다.
  • TUN·시스템 프록시·회사 SSL 검사가 동시에 개입하지 않는지 봅니다.
  • 자격 증명·리전·SCP 정책이 네트워크와 무관한 거부인지 AWS 쪽 로그로 확인합니다.
프록시 도구는 합법적인 원격 개발·연구·개인정보 보호에 쓰일 수 있지만, 관할 법령·AWS 이용 약관·고용 계약을 위반하는 용도로 사용해서는 안 됩니다. 금지 리전·데이터 반출 정책을 우회하려는 설정은 다루지 않습니다.
Toolkit·MCP 버전을 올릴 때마다 «규칙만»이 아니라 첫 60초 연결 로그를 새로 찍으세요. GA 직후 패키지 의존성이 바뀌면 예전 Host 목록이 금방 낡습니다.

자주 묻는 질문

Q. amazonaws.com 전체를 한 줄로 프록시에 넣어도 되나요?
A. 광역 접미사는 다른 AWS SaaS·사내 연동까지 끌어올 수 있습니다. Bedrock·STS·콘솔 등 세션에서 확인한 Host만 AWS-API에 두세요.

Q. MCP는 stdio인데 Clash 규칙이 의미가 있나요?
A. 설치·원격 브리지·자격 갱신·도구 호출이 열리는 순간 HTTPS가 생깁니다. IDE가 띄운 MCP 래퍼 로그를 기준으로 분류하세요.

Q. Cursor만 쓰는데 AWS Agent Toolkit이 필요한가요?
A. AWS 워크로드를 에이전트에 맡기는 팀이라면 Toolkit·AWS MCP Server 연동 후 npm·API 트래픽이 늘기 쉽습니다. 에디터 종류와 무관하게 축 분리 원칙은 같습니다.

정리

2026년 5월의 AWS Agent Toolkit·AWS MCP Server 열풍은 «IDE에 AWS를 붙인다»는 한 줄로 보이지만, 실제로는 npm CDN·GitHub·MCP 전송·리전별 AWS API가 동시에 돌아갑니다. 일부 범용 VPN이나 전역 토글만 있는 클라이언트는 Host 단위 정책·rule hit 진단이 부족해, 노드만 갈아타다 시간을 쓰기 쉽습니다.

반면 Clash·Mihomo와 Clash Verge Rev는 DOMAIN 규칙과 proxy-group으로 MCP 분류를 세밀하게 만들 수 있고, DNS·TUN·연결 로그를 같은 흐름에서 점검할 수 있어 에이전트·MCP·클라우드 API가 겹치는 환경에 맞습니다. 축을 나누면 «Toolkit이 불안정하다»는 보고를 npm·MCP·API·자격 증명 가설로 쪼갤 수 있습니다.

클라이언트 출처를 먼저 통일한 뒤 이 글의 규칙을 얹고 싶다면, 본 사이트 클라이언트 다운로드 페이지에서 현재 플랫폼 패키지를 확인하세요. 더 넓은 흐름은 문서 허브의 고급 설정과 이어 읽으면 됩니다.

본문 분류를 적용하기 전에 사용 중인 Clash·Verge 빌드가 최신인지 확인하려면, 다운로드 페이지에서 현재 플랫폼용 패키지를 받을 수 있습니다.

→ 지금 무료로 Clash를 내려받고 AWS Agent·MCP·API 분류를 안정적으로 맞춰 보기

다운로드 페이지에서 Clash 클라이언트 받기