Claude에서의 실시간 입금 알림: 입금 트랜잭션 모니터링을 위한 MCP 도구

입금 트랜잭션 모니터링 (Incoming transaction monitoring)은 AI 에이전트가 입금을 놓치고 오래된 잔액 데이터에 기반하여 동작하기 전까지는 단순하게 들리는 기능 중 하나입니다. 만약 Claude의 모델 컨텍스트 프로토콜 (Model Context Protocol, MCP)을 사용하여 구축 중이며, 에이전트가 온체인 (onchain)에 자금이 도착하는 시점을 실시간으로 알기를 원한다면, WAIaaS는 claude_desktop_config.json에 항목 하나를 추가하는 것만으로 이를 즉시 제공합니다.

에이전트가 입금 사실을 알아야 하는 이유

자율 거래 에이전트 (autonomous trading agent)가 업무를 수행하기 위해 실제로 무엇이 필요한지 생각해 보십시오. 에이전트는 잔액을 확인하고, 스왑 (swaps)을 실행하며, 포지션을 관리합니다. 하지만 에이전트가 새로운 자금이 도착했다는 사실을 모른다면 이 모든 로직은 무너집니다. 입금 모니터링의 공백은 에이전트가 지갑에 자금이 부족하다고 판단하여 거래를 거부하거나, 더 심각하게는 입금된 SOL 또는 ETH가 정산되기 전에 트랜잭션을 대기열에 쌓아두는 상황을 초래할 수 있습니다.

여러 체인에 걸쳐 여러 지갑을 운영하거나, 방금 지갑을 충전하고 다음 동작이 일어나기를 기다리는 사용자를 대신하여 에이전트가 동작할 때는 위험 부담이 더 커집니다. 실시간 입금 인지 (Real-time deposit awareness)는 있으면 좋은 기능이 아니라, 외부 세계와 에이전트의 결정 루프 (decision loop)를 연결하는 결합 조직입니다.

MCP 서버로서의 WAIaaS

WAIaaS는 지갑 운영, 트랜잭션, DeFi 액션, NFT, 그리고 이 포스트에서 매우 중요한 입금 트랜잭션 모니터링을 아우르는 45개의 MCP 도구를 제공하는 셀프 호스팅 방식의 Wallet-as-a-Service 데몬입니다. 이를 로컬 또는 서버에서 실행한 다음, Claude Desktop이 이를 가리키도록 설정하면 됩니다. 여러분의 Claude 에이전트는 블록체인 인프라 코드를 직접 작성하지 않고도 완전히 기능하는 지갑 레이어를 갖게 됩니다.

45개 도구의 전체 목록에는 get-incoming-summary, list-incoming-transactions, get-balance, get-assets 및 기타 41개가 포함됩니다. 입금 모니터링은 해당 도구 세트에서 사후 고려 사항이 아닌, 일급 시민 (first-class citizen)으로서 핵심적인 역할을 합니다.

필요한 Claude Desktop 설정은 다음과 같습니다:

