세팅 가이드 · 체크인 18:30–19:00

19:45 첫 퀘스트 전까지
세팅을 끝내 두시면 됩니다

아래 세 갈래 중 나의 환경에 맞는 글을 읽어주세요. 스마트폰만 가져오셨으면 설치할 것이 없고, 노트북이면 세 줄로 끝납니다.

402체크인은 18:30부터 19:00까지입니다. 늦게 오신 분은 스태프들이 도와드리니 편하게 말씀해 주세요.

연결해두면 퀘스트 1 송금과 키캡 결제가 스마트폰에서 버튼 한 번으로 끝납니다.

브라우저만으로

설치할 것이 없습니다

설치 없이

스마트폰 · 태블릿 · 노트북 브라우저

설치할 게 없습니다

구글 계정만 있으면 됩니다.

· 지갑 앱을 깔지 않습니다. MetaMask도 OKX도 필요 없습니다.
· 구글로 로그인하면 키가 나오고, 결제용 지갑은 버튼 한 번으로 만듭니다. 시드 문구는 없습니다.
· QR을 찍고 버튼 한 번 누르면 결제가 끝납니다. 서명 창도 안 뜨고, 코드도 쓰지 않습니다.
· MCP 서버는 스마트폰 안에서 돌지 않습니다. 아래 설치 안내는 읽지 않으셔도 됩니다.

해당 레인

🔵 Lane M · Mobile · 리더보드에 남은 내 결제 기록

🟠 Lane F · Finance · Q402 기능으로 옮겨 본 내 업무

내 퀘스트 보기

에이전트로

에이전트가 대신 결제합니다

노트북에서

노트북을 가져오신 분

3줄이면 끝납니다

에이전트가 대신 결제합니다.

Claude Code · Cursor · Codex 중 하나가 깔려 있으면 됩니다. 아래 3줄이 전부입니다.

🟢 Lane A약 5분

키 넣는 줄 확인하기 3줄 설치로 →

설치가 안 되더라도 퀘스트는 하실 수 있습니다. 워크샵 사이트는 노트북 브라우저에서도 동일하게 돌아갑니다. 위쪽 브라우저 안내를 그대로 따라 하시면 됩니다.

스마트폰에서 원격으로

노트북을 집에 켜두고 오신 분

스마트폰에서 노트북의 에이전트를 그대로 쓰실 수 있습니다

Claude Code 의 Remote Control 을 켜두면, 스마트폰에서 내 노트북 세션을 그대로 사용합니다. MCP 도 노트북에 있는 것을 사용하기 때문에 퀘스트를 전부 에이전트로 하실 수 있습니다. 노트북이 켜져 있고 세션이 살아 있어야 합니다.

노트북에서 미리 실행해 주세요

claude remote-control

claude.ai 계정으로 로그인 되어 있어야 하고, Pro 이상 플랜이 필요합니다. 노트북이 잠들면 세션도 끊깁니다. 준비가 안 되셨으면 위쪽 브라우저 안내로 하시면 됩니다. 결과는 동일합니다.

주의해 주세요

받은 키는 Q402_MULTICHAIN_API_KEY 줄에 붙여넣으셔야 합니다

대시보드에는 Trial API Key 라고 표시됩니다. 그래도 넣는 줄은 Q402_MULTICHAIN_API_KEY 가 맞습니다. Quack 대시보드가 직접 만들어 주는 설정도 그 줄로 되어 있습니다.

이름만 보고 Q402_TRIAL_API_KEY 줄에 넣기 쉬운데, 대시보드가 주는 설정을 그대로 쓰시는 편이 안전합니다. 슬롯을 잘못 고르면 에이전트가 엉뚱한 키로 결제를 시도합니다.

틀려도 에러가 안 뜹니다

다른 줄에 넣으면 에러 대신 sandbox 응답이 와서, 결제가 된 것처럼 보입니다. 실제로는 아무것도 안 나간 상태라 나중에 알아채기가 어렵습니다. 이 한 줄만 확인해 주세요.

넣는 방법은 둘 중 하나입니다

방법 1 · Q402 설정 파일에 넣기

키는 환경변수가 아니라 파일에 들어갑니다. 아래 파일을 열고 그 줄 뒤에 붙여넣으시면 됩니다.

① 이 파일을 에디터로 열어 주세요

~/.q402/mcp.env

