내 학습허브
사례 1주차 2026-07-25 · 인스타 릴스·카드뉴스 자동화 루틴 연재

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

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

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

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

하려던 것 📝

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

활용한 툴 ⚒️

  • Vercel CLI (npm install -g vercel로 설치)
  • 클로드 코드 — 설치·로그인·배포 명령어 전 과정 대신 실행, 에러 로그 읽고 원인 진단

진행 세부 내용 🔍

  1. npm install -g vercel로 Vercel CLI 설치.
  2. vercel whoami로 로그인 상태 확인 → 미로그인이라 자동으로 로그인 절차가 시작됐고, 이미 브라우저에 Vercel 로그인이 되어 있어서 별도 클릭 없이 바로 인증 완료.
  3. vercel --prod --yes로 배포 시도 → 아래 에러 발생.
Error: An unexpected error occurred in deploy: Error: Detected linked project does not have "id".
  1. --debug 옵션을 붙여 다시 실행해서 원인을 추적했다. Vercel이 프로젝트 이름을 찾을 때 작업 폴더 이름을 그대로 쓰고 있었는데, 그 폴더 이름이 프로젝트(한글)였다. 이게 이상한 값으로 전달되면서 프로젝트를 못 찾고 에러가 난 것.
  2. 폴더 이름을 바꾸는 대신, 프로젝트 이름을 영문으로 직접 지정했다.
vercel link --yes --project my-learning-hub
  1. 이 한 줄로 프로젝트가 정상 생성되고, GitHub 저장소(my-learning-hub)까지 자동으로 연결됐다. 다시 vercel --prod --yes로 배포하니 정상적으로 빌드·배포되고 주소가 나왔다.

배운 점 📚

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

2. 노션 페이지 딱 하나만 AI에게 연결하기 (MCP)

하려던 것 📝

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

활용한 툴 ⚒️

  • 클로드 코드 (터미널 기반 AI 에이전트)
  • 노션 MCP (Model Context Protocol) — AI가 외부 서비스에 안전하게 연결하는 표준 방식

진행 세부 내용 🔍

  1. 노션 페이지 링크를 승관이에게 주고 “이 페이지를 스터디 본진으로 써줘”라고 요청.
  2. 승관이가 “이 페이지 아직 연결 안 돼 있어서 못 읽어”라고 바로 솔직하게 알려줬다. 짐작해서 답하지 않고 사실대로 말해준 것.
  3. 연결 방법을 두 가지로 정리해줬다: 터미널 명령어로 시작하는 법, 그리고 노션 페이지 안에서 직접 연결하는 법(우측 상단 ··· → Connections 메뉴). 페이지 안에서 직접 연결하면 그 페이지(와 하위 페이지)만 공유되고 워크스페이스 전체는 건드리지 않는다.
  4. 터미널에서 아래 명령어로 연결을 시작했다.
claude mcp add --transport http notion https://mcp.notion.com/mcp
  1. /mcp를 입력하니 브라우저로 OAuth 로그인 창이 떴다. (OAuth = 노션 비밀번호를 AI에게 직접 주는 게 아니라, 내가 직접 로그인하고 “허용” 버튼만 누르는 안전한 인증 방식.)
  2. 노션 계정으로 로그인 후 “허용(Allow)” 클릭 → 연결 완료. 이후 승관이가 그 페이지 내용을 직접 읽고 오늘 할 일을 정리해줄 수 있게 됐다.

배운 점 📚

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

향후 계획 🧭

  • 새 프로젝트를 시작할 땐 폴더 이름을 처음부터 영문으로 짓거나, 배포 전에 --project 이름을 미리 정해두고 시작할 것.
  • 노션 페이지를 스터디 진행 상황을 기록하는 본진으로 삼아, 매주 로드맵 진행 상태를 반영해볼 예정.

도움이 필요한 점 🤝

노션 MCP로 페이지를 “읽기”만이 아니라 “직접 쓰기(자동으로 채워 넣기)“까지 시켜본 적은 없어서, 다음 단계에서 시도할 때 막히면 도움이 필요할 수도 있다.