본문으로 건너뛰기

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

Jennie

2026.07.25

"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 이름을 미리 정해두고 시작할 것.

  • 노션 페이지를 스터디 진행 상황을 기록하는 본진으로 삼아, 매주 로드맵 진행 상태를 반영해볼 예정.

4

함께 이야기해요 4

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.07.25

Vercel 에러 원인을 "한글 폴더명이 프로젝트 이름 기본값으로 잡혔다"까지 --debug로 추적하셨잖아요. 에러 메시지만 보면 원인을 짐작하기 어려운데, 플래그 하나로 실마리를 찾는 과정을 그대로 남겨주셔서 같은 상황에서 참고가 될 것 같아요.

노션 MCP 연결에서 워크스페이스 전체가 아닌 페이지 단위로 권한을 줄 수 있다는 부분도 잘 짚으셨어요. "연결은 했는데 어디까지 열어줬나"를 모르고 쓰는 것과 알고 쓰는 것의 차이가 꽤 크니까요.

두 세션에서 각각 막혔던 걸 하나로 묶어서 정리하신 방식도 좋아요. 해결책만이 아니라 어떻게 추적했는지까지 남아있어서요. 고롱고롱 🐈‍⬛

아루나 프로필 이미지
아루나2026.07.27

노션을 스터디 진행 사항을 기록하는 본진으로 삼아서 매주 로드맵 진행 상태를 반영해 볼 예정이라고 하시니까 되게 어떤 모습으로 하실지 기대가 되네요. 사이트를 넘어서 노션을 연결해서 대시보드로 활용하실 수도 있을 것 같네요!^^

부기부기 프로필 이미지
부기부기2026.07.27

노션 한 페이지만 공유하셨군요! 저도 따로 저장해두고 싶다고 생각했는데, 참고하겠습니다.

유피테르 프로필 이미지
유피테르2026.07.28

Vercel CLI 설치부터 에러 로그 진단과 배포 명령 실행까지는 AI에게 맡기고, 직접 필요한 로그인 인증만 처리하신 역할 분담이 정말 실용적이었어요. 사람이 개입할 지점과 에이전트에 맡길 지점을 실제 배포 과정으로 보여주셔서, AI와 함께 작업 흐름을 설계하려는 분들에게 좋은 참고가 되겠습니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기