Yellow 빌더 가이드

AI 코딩 도구와 함께
첫 결제 앱을 만들어봐요

Yellow가 공개한 Yellow SDK MCP를 연결하면 Claude, Cursor 같은 AI 코딩 도구가 Yellow SDK와 Nitrolite 프로토콜의 맥락을 참고해 코드를 함께 만들어줘요. Yellow가 운영하는 테스트용 샌드박스에서 연습하며 시작할 수 있어요.
🤖 MCP · AI 도구용 맥락 서버 🧪 샌드박스 · 테스트 환경 🔒 상태 채널 · 비수탁 정산

따라하기 5단계

1AI 코딩 도구를 하나 준비해요

Claude Code, Claude Desktop, Cursor, VS Code 중 이미 쓰는 것 하나면 돼요. 컴퓨터에 Node.js가 설치돼 있어야 해요(npx 명령을 써요).

2Yellow SDK MCP를 연결해요

Claude Code라면 터미널에서 아래 한 줄이면 끝나요.

claude mcp add --transport stdio nitrolite -- npx -y @yellow-org/sdk-mcp@^1

Cursor는 ~/.cursor/mcp.json에 아래 설정을 추가하고 재시작해요. (Claude Desktop · VS Code 설정도 공식 문서에 같은 형식으로 있어요.)

{
  "mcpServers": {
    "nitrolite": {
      "command": "npx",
      "args": ["-y", "@yellow-org/sdk-mcp@^1"]
    }
  }
}
3AI에게 물어보며 개념을 잡아요

연결되면 AI 도구가 Yellow SDK의 메서드·타입·개념을 조회할 수 있어요. 이렇게 시작해보세요.

이렇게 물어보세요"Nitrolite 상태 채널이 뭔지, 왜 비수탁인지 설명해줘"
이렇게 물어보세요"Yellow SDK의 transfer 메서드 사용법을 찾아서 알려줘"
이렇게 물어보세요"내 첫 결제 앱 아이디어에 맞는 SDK 메서드를 추천해줘"
4시작 프로젝트를 만들고 샌드박스에서 돌려봐요

MCP에는 시작 프로젝트를 만들어주는 scaffold_project 도구가 들어 있어요. "Yellow SDK 스타터 프로젝트를 만들어줘"라고 하면 TypeScript 또는 Go 프로젝트 뼈대가 나와요.

SDK의 기본 접속지는 Yellow가 운영하는 테스트용 샌드박스(nitronode-sandbox.yellow.org)예요. 실제 자산을 다루기 전에 상태 채널 흐름을 연습해보는 자리예요.

알아두세요 · 샌드박스는 테스트 환경이라 운영 상태가 바뀔 수 있어요. 안 되는 부분이 있으면 소통방에 공유해주세요. 함께 확인해드려요.
5결과를 공유하고 빌더 트랙에 합류해요

만든 것(작아도 좋아요)이나 막힌 곳을 소통방에 공유해주세요. 빌더 트랙에 신청하면 한국 커뮤니티의 빌더 소식과 다음 단계를 안내받아요.

🛠 빌더 트랙 신청하기 (1분) 💬 소통방에서 같이 만들기

보너스 · 코드 없이 상태 채널을 직접 받아보기

⚡봇에서 /ysdk 를 누르면 테스트 토큰이 상태 채널로 도착해요

Yellow Quiz 봇 개인 대화(DM)에서 /ysdk 를 누르면, 등록해둔 출금 지갑으로 테스트넷 토큰(yusd)이 온체인 트랜잭션 없이 전송돼요. 위 1~5단계에서 코드로 만드는 바로 그 수신 흐름을, 코드 없이 먼저 겪어보는 체험이에요 (1인 1회).

받은 뒤 Nitrolite Playground에 지갑을 연결하면 도착한 잔고를 보고 직접 다른 주소로 보내볼 수도 있어요. yusd 는 테스트넷 전용이라 실제 가치는 없어요. 리워드 잔고와도 무관해요.

자주 묻는 질문

코딩을 잘 몰라도 되나요?
AI 도구가 코드 작성을 도와주지만, 터미널을 열고 명령어를 붙여넣는 정도는 직접 해요. 막히면 소통방에 물어봐 주세요. 같은 길을 먼저 간 분들이 있어요.
돈이 드나요?
Yellow SDK와 MCP 서버는 npm에 공개된 오픈소스예요. 샌드박스는 테스트 환경이에요. AI 코딩 도구 이용 조건은 각 서비스 정책을 확인해주세요.
어떤 언어로 만들 수 있나요?
TypeScript와 Go SDK가 제공돼요. MCP는 두 SDK의 API를 모두 조회할 수 있어요.
주의할 점이 있나요?
시드문구·개인키는 어디에도 붙여넣지 마세요. AI 도구 채팅창에도요. 실제 자산을 다루는 배포는 충분히 배운 뒤 직접 판단해주세요.

공식 자료

📦 Yellow SDK MCP (npm) 🐙 Nitrolite 저장소 (GitHub)
이 가이드는 정보 제공이며 투자 권유가 아니에요.
Yellow Korea 커뮤니티가 npm에 공개된 공식 패키지 문서를 기준으로 정리했어요.