오늘 겪은 두 가지 막힘 — Vercel 배포 에러, 노션 MCP 연결

"linked project does not have id" 에러의 원인을 찾아 배포를 마치고, 노션 페이지 하나만 AI에게 연결하는 법까지 정리했다.

오늘은 서로 다른 두 세션에서 각각 막혔다가 뚫은 게 있어서 하나로 묶어 정리한다. 하나는 사이트 배포 중 만난 에러, 하나는 AI에게 노션 페이지 하나만 열어준 과정.

1. Vercel 배포 에러 — 원인은 한글 폴더 이름이었다

하려던 것 📝

GitHub에 올려둔 학습허브 사이트를 Vercel CLI로 실제 인터넷 주소에 배포하기. 명령어는 전부 AI(승관)가 대신 실행하고, 나는 로그인 인증 화면만 직접 처리했다.

활용한 툴 ⚒️

진행 세부 내용 🔍

npm install -g vercel로 Vercel CLI 설치.
vercel whoami로 로그인 상태 확인 → 미로그인이라 자동으로 로그인 절차가 시작됐고, 이미 브라우저에 Vercel 로그인이 되어 있어서 별도 클릭 없이 바로 인증 완료.
vercel --prod --yes로 배포 시도 → 아래 에러 발생.

Error: An unexpected error occurred in deploy: Error: Detected linked project does not have "id".
복사

--debug 옵션을 붙여 다시 실행해서 원인을 추적했다. Vercel이 프로젝트 이름을 찾을 때 작업 폴더 이름을 그대로 쓰고 있었는데, 그 폴더 이름이 프로젝트(한글)였다. 이게 이상한 값으로 전달되면서 프로젝트를 못 찾고 에러가 난 것.
폴더 이름을 바꾸는 대신, 프로젝트 이름을 영문으로 직접 지정했다.

vercel link --yes --project my-learning-hub
복사

이 한 줄로 프로젝트가 정상 생성되고, GitHub 저장소(my-learning-hub)까지 자동으로 연결됐다. 다시 vercel --prod --yes로 배포하니 정상적으로 빌드·배포되고 주소가 나왔다.

배운 점 📚

Vercel CLI는 별도 설정이 없으면 작업 폴더 이름을 프로젝트 이름 기본값으로 쓴다. 한글·특수문자 폴더에서 작업 중이라면 처음부터 --project 영문이름을 지정하는 게 안전하다.
에러 메시지만으로 원인이 안 보일 땐 --debug 옵션으로 실제 오간 요청을 보면 실마리가 나온다.
vercel link로 GitHub 저장소와 연결해두면, 이후엔 GitHub에 커밋만 올려도 자동 재배포된다.

하려던 것 📝

AI 온보딩 4주 스터디를 정리해둔 노션 페이지를 AI 학습메이트(승관)가 직접 읽었으면 했다. 다만 워크스페이스 전체를 열어주긴 부담스러워서, 그 페이지 하나만 볼 수 있게 연결하고 싶었다.

활용한 툴 ⚒️

진행 세부 내용 🔍

노션 페이지 링크를 승관이에게 주고 “이 페이지를 스터디 본진으로 써줘”라고 요청.
승관이가 “이 페이지 아직 연결 안 돼 있어서 못 읽어”라고 바로 솔직하게 알려줬다. 짐작해서 답하지 않고 사실대로 말해준 것.
연결 방법을 두 가지로 정리해줬다: 터미널 명령어로 시작하는 법, 그리고 노션 페이지 안에서 직접 연결하는 법(우측 상단 ··· → Connections 메뉴). 페이지 안에서 직접 연결하면 그 페이지(와 하위 페이지)만 공유되고 워크스페이스 전체는 건드리지 않는다.
터미널에서 아래 명령어로 연결을 시작했다.

claude mcp add --transport http notion https://mcp.notion.com/mcp
복사

/mcp를 입력하니 브라우저로 OAuth 로그인 창이 떴다. (OAuth = 노션 비밀번호를 AI에게 직접 주는 게 아니라, 내가 직접 로그인하고 “허용” 버튼만 누르는 안전한 인증 방식.)
노션 계정으로 로그인 후 “허용(Allow)” 클릭 → 연결 완료. 이후 승관이가 그 페이지 내용을 직접 읽고 오늘 할 일을 정리해줄 수 있게 됐다.

배운 점 📚

노션 MCP 연결은 claude mcp add --transport http notion https://mcp.notion.com/mcp 명령어 한 줄 + 브라우저에서 “허용” 클릭이면 끝난다.
MCP 연결은 워크스페이스 전체가 아니라 페이지 단위로 권한을 좁힐 수 있다. 페이지 안 ··· → Connections에서 직접 추가하면 그 페이지만 공유된다.
AI가 “읽을 수 없다”고 솔직히 말해주는 게, 짐작으로 답하는 것보다 결과적으로 더 도움이 된다.

향후 계획 🧭