메타마스크 네트워크 추가가 안 될 때

메타마스크에 네트워크를 추가하려고 했는데 버튼이 안 눌리거나, 추가했는데도 목록에 안 뜨는 경우가 많습니다. 처음엔 내가 뭔가 잘못한 건지 당황스러운 마음이 드는 게 당연합니다. 이 글에서 원인별로 하나씩 짚어드릴 테니 천천히 따라와 보세요.

 

메타마스크 네트워크 추가가 안 될 때 AI 생성 이미지

 

네트워크 추가가 안 되는 상황, 이런 경우가 많습니다

네트워크를 추가하다가 막히는 상황은 크게 두 가지로 나뉘는 경우가 많습니다. 버튼 자체가 반응이 없거나, 입력은 됐는데 저장이 안 되는 경우입니다. 어떤 상황인지 먼저 파악하는 게 중요합니다.

• 네트워크 추가 버튼 클릭 시 아무 반응 없음
• RPC URL 입력 후 "저장" 버튼이 비활성화 상태
• 추가는 됐는데 네트워크 목록에 표시되지 않음
• chainlist.org에서 추가 시도했으나 팝업이 뜨지 않음

📌 먼저 확인해야 할 것

메타마스크 앱 버전이 오래됐거나, 브라우저 확장 프로그램이 최신 버전이 아닌 경우에 이런 문제가 자주 발생합니다. 작업 전에 업데이트 여부를 먼저 확인하는 게 좋습니다.

원인 1 — RPC URL 입력 오류인 경우가 많습니다

가장 흔한 원인은 RPC URL을 잘못 입력하는 것입니다. URL 앞에 "https://"가 빠져 있거나, 복사 과정에서 공백이 섞이는 경우가 많습니다. 메타마스크는 형식이 맞지 않으면 저장 버튼을 아예 비활성화해버립니다.

올바른 입력 형식 예시

항목	올바른 예	잘못된 예
RPC URL	https://mainnet.infura.io/v3/...	mainnet.infura.io/v3/...
체인 ID	137 (숫자만)	0x89 (16진수 입력 불가)
통화 기호	MATIC	matic (소문자 혼용 주의)

원인 2 — 이미 같은 체인 ID가 등록된 경우

메타마스크는 같은 체인 ID를 중복으로 등록할 수 없습니다. 이미 비슷한 이름의 네트워크가 등록돼 있는지 모르고 다시 추가하려다 막히는 경우가 많습니다. 이 경우 오류 메시지가 불안한 느낌을 주지만 사실은 간단한 문제입니다.

해결 방법

1. 메타마스크 상단 네트워크 선택창 클릭
2. 기존에 등록된 네트워크 목록 확인
3. 같은 체인 ID의 네트워크가 있다면 해당 네트워크 수정 또는 삭제
4. 삭제 후 다시 추가 시도

✅ 체인 ID 확인 방법

추가하려는 네트워크의 공식 체인 ID는 chainlist.org에서 확인하는 게 가장 정확합니다. 비공식 사이트에서 복사한 RPC 정보는 체인 ID가 틀리는 경우가 종종 있습니다.

 

원인 3 — 브라우저 또는 확장 프로그램 충돌

크롬 확장 프로그램 간 충돌이나 캐시 문제로 네트워크 추가가 막히는 경우도 있습니다. 특히 다른 지갑 확장 프로그램이 함께 설치돼 있다면 더 자주 발생하는 편입니다. 불안하게 이것저것 건드리기 전에 아래 순서를 시도해 보세요.

• 브라우저 캐시 및 쿠키 전체 삭제 후 재시도
• 다른 지갑 확장 프로그램 일시적으로 비활성화
• 시크릿 모드(확장 프로그램 없는 환경)에서 메타마스크만 활성화 후 시도
• 그래도 안 된다면 메타마스크 확장 제거 후 재설치 (시드 문구 미리 백업 필수)

⚠️ 재설치 전 반드시 확인하세요

메타마스크를 삭제하면 로컬에 저장된 지갑 정보도 함께 삭제됩니다. 재설치 전에 반드시 시드 문구(복구 구문) 12단어를 안전한 곳에 기록해두세요. 이게 없으면 자산을 복구할 수 없는 경우가 많습니다.

가장 빠른 해결법 — Chainlist 자동 추가 이용하기

직접 입력하다 막히는 게 불안하다면 Chainlist.org를 이용하는 방법이 가장 간편한 경우가 많습니다. 자동으로 올바른 RPC 정보를 넣어주기 때문에 입력 오류 걱정이 없습니다. 다만 팝업 차단이 켜져 있으면 승인 창이 뜨지 않으니 주의가 필요합니다.

Chainlist 이용 순서

1. chainlist.org 접속 후 원하는 네트워크 검색
2. "Connect Wallet" 클릭 → 메타마스크 연결
3. 해당 체인의 "Add to MetaMask" 버튼 클릭
4. 메타마스크 팝업에서 "승인" 클릭
5. 브라우저 팝업 차단이 켜져 있다면 주소창 우측 팝업 허용으로 변경

 

진짜 주의할 점은 이겁니다

🔒 가짜 RPC URL 피싱 주의

네트워크 추가가 안 된다고 검색하다 보면 피싱 사이트에서 제공하는 가짜 RPC URL을 입력하게 되는 경우가 있습니다. 가짜 RPC는 트랜잭션 정보를 변조하거나 개인 키를 탈취할 수 있습니다. RPC 정보는 반드시 공식 프로젝트 문서 또는 chainlist.org에서만 가져오세요. 출처가 불분명한 텔레그램이나 디스코드 링크는 절대 신뢰하지 마세요.

메타마스크 네트워크 추가 오류는 대부분 RPC URL 오류, 중복 체인 ID, 브라우저 충돌 중 하나인 경우가 많습니다. 위 순서대로 하나씩 점검하면 대부분 해결되는 편입니다. 그래도 안 된다면 Chainlist 자동 추가를 먼저 시도해보는 게 가장 빠릅니다.

아래 관련 글도 함께 보시면 메타마스크 전반적인 사용에 도움이 될 수 있습니다.

• 메타마스크 사용법, 처음 쓰는 사람을 위한 가장 쉬운 정리
• 메타마스크 사용 중 서명 때문에 가장 많이 막힐 때