{
  "mcpServers": {
    "waiaas": {
...

이 한 줄(정확히는 한 블록)이 Claude에게 입금 모니터링 기능이 있는 지갑을 부여합니다. 데몬(daemon)이 실행되고 이 설정이 적용되면, Claude에게 "지난 24시간 동안의 입금 트랜잭션을 요약해줘"와 같은 질문을 할 수 있으며, Claude는 실제 지갑에 대해 get-incoming-summary를 호출하게 됩니다.

가장 자주 사용하게 될 두 가지 모니터링 도구

get-incoming-summary

이 도구는 Claude에게 최근 입금에 대한 고수준의 개요(high-level overview)—합산 금액, 토큰 유형, 시점 등—를 제공합니다. 최근 유입(inflow)을 바탕으로 Claude가 결정을 내리도록 요청할 때 유용한 도구입니다. 예를 들어:

사용자: "어제 이후로 들어온 게 있나요? 리밸런싱(rebalance)을 해야 할까요?"
→ Claude가 get-incoming-summary 호출 → 3시간 전에 2.5 SOL이 입금된 것을 확인
→ Claude가 이를 리밸런싱 권장 사항에 반영

요약 뷰는 빠르고 노이즈가 적습니다. 트랜잭션 수준의 세부 사항에 매몰되지 않으면서도 상황 인지(situational awareness)가 필요한 에이전트에게 적합한 도구입니다.

list-incoming-transactions

이 도구는 개별 입금 트랜잭션의 전체 목록을 반환합니다. 각 입금은 주소, 금액, 토큰, 타임스탬프 및 상태를 포함하는 개별 레코드로 제공됩니다. 특정 입금을 감사(audit), 필터링하거나 그에 따라 조치를 취해야 할 때 사용하는 도구입니다.

사용자: "이번 주에 들어온 모든 USDC 입금을 보여줘"
→ Claude가 list-incoming-transactions 호출 → 토큰 및 날짜 범위로 필터링
→ 금액과 확정 상태(confirmation status)가 포함된 항목별 목록 반환

이 두 도구를 함께 사용하면, 사용자가 블록체인 인덱싱(indexing) 코드를 단 한 줄도 작성하지 않고도 Claude가 "전체적인 그림이 어떠한가?"와 "정확히 무엇이 언제 들어왔는가?"라는 두 가지 질문에 모두 답할 수 있게 해줍니다.

입금 모니터링이 나머지 도구 세트와 연결되는 방식

이 지점이 바로 MCP 서버로서 WAIaaS가 진정한 가치를 발휘하는 부분입니다. 45개의 도구는 고립되어 있지 않고 서로 조합됩니다. 입금 트랜잭션을 모니터링할 수 있는 에이전트는 다음과 같은 작업도 수행할 수 있습니다:

• 작업을 수행하기 전, get-balance를 호출하여 입금이 정산되었는지 확인합니다.
• SOL 입금이 리밸런싱 (rebalance) 규칙을 트리거하는 경우, Jupiter 스왑 (swap)과 함께 execute_action을 호출합니다.
• 새로운 자금이 LTV 비율 (LTV ratio)을 변화시키는지 확인하기 위해 get-defi-positions를 호출합니다.
• 확정하기 전에 다음 동작을 드라이 런 (dry-run) 해보기 위해 simulate-transaction을 호출합니다.

"입금 감지"에서 "조치 수행"에 이르는 흐름은 전적으로 Claude의 도구 컨텍스트 (tool context) 내에서 이루어집니다. 별도의 웹훅 (webhook) 인프라나 커스텀 이벤트 시스템이 필요하지 않습니다. 에이전트는 동일한 MCP 세션을 사용하여 폴링 (poll)하고, 추론하며, 행동할 수 있습니다.

Claude와의 실제 대화에서는 다음과 같은 모습일 수 있습니다:

사용자: "내 지갑을 모니터링하고 입금이 들어오면 알려줘. 
       만약 1 SOL보다 많으면, 절반을 USDC로 스왑해줘."

...

WAIaaS 설정하기: 최소 경로

아직 WAIaaS를 실행하고 있지 않다면, Claude에서 입금 모니터링까지 도달하는 가장 빠른 경로는 다음과 같습니다.

1단계: 데몬 (daemon) 시작

npm install -g @waiaas/cli
waiaas init --auto-provision
waiaas start

--auto-provision은 마스터 비밀번호를 자동으로 생성하고 이를 복구 파일에 기록합니다. 시작하기 위해 수동으로 설정할 것은 없습니다.

2단계: 지갑 및 세션 생성

waiaas quickset --mode mainnet

quickset은 한 번의 명령으로 지갑과 MCP 세션을 생성합니다. Claude Desktop에 붙여넣어야 할 MCP 설정 JSON을 출력합니다.

3단계: Claude Desktop 설정에 추가

quickset의 출력값을 ~/Library/Application Support/Claude/claude_desktop_config.json에 붙여넣으세요. 또는 CLI가 이를 수행하도록 할 수도 있습니다:

waiaas mcp setup --all

4단계: 연결 확인

Claude Desktop을 열고, 새로운 대화를 시작한 뒤 다음과 같이 물어보세요:

"내 지갑 잔액이 얼마야?"

Claude가 MCP를 통해 get-balance를 호출합니다. 실제 잔액(0이라도)이 보인다면 연결이 작동하고 있는 것입니다. 그다음 다음과 같이 시도해 보세요:

"최근에 들어온 트랜잭션들을 보여줘."

Claude가 get-incoming-summary를 호출합니다. 이제 실시간 작동 중입니다.

5단계: 알림 설정 (선택 사항이지만 권장됨)

WAIaaS는 입금에 대한 실시간 알림을 포함한 입금 트랜잭션 모니터링 (incoming transaction monitoring) 기능을 제공합니다. 단순히 요청 시에만 조회하는 것이 아니라, 무언가 도착했을 때 푸시 알림 (push alerts)을 받고 싶다면 다음과 같이 알림 채널을 설정할 수 있습니다:

waiaas notification setup

이 설정은 데몬 (daemon)의 입금 모니터링을 사용자가 선호하는 알림 방식으로 연결하여, 사용자(및 에이전트)가 수동으로 폴링 (poll)할 필요가 없도록 합니다.

멀티 월렛 설정: 월렛당 하나의 에이전트

트레이딩용 월렛, 결제용 월렛, Solana 월렛 등 용도에 따라 별도의 월렛을 운영하는 경우, 각 월렛의 범위를 지정하여 여러 개의 MCP 서버 인스턴스를 실행할 수 있습니다:

{
  "mcpServers": {
    "waiaas-trading": {
...

각 MCP 서버 인스턴스는 고유한 세션 (session)과 월렛 범위 (wallet scope)를 가집니다. Claude는 이를 에이전트 이름으로 네임스페이스 (namespaced)된 별개의 도구로 인식합니다. 예를 들어 "내 Solana 월렛의 입금 트랜잭션을 확인해줘"라고 요청하면 Claude가 올바른 세션으로 경로를 지정합니다.

보안은 어떻게 되나요?

입금 모니터링은 읽기 전용 (read-only)이지만, 트랜잭션 실행과 동일한 세션에서 실행됩니다. 즉, 설정한 세션 토큰 (session token)이 두 기능 모두에 접근할 수 있음을 의미합니다. WAIaaS는 21가지 정책 유형과 4가지 보안 계층 (INSTANT, NOTIFY, DELAY, APPROVAL)을 갖춘 정책 엔진 (policy engine)을 사용하여, 에이전트가 감지된 자금으로 실제로 수행할 수 있는 작업을 제어합니다.

모니터링에 집중된 설정을 위해 지출 정책 (spending policy)을 보수적으로 구성할 수 있습니다:

curl -X POST http://127.0.0.1:3100/v1/policies \
  -H "Content-Type: application/json" \
  -H "X-Master-Password: my-secret-password" \
...

이 정책이 적용되면 Claude는 자유롭게 모니터링하고 보고할 수 있지만, 10달러를 초과하는 모든 지출은 알림을 트리거하고, 100달러를 초과하는 모든 금액은 지연 (delayed)되며, 500달러를 초과하는 모든 금액은 WalletConnect 또는 Telegram을 통한 사용자의 명시적인 승인 (explicit approval)을 필요로 합니다. 에이전트는 들어오는 모든 것을 확인하지만, 나가는 것은 사용자가 통제권을 유지합니다.

정책 엔진은 토큰 전송에 대해 기본 거부 (default-deny) 방식을 사용합니다. 즉, 명시적으로 허용되지 않은 트랜잭션은 차단됩니다. 따라서 Claude가 입금에 대해 조치를 취하기로 결정하더라도, ALLOWED_TOKENS 정책을 통해 사용자가 화이트리스트 (whitelist)에 등록한 토큰만 보낼 수 있습니다. 이는 자율적으로 실행되는 모든 에이전트에게 의미 있는 안전 계층 (safety layer)입니다.

45개의 도구 구성

입금 모니터링은 45개의 도구 중 2개에 해당합니다. 나머지 도구들은 다음과 같은 범위를 다룹니다:

• 지갑 (Wallet): get-address, get-balance, get-assets, get-wallet-info, get-nonce
• 트랜잭션 (Transactions): send-token, send-batch, sign-transaction, simulate-transaction, list-transactions, get-transaction
• DeFi: action-provider, get-defi-positions, get-health-factor, hyperliquid, polymarket
• NFT: list-nfts, get-nft-metadata, transfer-nft
• x402: x402-fetch — 자동 HTTP 결제 처리
• ERC-4337: build-userop, sign-userop — 계정 추상화 (account abstraction) 및 가스리스 (gasless) 트랜잭션
• ERC-8004: erc8004-get-reputation, erc8004-get-agent-info — 온체인 (onchain) 에이전트 평판
• WalletConnect: wc-connect, wc-disconnect, wc-status

입금 트랜잭션 도구들(get-incoming-summary, list-incoming-transactions)은 Claude가 동일한 MCP 세션을 통해 관찰하고, 추론하며, 행동할 수 있는 더 넓은 에이전트 루프 (agentic loop)에 통합됩니다.

다음 단계

가장 빠른 다음 단계는 데몬 (daemon)을 실행하고 Claude에게 "입금 트랜잭션을 보여줘 (show me incoming transactions)"라고 요청하는 것입니다. waiaas init과 quickset을 사용하면 전체 설정에 약 5분 정도가 소요됩니다. 그 이후의 자연스러운 진행 과정은 Claude가 입금을 감지했을 때 할 수 있는 일을 제어하기 위해 지출 정책 (spending policies)을 추가하고, 실제 자동화된 전략을 구축하기 위해 DeFi 액션 도구들을 탐색하는 것입니다.

전체 코드베이스와 문서는 github.com/minhoyoo-iotrust/WAIaaS에서 확인하거나, 데몬이 실행된 후 배포 가이드 및 /reference에 있는 전체 API 참조를 위해 공식 사이트 waiaas.ai를 확인하세요.