결제·이메일·로그인 같은 외부 연동 준비하기
결제·이메일·소셜 로그인처럼 바깥 서비스에 기대는 부분을 개발용으로 준비하는 곳이에요. 코드를 동기화하면 외부 연동을 자동으로 찾아내고, 세팅 지시서를 내 AI에게 건네면 개발 서버에 안전한 대체 장치가 생겨 로그인부터 결제 완료까지 흐름을 끝까지 검증할 수 있어요.
왜 개발 서버에서 검증하나요
검증은 실제 브라우저가 진짜 화면을 끝까지 눌러 보는 일이에요. 그런데 운영 주소(실제 서비스가 도는 곳)를 대상으로 하면, 로그인·결제·이메일 인증 같은 문이 전부 막혀 있어요. 그래서 로그인 이전 화면만 겨우 확인하는 얕은 검증에서 멈추기 쉽습니다.
Specnote는 이 문제를 개발 서버 + 개발 전용 준비로 풀어요. 개발 서버에는 진짜 결제 대신 연습용 결제, 진짜 메일 발송 대신 개발용 수신함 같은 안전한 대체 장치를 붙일 수 있어요. 그러면 로그인부터 결제 완료까지 흐름을 끝까지 검증할 수 있습니다.
이 준비를 도와주는 곳이 작업실 보드 왼쪽 메뉴의 외부 연동 자리예요(테스트 실행 바로 옆). 이 목록은 환경이 아니라 프로젝트 전체에 적용돼요.
세 단계면 끝나요
준비는 세 단계로 진행돼요. 어려운 설정은 AI가 대신 하고, 사용자는 확인만 하시면 됩니다.
- 코드를 동기화하면, 외부 연동을 자동으로 찾아내요. 코드를 연결해 두면 Specnote가 결제·이메일·소셜 로그인 같은 외부 연동을 스스로 알아채고 목록으로 보여줘요.
- "AI에게 세팅 맡기기"를 눌러, 나온 안내문을 내 AI에게 건네주세요. 화면에서 안내문을 복사해 IDE(코드 편집기)의 AI — Claude Code나 Cursor 같은 — 에게 붙여넣으면, AI가 개발 서버에 개발 전용 장치를 만들어 줘요. 연습용 결제 키, 개발용 메일 수신함, 테스트 로그인 경로 같은 것들이요.
- 코드를 다시 동기화하면, 잘 붙었는지 자동으로 확인해요. 장치가 제대로 자리 잡았는지, 검증이 흐름을 끝까지 통과하는지, 개발 서버가 "외부 연동 세팅이 켜져 있어요"라고 응답하는지 — 세 가지를 함께 확인합니다.
보조로 "외부 연동 활성화 확인" 버튼을 누르면, 개발 서버의 세팅이 실제로 켜져 있는지 그 자리에서 바로 볼 수 있어요.
안전 원칙 — 운영에서는 스스로 꺼져요
안내문이 만드는 모든 장치에는 두 겹의 안전장치가 들어 있어요.
- 개발 전용 세팅 스위치가 켜져 있을 것 — 그리고
- 운영 빌드가 아닐 것
이 두 가지가 동시에 맞을 때만 장치가 작동해요. 그래서 실수로 운영 주소를 입력하더라도, 운영에서는 장치가 스스로 꺼져 있어 아무 일도 일어나지 않습니다. 사고가 아니라 그냥 조용한 실패로 끝나요.
또 하나 — 안내문은 진짜 비밀키를 코드에 두지 않습니다. 결제 같은 건 결제사가 공식으로 나눠 주는 **연습용 키(테스트키)**만 써요. 새어 나가도 실제 돈이나 데이터에는 손대지 못하는 값이라 안심입니다.
연동 종류별로 이렇게 준비돼요
| 외부 연동 | 개발용 준비 |
|---|---|
| 결제 | 결제사가 주는 공식 연습용 키(테스트키)로 바꿔, 실제 돈이 오가지 않게 해요. |
| 이메일 | 진짜 발송 대신 개발용 수신함이나 화면 기록으로 받아, 메일 내용을 바로 확인해요. |
| 소셜 로그인 | 개발 전용 테스트 로그인 경로로 빠르게 들어가요. 다만 회사 계정(SSO)이나 일회용 번호(OTP)처럼 대체가 어려운 로그인은 테스트 환경과 계정 설정에서 안내하는 직접 로그인 방식을 그대로 씁니다. |
| 문자(SMS) | 실제 발송 없이 가짜 응답으로 대신해, 문자 단계에서 막히지 않게 해요. |
자주 묻는 것
개발 서버가 없는데요? 아직 배포 전이라 앱이 내 컴퓨터에서만 돌아도 괜찮아요. 테스트 환경과 계정 설정의 "내 컴퓨터에서만 도는 앱이라면"을 따라 하면 됩니다.
운영 주소를 입력하면 어떻게 되나요? 운영에는 개발 전용 장치가 꺼져 있어서, "잘 붙었는지" 확인이 통과되지 않아요. 검증도 얕아지고요. 이럴 때는 화면 안내대로 개발 서버 주소로 바꿔 주세요. 운영 데이터가 상할 일은 없지만, 개발 서버에서 해야 흐름을 끝까지 볼 수 있습니다.
실제로 안 쓰는 항목이 목록에 잡혔어요. 코드에 이름만 남아 있어도 목록에 잡힐 수 있어요(예: 예전에 검토만 했던 결제 회사). 그럴 때는 그 항목의 스위치를 꺼서 사용 안 함 탭으로 옮겨 주세요. 코드에 이름이 남아 있는 동안에는 지워지지 않고 사용 안 함 탭에 그대로 보관되고, 다시 쓰게 되면 스위치만 켜면 됩니다.
AI에게 맡겨도 돼요
이 준비도 화면에서 직접 해도 되고, 연결해 둔 AI에게 말로 부탁해도 돼요.
Specnote가 찾은 외부 연동 세팅 안내문 받아서, 개발 서버에 개발 전용 장치 붙여 줘. 다 하면 코드 다시 동기화해서 잘 붙었는지 확인해 줘.
AI 연결이 아직이라면 내 AI 연결하기 (MCP 설치)를 먼저 봐 주세요. 코드 연결이 아직이라면 내 코드와 연결하기부터 하면 됩니다.
준비가 끝났다면 검증 돌리고 결과 읽기로 넘어가 흐름을 끝까지 돌려 보세요. 로그인·결제 단계에서 자꾸 막힌다면 문제 해결을 함께 봐 주세요.