MCP 문제 해결
MCP 연결과 쇼핑몰 생성에서 자주 막히는 문제
MCP 연결과 쇼핑몰 생성에서 자주 막히는 증상을 확인하고 해결합니다.
연결
| 증상 | 확인 | 해결 |
|---|---|---|
MCP 서버 목록에 sayren이 없음 | 설정 파일 위치 | 도구를 완전히 종료 후 재시작 |
sayren 서버가 시작하지 못함 | node -v | Node.js 22 이상 설치 |
SAYREN_TOKEN이 없습니다 | 설정의 env | 토큰을 넣고 재시작 |
옛 API 토큰(sy_pat_)은 더 쓸 수 없습니다 | SAYREN_TOKEN 값 | Sayren 계정 › 액세스 토큰에서 새로 만들어 넣음 |
SAYREN_STORE_ID를 넣으라는 안내 | 토큰의 상점 범위가 여럿인지 | env에 SAYREN_STORE_ID를 넣음 |
SAYREN_STORE_ID(…)가 이 토큰의 상점 범위 밖입니다 | 토큰의 상점 범위 | 그 상점이 들어간 토큰을 새로 만듦 |
UNAUTHORIZED·TOKEN_REVOKED | Sayren 계정 › 액세스 토큰에서 토큰 상태 | 폐기·만료된 토큰이면 새로 만듦 |
INSUFFICIENT_ROLE | 토큰 권한과 내 역할 | 필요한 권한으로 새로 만듦 |
쇼핑몰 생성
| 증상 | 확인 | 해결 |
|---|---|---|
| 홈에 상품이 없음 | .env의 SAYREN_STORE_CODE | 설정 › 상점 정보의 코드로 고치고 재시작 |
| 홈에 상품이 없음(상점 코드는 맞음) | 상점 관리 › 상품 › 상품 목록의 상품 상태 | 판매중으로 변경 |
STORE_NOT_FOUND | SAYREN_STORE_CODE가 비었는지 | 상점 코드를 넣음 |
결제 요청이 RETURN_URL_NOT_ALLOWED | 설정 › 결제의 결제 도메인 | 쇼핑몰 주소를 추가하거나 목록을 비움 |
결제 요청이 PAYMENT_NOT_CONFIGURED | 설정 › 결제에 사용중인 PG가 있는지 | 결제 설정대로 PG 연결 |
| 결제 버튼을 눌러도 창이 안 뜸 | 팝업 차단 표시, payment-popup-prepare | 차단 해제 또는 위반 수정 |
| 결제 후 완료 화면으로 안 넘어감 | payment-return-route·payment-processing-status | src/routes/checkout.return.tsx를 원본으로 되돌림 |
| 결제창 금액이 화면 금액보다 큼 | delivery-quote-preview·payment-amounts-final | 위반 수정(배송비) |
| 장바구니·주문서에서 갑자기 로그아웃 | buyer-session-refresh | src/lib/session.server.ts·src/start.ts를 원본으로 되돌림 |
| 약관 개정 뒤 재동의를 받지 않음 | buyer-reconsent | 위반 수정(구매자 인증) |
규칙 id(payment-… 등)는 verify_storefront 결과에서 확인합니다. 설정 › 결제는 소유자만 엽니다.
검사 결과 읽기
위반마다 고칠 파일·줄, 수정 방법, 예시 코드가 옵니다. 에이전트에게 "결과의 fix대로 고치고 다시 검사해줘"라고 요청합니다. 규칙은 지켜야 할 규칙, 출력 필드는 MCP 도구 레퍼런스에 있습니다.