# 시작 안내

웹 스크립트와 React SDK 연동, 공개 MCP 연결, Privy 이전과 Pouchi 계정 보안.

Pouchi는 앱 전용 디지털 자산 지갑을 연결하는 SDK입니다. 앱에서 요청한 결제는 사용자가 직접 승인합니다. 첫 가입은 이메일로 진행하며 패스키는 가입 후 추가합니다. 현재는 Maroo 테스트넷(`chainId 450815`)의 테스트 자산을 사용합니다.

  [웹 스크립트 연동 React나 npm 없이 로그인 버튼을 추가하고, 로그인 상태와 결제 API를 연결합니다. 스크립트 안내 →](/docs/browser-sdk/)
  [React 앱 연동 Provider와 훅을 사용하는 앱의 설정, 로그인과 테스트 송금을 구현합니다. React 빠른 시작 →](/docs/quickstart/)
  [AI 에이전트 연결 공개 MCP URL로 지갑 도구를 연결합니다. 결제 권한은 사용자가 직접 승인합니다. 연결 안내 →](/docs/agents/)

## 연동 준비

웹사이트에 로그인 버튼을 추가하려면 [웹 스크립트 SDK](/docs/browser-sdk/)로 시작합니다. 앱 ID와 허용 출처 등록이 필요하며, React나 패키지 설치는 필요하지 않습니다. 현재 새 계정 가입부터 결제까지의 최종 통합 검증을 진행 중입니다.

기존 React 앱에서 Provider와 훅을 사용하려면 [React 빠른 시작](/docs/quickstart/)을 확인하세요. 이 경로는 패키지 읽기 권한이 필요합니다. 공개 npm 베타는 준비 중이며, 설치 성공이 확인된 공개 패키지로 안내하기 전까지 별도로 문의해야 합니다.

[business@pouchi.app](mailto:business@pouchi.app)으로 앱 이름과 개발·배포 출처를 알려 주세요. 앱 ID, 허용 출처, 테스트 자산과 가스 대납 설정을 확인합니다. 토큰, PIN, 복구 코드는 보내지 마세요. [요금 초안](/pricing/)에서 비용 산정안을 확인할 수 있습니다.

코딩 도구를 이용한다면 [개발자 MCP 안내](/docs/ai/), 기존 Privy 앱을 옮기려면 [이전 안내](/docs/privy-migration/)를 확인하세요. 결제용 지갑 MCP와 개발자 MCP는 서로 다른 도구입니다.

## 제품과 제공 범위

| 제품 | 하는 일 | 현재 범위 |
| --- | --- | --- |
| 웹 스크립트 SDK | 로그인 버튼, 로그인 상태와 결제 요청 API | Maroo 테스트넷. 앱 등록 필요. 가입·결제 최종 통합 검증 중 |
| React SDK | Provider와 훅을 사용하는 지갑 연동 | Maroo 테스트넷. 패키지 접근과 설치 상태 사전 확인 필요 |
| 에이전트 결제 | 사용자가 승인한 대상·금액·횟수·기간 확인 | 상세 조건은 [결제 권한](/docs/delegation/) 참고 |
| 지갑 MCP | 에이전트의 지갑 연결과 결제 요청 | [공개 테스트넷 URL](/docs/agents/)로 연결 |

## 계정과 보안

하나의 Pouchi 계정으로 여러 앱에 로그인합니다. 지갑은 앱별로 분리되는 것이 기본이며, 앱 운영자가 공유를 선택한 경우에만 공유합니다. 복구는 계정에 한 번 설정하고, 이용자는 패스키 또는 복구 코드를 보관해야 합니다. 가스비는 앱이 부담합니다.

앱 코드는 키 자료에 접근하지 않습니다. [계정과 보안](/docs/security/)에서 키 보관 경계와 복구 조건을 확인하고, [Pouchi Home](https://pouchi-home.vercel.app)에서 지갑과 연결된 앱, 기기와 복구 설정을 관리합니다. Pouchi는 아직 외부 보안 감사를 받지 않았습니다.

## 참고 문서

- [Pouchi 체험](/docs/tour/): 테스트넷 데모의 계정과 결제 흐름
- [React SDK 레퍼런스](/docs/reference/react/): 주요 공개 API와 지원 상태
- [지갑 MCP 도구](/docs/reference/wallet-mcp/): 도구 인자와 결과 상태
- [자주 묻는 질문](/docs/faq/): 한도, 테스트 자산과 패키지 접근