AI 코딩, 비개발자 생존기 - Part 2: "커넥터 생성 오류"와의 끝나지 않는 전쟁
2025.11.27

1부에서 저는 Claude의 도움으로 우여곡절 끝에 로컬 서버를 띄우는 데 성공했습니다. 검은 터미널 화면에 Server running on port 8000이라는 메시지가 떴을 때, 저는 거의 다 왔다고 생각했습니다. 이제 이 서버 주소를 ChatGPT에 알려주기만 하면, 제 앱이 마법처럼 작동할 거라고 믿었죠.
하지만 그건 거대한 착각의 시작이었습니다. 이어진 몇 시간은 저와 Claude의, 끝나지 않는 오류와의 전쟁이었습니다.
첫 번째 벽: Request Timeout, 보이지 않는 거절
Claude가 알려준 ngrok 주소를 복사해 ChatGPT의 'Add App' 설정에 붙여넣고 '만들기' 버튼을 눌렀습니다. 기대에 부풀어 화면을 바라보던 제게 돌아온 것은 차가운 회색 메시지였습니다.
"Request timeout"
서버는 분명히 살아있는데, ChatGPT는 서버를 찾지 못하고 있었습니다. 이때부터 저와 Claude의 기나긴 디버깅 여정이 시작되었습니다.
오류와의 전쟁: AI와 함께한 문제 해결 과정
1차 시도: 헤더(Header) 문제?
Claude는 먼저 서버 로그를 확인했습니다. 로그에는 ChatGPT가 연결을 시도했지만, 서버가 연결을 수락하자마자 바로 끊어버리는 현상이 기록되어 있었습니다.
Claude의 가설: "SSE(Server-Sent Events) 연결이 유지되지 않는 것 같습니다. 연결을 계속 열어두라는 헤더 정보를 명시적으로 추가해 보겠습니다."
Claude는 server.ts 파일에 Connection: 'keep-alive'와 같은 헤더 설정 코드를 추가했습니다. 하지만 서버를 재시작하고 다시 시도하자, 이번엔 더 낯선 오류가 발생했습니다.
Error: ERR_HTTP_HEADERS_SENT
"헤더가 이미 전송되었다"는 뜻이었습니다. 알고 보니, 제가 사용한 라이브러리(@modelcontextprotocol/sdk)가 이미 헤더를 자동으로 설정하고 있었는데, Claude가 수동으로 또 추가하면서 충돌이 난 것이었죠. 결국 추가했던 코드는 다시 삭제해야 했습니다. 문제는 원점으로 돌아왔습니다.
2차 시도: POST 메시지를 못 받는다고?
점점 지쳐갔습니다. "안돼... 이거 고칠 수 있긴 한 거야?"
Claude는 포기하지 않고, 이번엔 서버에 더 상세한 로그를 남기도록 코드를 수정했습니다. ChatGPT가 어떤 요청을 보내는지 속속들이 들여다보기 위해서였죠. 그리고 다시 연결을 시도했을 때, 결정적인 단서가 포착되었습니다.
json[MCP] POST message received: {"method":"initialize", ...}
"POST 메시지를 받았습니다!"
문제는 이것이었습니다. 제 서버는 처음 연결을 시작하는 GET 요청에만 응답할 뿐, 이후 ChatGPT가 보내는 POST 방식의 initialize(초기화) 메시지를 처리하는 기능이 없었습니다. ChatGPT는 "안녕?" 하고 말을 걸었는데, 제 서버는 대답 없이 연결을 끊어버리고 있었던 겁니다.
3차 시도: 진짜 원인을 찾아서
Claude는 즉시 POST 요청을 처리할 수 있도록 app.post('/mcp/messages', ...) 라는 코드를 추가했습니다. 이제 메시지를 받을 수는 있게 되었죠. 하지만 여전히 연결은 실패했습니다.
로그는 미세하게 달라져 있었습니다. POST 메시지를 받기는 하지만, 여전히 그 직후 연결이 끊겼습니다.
Claude는 관련 공식 문서와 예제들을 다시 샅샅이 훑기 시작했습니다. 그리고 마침내 진짜 원인을 찾아냈습니다.
Claude의 최종 가설: "찾았습니다!
POST요청을 받아서transport.handlePostMessage(req, res)라는 함수로 전달해줘야 합니다. 이 함수가 받은 메시지를 현재 연결된 세션에 넘겨주는 역할을 하는데, 그 연결고리가 빠져있었습니다."
server.tstry { // 이 부분이 핵심! 받은 POST 요청을 현재 세션의 transport로 전달 await currentSession.transport.handlePostMessage(req, res); } catch (error) { console.error('[MCP] Message handling error:', error);
이 코드는 받은 편지(POST 요청)를 해당 편지의 주인(현재 세션)에게 전달해주는 우체부와 같은 역할이었습니다. 저희는 우체통만 만들어놓고, 정작 편지를 배달하는 것을 잊고 있었던 거죠.
마지막 시도, 그리고 세션 만료
이 '최종 수정'을 적용하고 서버를 재시작했습니다. 저는 마지막 희망을 걸고 다시 한번 ChatGPT 설정 창에서 '만들기' 버튼을 눌렀습니다.
결과는... "안돼... 커넥터 생성 중 오류라고 에러 메시지가 떴어"
또다시 실패였습니다. 그리고 그 순간, Claude와의 대화창에 메시지가 나타났습니다.
5-hour limit reached
몇 시간 동안의 사투가 허무하게 막을 내리는 순간이었습니다. 서버는 여전히 제 로컬 컴퓨터에서 외롭게 돌아가고 있었고, 제 앱은 ChatGPT에 닿지 못한 채 미아가 되었습니다.
저는 허탈함에 Claude에게 마지막 질문을 던졌습니다.
"근데... 챗GPT 공식 문서를 보고 제대로 개발하긴 한 거야? 왜 안 되는 거야?"
그 질문에 대한 답을 듣기도 전에, 세션은 완전히 종료되었습니다.
클로드가 쓴 코드를 코덱스에게 리뷰시켜보기
그래서 이후엔 드디어 코덱스를 이용해 보기로 했습니다.
클로드가 작성한 코드들을 코덱스를 이용해 리뷰해 보기로 한거죠.
저는 Claude가 남긴 코드 뭉치(habit-party-mvp)를 그대로 들고, 새로운 AI 조수 'Codex'를 찾아갔습니다. 그리고 물었습니다.
"방금까지 Claude랑 ChatGPT 앱을 만들었는데, 연결이 안 돼. 애초에 이게 제대로 만들어진 건지도 모르겠어. 네가 한번 분석해 줄래?"새로운 탐정의 등장: Codex의 날카로운 분석
Codex는 프로젝트 파일을 훑어보더니, Claude가 미처 발견하지 못했거나 수정 중에 꼬여버린 문제들을 날카롭게 지적하기 시작했습니다.
Codex의 진단 (치명도 순):
서버 즉사 버그:
server.ts파일에서 데이터베이스 주소(SUPABASE_URL)를 설정하는 코드가 주석 처리되어 있었습니다. 서버가 시작되자마자 주소를 찾지 못해 즉시 꺼지는 상태였습니다.잘못된 위젯 정보: 서버가 ChatGPT에게 위젯 정보를 알려줄 때,
text/html이 아닌text/html+skybridge라는 이상한 형식으로 알려주고 있었습니다. 게다가 실제 위젯 디자인(HTML)을 보내는 대신 "위젯은 저기 있어요"라는 텍스트만 보내고 있었죠.포트 설정 혼선: 서버는 8000번 포트를, 위젯은 4444번 포트를 사용하도록 되어 있는데,
ngrok은 무료 버전이라 포트를 하나밖에 열 수 없었습니다. Claude가 이 문제를 해결하려다 설정이 더 꼬여버린 것 같았습니다.깨진 HTML 파일:
habit-checkin.html파일 자체가 일부 깨져있어 ChatGPT가 읽어 들일 수 없는 상태였습니다.
저는 이 설명을 듣고도 무슨 말인지 절반도 이해하지 못했습니다. 하지만 한 가지는 확실히 알 수 있었죠. "아, 총체적 난국이구나."
AI의 수술 집도: "승인(Approve)만 눌러주세요"
"나는 개발 지식이 없으니, 네가 직접 수정해야 해."
server.ts대수술: 주석 처리된 데이터베이스 주석을 풀어주고, 꼬여있던 포트와 주소 설정을 바로잡았습니다. ChatGPT가 알아들을 수 있도록 위젯 정보 형식(mimeType)도text/html로 고쳤습니다.habit-checkin.html복원: 깨져있던 HTML 파일을 유효한 형식으로 복구했습니다.
다시, 출발선에 서다
모든 수정이 끝나고, Codex는 제게 마지막 지침을 주었습니다. 마치 퇴원하는 환자에게 약 복용법을 알려주는 의사처럼, 비개발자인 제가 알아들을 수 있는 언어로 차근차근 설명해주었죠.
.env파일 열어서PORT=4444로 바꾸기.터미널에서
npm run start로 서버 켜기.다른 터미널에서
ngrok http 4444실행하고, 나오는 주소 복사하기.복사한 주소를
.env파일의BASE_URL에 붙여넣고, ChatGPT 커넥터 설정에도 똑같이 넣기.
모든 준비는 끝났습니다. Claude와의 처절했던 사투, 그리고 Codex의 정밀한 수술을 거쳐 제 MVP는 다시 한번 ChatGPT의 문을 두드릴 준비를 마쳤습니다.
저는 떨리는 마음으로 터미널에 명령어를 입력하기 시작했습니다. 과연 이번에는, 이 기나긴 오류의 터널을 빠져나와 제 앱을 만날 수 있을까요?