② 이 줄 뒤에 키를 붙여넣어 주세요

Q402_MULTICHAIN_API_KEY=

방법 2 · Claude 설정 파일에 바로 넣기

대시보드 MCP setup 에서 그대로 복사해 오셔도 됩니다. 형태는 이렇고, 따옴표 안에 본인 키를 넣으시면 됩니다.

claude 설정 · mcpServers

{
  "mcpServers": {
    "q402": {
      "command": "npx",
      "args": ["-y", "@quackai/q402-mcp"],
      "env": { "Q402_MULTICHAIN_API_KEY": "q402_live_…" }
    }
  }
}

붙여넣으셨으면 에이전트를 완전히 종료했다가 다시 실행하시면 됩니다. 재시작하지 않으면 MCP 툴 목록이 갱신되지 않습니다. 키는 파일에만 넣어 주세요. 채팅창에 붙여넣으면 대화 기록에 그대로 남습니다.

노트북 세팅 · 3줄

이 세 줄이 전부입니다

위에서부터 차례로 해보시면 됩니다. 세 번째 줄에서 상태가 초록으로 나오면 끝입니다.

MCP 등록

터미널에 붙여넣기

claude mcp add q402 -- npx -y @quackai/q402-mcp

2
에이전트에게 요청
에이전트 대화창에 붙여넣기
```
Set up Q402
```
3
키 붙여넣고 재시작
에이전트 대화창에 붙여넣기
```
Q402 상태 확인해줘
```
키는 Q402_MULTICHAIN_API_KEY 줄에. 붙여넣고 나면 클라이언트를 재시작해야 반영됩니다.

로그인부터 첫 결제까지

전부 여섯 번입니다

앞의 네 번은 처음 한 번만 하면 되는 준비 과정이고, 실제 결제는 QR을 찍고 버튼을 누르는 두 번입니다.

01
q402.quackai.ai
구글 계정으로 로그인
로그인하는 순간 API 키가 함께 발급됩니다.
02
q402 대시보드
Agent Wallet 만들기
Wallets 에서 ＋ New wallet 을 눌러 주세요. 자동으로 생기지 않습니다.
03
q402 대시보드
API 키 복사
04
워크샵 사이트
키 붙여넣기
키는 기기에만 저장되고, 결제할 때만 사용됩니다.
05
워크샵 사이트
받는 곳 정하기
퀘스트 1·2 는 받으실 분 주소를, 퀘스트 3 은 정해진 굿즈 지갑으로 갑니다.
06
워크샵 사이트
결제 버튼 누르기
서명 창은 뜨지 않습니다.

01–04 는 오늘 한 번만 하시면 되고, 05–06 이 실제로 결제하는 부분입니다.

2번에서 제일 많이 막힙니다

로그인만 해두면 키는 나오지만 지갑은 아직 없는 상태라, 결제하려고 하면 지갑을 찾을 수 없다는 메시지가 뜹니다. 로그인하신 김에 ＋ New wallet 까지 눌러 두시면 편합니다.

오시기 전에

미리 아시면 좋은 것들

지갑 앱을 설치하실 필요가 없습니다

MetaMask도 OKX도 사용하지 않습니다. 구글 계정으로 q402.quackai.ai 에 로그인한 다음, 대시보드에서 결제용 지갑을 한 번 만들면 됩니다. 서명은 Q402 서버가 대신 하니 시드 문구를 받아적을 일도 없습니다.

평소 쓰시는 지갑은 그대로 둡니다

오늘 만드는 지갑은 이 워크샵에서만 쓰는 별도의 지갑입니다. 한도가 걸려 있고, 키는 8/28 에 만료되는 Trial 키입니다. 평소 쓰시는 지갑과는 아무 상관이 없습니다.

구글 계정은 하나만 쓰셔야 합니다

트라이얼은 계정당 한 번뿐입니다. 로그인한 계정에 키와 지갑이 묶이니, 중간에 계정을 바꾸면 처음부터 다시 해야 합니다.

트러블슈팅

막히시면 여기서 찾으시면 됩니다

자주 나오는 증상 10가지를 원인과 함께 정리해 두었습니다. 증상을 찾아 적힌 대로 한 줄만 해보시면 됩니다. 스태프도 같은 시트를 들고 있습니다.

