
MCP 서버 연동
AI 에이전트가 공개 API로 입금 주소를 생성하고 결제 로그를 조회하며 수수료를 추산할 수 있습니다.
API 빠른 시작 보기요구 사항
- stdio 서버를 실행할 수 있는 MCP 클라이언트, Suawave MCP 실행 파일, 접근 가능한 게이트웨이 기본 URL이 필요합니다.
- 입금 주소 생성에 사용할 정산 지갑과 공개 콜백 URL이 필요합니다. 공개 도구에는 API 키가 필요하지 않습니다.
설치와 설정
- Suawave MCP 실행 파일을 설치하고 MCP 클라이언트가 stdio로 실행하도록 설정하세요.
- -base-url로 게이트웨이 URL을 전달하세요. 필요하면 -docs-dir로 API 문서를 읽기 전용 리소스로 제공할 수 있습니다.
- 티커, 정산 주소, 콜백 URL로 create_payment_address를 호출하세요. 해당 콜백 URL의 입금은 payment_logs로 조회하세요.
- 결제 준비에는 ticker_info, fee_estimate, convert, ticker_convert, qr_code를 사용하세요. 판매자 인증 정보가 설정되지 않으면 payment_status는 표시되지 않습니다.
구매자에게 표시되는 화면
서버는 에이전트에 구조화된 도구 결과를 반환합니다. 반환된 입금 주소, 금액, QR 코드를 구매자에게 표시하는 방식은 애플리케이션에서 정합니다. MCP 서버는 결제 페이지를 제공하지 않습니다.
결제 처리 방식
- 전송에는 stdio 기반의 줄바꿈 구분 JSON-RPC를 사용합니다. HTTP 전송, subscriptions, prompts는 구현되어 있지 않습니다.
- 서버는 관리자 작업을 노출하거나 판매자 결제 객체를 생성하지 않습니다. 요청 제한 관련 힌트를 반환하며 도구 요청을 자체적으로 재시도하지 않습니다.