서버는 멀쩡한데 커넥터만 "연결 문제" — 주소 앞 www가 없어서 POST가 리다이렉트에 막혔다

1. 상황

초안 받는 서버(/api/mcp)를 배포하고 Claude 커스텀 커넥터에 주소를 넣었다. 처음 넣은 주소는 https://내도메인/api/mcp, 그러니까 www가 없는 주소였다. 결과는 "연결할 수 없습니다."

서버가 죽은 건지, 키가 틀린 건지, 방화벽인지 아무것도 알 수 없었다.

2. 확인한 것

서버에서 curl로 직접 두드려 봤다. -i로 응답 헤더까지 봤더니 답이 바로 나왔다.

curl -i -X POST https://내도메인/api/mcp

응답은 301 Moved Permanently였고 Location은 https://www.내도메인/api/mcp였다. 내 서버는 nginx 리버스 프록시에서 www 없는 주소를 www 있는 주소로 보내도록 되어 있었다.

3. 원인

브라우저로 페이지를 볼 때는 리다이렉트가 있어도 티가 안 난다. 그런데 MCP 클라이언트는 POST로 요청을 보낸다. 리다이렉트를 받으면 클라이언트에 따라 요청을 다시 보내지 않거나, POST가 GET으로 바뀌어 버려서 서버가 기대한 요청이 아니게 된다. [확인 필요: Claude 커넥터가 리다이렉트를 정확히 어떻게 처리하는지는 내가 직접 확인하지 못했다. 주소를 바꾸니 해결됐다는 것만 확인함]

4. 해결

커넥터 주소를 리다이렉트 이후의 최종 주소로 바꿨다.

https://www.내도메인/api/mcp

nginx 설정을 건드릴 필요는 없었다. 프록시에 예외 규칙을 추가할 생각도 했지만, 주소만 바꾸면 되는 일이었다.

[보강: 프록시를 수정하지 않고 주소만 바꾸기로 한 이유]

정리

• 커넥터나 웹훅 같은 서버끼리의 호출은 리다이렉트를 따라가 주지 않을 수 있다.
• 연결이 안 되면 curl -i로 상태 코드와 Location부터 보자. 301이면 거기에 정답이 적혀 있다.
• 등록할 주소는 리다이렉트가 끝난 최종 주소로 넣자.

다음 글에서는 이 서버에서 마크다운을 에디터용 데이터로 바꾸다가 빌드가 깨졌던 이야기를 다뤄보겠다.