증상별 원인과 조치
증상	원인	조치
TRIAL_BNB_ONLY	키가 트라이얼 슬롯에 들어갔거나 트라이얼 창 밖	대시보드에 Trial API Key 로 떠도 넣는 줄은 Q402_MULTICHAIN_API_KEY 입니다. 그래도 안 되면 스태프를 불러 주세요.
npm ERR 404 @q402/core	GitBook 문서를 따라감	@quackai/q402-mcp 하나만 쓰시면 됩니다. 문서에 나오는 다른 패키지 경로는 무시하셔도 괜찮습니다.
AGENTIC_WALLET_NOT_FOUND	키는 받았는데 Agent Wallet 을 아직 안 만들었다	q402.quackai.ai 대시보드에서 Wallets → ＋ New wallet 을 누르시면 됩니다. 체크인 때 도와드립니다.
트라이얼 키가 안 나온다	그 구글 계정으로 이미 트라이얼을 쓴 적이 있다	계정당 한 번뿐입니다. 다른 구글 계정으로 로그인하시거나 스태프를 불러 주세요.
SUBSCRIPTION_REQUIRED (배치)	한 번에 6명 이상을 보냈다. 트라이얼 키는 5명까지다	5명 이하로 나눠 보내시면 됩니다. 퀘스트 2는 3명이라 여유가 있습니다.
정산이 안 끝난 것 같다	정상입니다. 수취인마다 트랜잭션이 따로 나갑니다	3명이면 40초쯤 걸립니다. 잠시 기다렸다가 리더보드를 보시면 됩니다.
잔고가 있는데 결제 실패	pre-check 0.02달러가 부족	금액을 0.01 USDC로 낮추시면 됩니다. 오늘 퀘스트 송금은 전부 0.01입니다.
q402_doctor 실패	~/.q402/mcp.env 가 아직 없음	에이전트에게 "Set up Q402"를 다시 요청하시면 됩니다.
MCP 툴이 안 보임	클라이언트를 재시작하지 않음	완전히 종료했다가 다시 실행하시면 됩니다.
에스크로 · 이자 기능이 안 됨	Mantle 미지원 (BNB·Base 전용)	정상입니다. 오늘 범위 밖입니다.

TRIAL_BNB_ONLY
원인키가 트라이얼 슬롯에 들어갔거나 트라이얼 창 밖
조치대시보드에 Trial API Key 로 떠도 넣는 줄은 Q402_MULTICHAIN_API_KEY 입니다. 그래도 안 되면 스태프를 불러 주세요.
npm ERR 404 @q402/core
원인GitBook 문서를 따라감
조치@quackai/q402-mcp 하나만 쓰시면 됩니다. 문서에 나오는 다른 패키지 경로는 무시하셔도 괜찮습니다.
AGENTIC_WALLET_NOT_FOUND
원인키는 받았는데 Agent Wallet 을 아직 안 만들었다
조치q402.quackai.ai 대시보드에서 Wallets → ＋ New wallet 을 누르시면 됩니다. 체크인 때 도와드립니다.
트라이얼 키가 안 나온다
원인그 구글 계정으로 이미 트라이얼을 쓴 적이 있다
조치계정당 한 번뿐입니다. 다른 구글 계정으로 로그인하시거나 스태프를 불러 주세요.
SUBSCRIPTION_REQUIRED (배치)
원인한 번에 6명 이상을 보냈다. 트라이얼 키는 5명까지다
조치5명 이하로 나눠 보내시면 됩니다. 퀘스트 2는 3명이라 여유가 있습니다.
정산이 안 끝난 것 같다
원인정상입니다. 수취인마다 트랜잭션이 따로 나갑니다
조치3명이면 40초쯤 걸립니다. 잠시 기다렸다가 리더보드를 보시면 됩니다.
잔고가 있는데 결제 실패
원인pre-check 0.02달러가 부족
조치금액을 0.01 USDC로 낮추시면 됩니다. 오늘 퀘스트 송금은 전부 0.01입니다.
q402_doctor 실패
원인~/.q402/mcp.env 가 아직 없음
조치에이전트에게 "Set up Q402"를 다시 요청하시면 됩니다.
MCP 툴이 안 보임
원인클라이언트를 재시작하지 않음
조치완전히 종료했다가 다시 실행하시면 됩니다.
에스크로 · 이자 기능이 안 됨
원인Mantle 미지원 (BNB·Base 전용)
조치정상입니다. 오늘 범위 밖입니다.