첫 모듈 테스트

설치를 마치셨다면 Make.com에서 모듈 하나를 실행해 서버가 제대로 응답하는지 확인합니다. 여기서는 결과가 바로 눈에 보이는 Convert PDF to Text 모듈을 씁니다.

Make 연결과 첫 실행 (1:29, 이전 설치 화면 기준)

영상 속 매직밀키트 설치 화면은 예전 버전입니다. 서비스 URL과 API 키는 아래 1단계처럼 앱 상태 화면에서 복사하세요. Make.com 쪽 화면은 지금과 같습니다.

서비스 URL과 API 키 복사

make.magicmealkits.com 왼쪽 메뉴에서 앱 상태를 엽니다. 서비스 URL과 API 키 옆의 복사 버튼으로 두 값을 복사해 둡니다.

캡처 준비 중: 앱 상태 화면의 서비스 URL과 API 키

API 키는 비밀번호와 같습니다. 채팅방이나 공개된 곳에 붙여 넣지 마세요.

Make에서 모듈 추가

Make.com에서 새 시나리오를 만들고 + 버튼을 누릅니다. 검색창에 Magic Meal Kits를 입력하고 목록에서 Convert PDF to Text를 고릅니다.

캡처 준비 중: Make 모듈 검색 화면

연결 만들기

처음 쓰는 모듈이라 연결이 없습니다. Create a connection을 누르고 두 칸을 채운 뒤 Save를 누릅니다.

칸	넣을 값
Magic Meal Kits Service URL	1단계에서 복사한 서비스 URL
API Key	1단계에서 복사한 API 키

오류 없이 연결 이름이 보이면 연결이 끝났습니다.

캡처 준비 중: Make 연결 만들기 창

예시 PDF 넣기

Input Type은 PDF URL로 두고, PDF URL 칸에 아래 예시 주소를 넣습니다. Pages to Extract는 비워 두세요.

https://pdfobject.com/pdf/sample.pdf

한 번 실행

OK를 누른 뒤 시나리오 아래쪽의 Run once를 누릅니다. 모듈 위 말풍선을 눌러 출력을 엽니다. PDF 본문 텍스트가 들어 있으면 성공입니다.

캡처 준비 중: 실행 결과 출력 화면

실행이 실패한다면

연결을 저장할 때 오류가 납니다

서비스 URL 앞뒤에 공백이 들어갔거나 주소 일부만 복사된 경우가 많습니다. 앱 상태 화면에서 복사 버튼으로 다시 복사해 붙여 넣으세요. API 키를 재발급했다면 새 키로 바꿔야 합니다. API 키 재발급을 참고하세요.

503 오류가 나거나 응답이 없습니다

서버가 오래 쉬고 있었다면 첫 요청은 서버가 깨어나는 시간만큼 늦어집니다 (콜드 스타트). 잠시 뒤 다시 실행해 보세요. 계속 503이 나오면 503 에러 강제동기화로 해결하기를 따라 하세요.

그 밖의 오류

문제 해결에서 증상을 찾아보세요. 해결되지 않으면 오류 메시지를 캡처해 카카오톡으로 문의해 주세요.

구글 클라우드를 처음 쓰신다면 무료 체험이 끝나기 전에 결제 계정을 업그레이드해야 서버가 멈추지 않습니다. 지금 결제 활성화를 확인해 두세요.

시나리오 예시, MCP, CLI처럼 매직밀키트를 더 넓게 쓰는 방법을 봅니다.