재밋 블로그 | 제미나이 MCP 연결 방법, Gemini CLI 설치부터 재밋 연동까지

Q: 2단계. API 키는 왜 따로 발급받아야 하나요?

제미나이 CLI는 재밋과 별개로 자체 인증 이 필요해요. ① 키 발급받기 구글 AI 스튜디오 에 접속해서 API 키 만들기를 누른 다음 나온 키를 복사합니다. ② 환경 변수로 등록하기 복사한 키는 환경변수에 저장해둡니다. 키가 그대로 노출되어 도용될 수 있어 변수에 저장해놓고 사용하는 것이에요. 윈도우 PowerShell이라면 이렇게 [Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "발급받은_키", "User") 맥이나 리눅스라면 ~/.zshrc 또는 ~/.bashrc 파일에 아래 줄을 한 줄 추가해요. export GEMINI_API_KEY="발급받은_키" 발급받은_키 자리에는 아까 복사한 키를 그대로 붙여넣습니다. ③ 터미널 닫기 이거 중요해요! 등록을 마쳤으면 터미널 창을 꼭 닫으셔야 합니다. 이미 열려 있던 창은 방금 만든 변수를 못 알아보거든요. 이걸 모르고 그냥 진행하다가 “왜 안 되지?” 하는 분들이 참 많습니다.

안녕하세요? 이번에는 제미나이 MCP 연결 방법을 들고왔어요.
지난 ChatGPT, 재밋 MCP 연동 완벽가이드 편에 이어 제미나이 CLI에 재밋 MCP를 붙이는 순서를 처음부터 정리했어요.
제미나이CLI(Command Line Interface)는 까만 바탕에 텍스트만 가득하여 접근이 어렵게 느껴지실 수 있어요.
하지만 가이드라인을 쭉 따라오시면 금방! 하실 수 있습니다.

제미나이CLI를 설치하고 API 키 받아서 작업 폴더로 재밋 서버 붙인 다음 로그인하면 끝!
처음 하시면 10분쯤 잡으면 넉넉해요.

이제 시작해볼까요?😊

제미나이 MCP가 뭔가요?

MCP(Model Context Protocol)는 제미나이 같은 AI 도구를 바깥 서비스와 연결하는 표준 규칙이에요. 제미나이 CLI에 MCP 서버를 등록하면 제미나이가 그 서비스의 기능을 도구처럼 꺼내 씁니다.

그래서 재밋 MCP를 연결하면 뭐가 달라지나요?

MCP는 제미나이 같은 AI 도구를 바깥 서비스에 연결해주는 통로라서 재밋 MCP를 붙이면 제미나이가 내가 생성한 재밋 사이트를 직접 다룰 수 있게 됩니다.
원래는 사이트 하나 만들려면 편집기를 따로 열고 화면 익히고 버튼 하나하나 눌러가며 작업해야 했는데 MCP를 연결하면 그 과정이 전부 대화로 바뀌는 것이죠!
“쇼핑몰 만들어줘”, “상품 페이지에 후기 영역 추가해줘” 이렇게 말 해보세요!

시작 전에 챙길 것

Node.js 20 버전 이상 — 제미나이 CLI가 공식적으로 요구하는 버전이에요. 이게 없으면 설치를 진행할 수 없으니 nodejs.org에서 받아주세요.
구글 계정 — 2단계에서 API 키 받을 때 씁니다.
재밋 계정 — 아직 없으면 회원가입부터!

재밋 계정은 5단계에서 바로 필요하니 미리 만들어두는 걸 추천드려요.

1단계. 제미나이 CLI 설치하기

터미널부터 엽니다. 윈도우는 PowerShell이에요.

거기에 아래 한 줄을 붙여넣고 Enter!

npm install -g @google/gemini-cli

설치가 끝나면 잘 깔렸는지 확인해볼게요.

gemini --version

PowerShell에서 gemini --version을 실행해 버전 0.52.0이 출력된 화면

이렇게 버전 번호가 뜨면 성공이에요!

여기서 npm을 모르겠다는 메시지가 뜨면 Node.js가 아직 설치되어있지 않다는 뜻입니다.
위에 적어둔 링크에서 먼저 설치하고 오시면 됩니다.

2단계. API 키는 왜 따로 발급받아야 하나요?

제미나이 CLI는 재밋과 별개로 자체 인증이 필요해요.

① 키 발급받기

구글 AI 스튜디오에 접속해서 API 키 만들기를 누른 다음 나온 키를 복사합니다.

② 환경 변수로 등록하기

복사한 키는 환경변수에 저장해둡니다.
키가 그대로 노출되어 도용될 수 있어 변수에 저장해놓고 사용하는 것이에요.

윈도우 PowerShell이라면 이렇게

[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "발급받은_키", "User")

맥이나 리눅스라면 ~/.zshrc 또는 ~/.bashrc 파일에 아래 줄을 한 줄 추가해요.

export GEMINI_API_KEY="발급받은_키"

발급받은_키 자리에는 아까 복사한 키를 그대로 붙여넣습니다.

③ 터미널 닫기

이거 중요해요! 등록을 마쳤으면 터미널 창을 꼭 닫으셔야 합니다.
이미 열려 있던 창은 방금 만든 변수를 못 알아보거든요. 이걸 모르고 그냥 진행하다가 “왜 안 되지?” 하는 분들이 참 많습니다.

3단계. 작업 폴더 하나 정해두기

제미나이 CLI는 폴더 단위로 동작해요. 어느 폴더에서 실행했는지에 따라 작업 공간이 정해집니다. 그래서 재밋 작업용 폴더를 하나 정해두는 게 좋아요.

원하는 위치에 폴더를 하나 만들어 엽니다. 폴더 상단 주소 표시줄의 빈 공간을 클릭하고 powershell.exe를 입력한 뒤 Enter를 눌러보세요. 그 폴더 위치에서 터미널이 바로 열립니다!

터미널이 열리면 아래 세 줄을 차례로 입력!

mkdir zaemit-mcp
cd zaemit-mcp
gemini

실행하면 두 가지를 묻습니다!
이대로 답해주세요!

질문	선택
이 폴더를 신뢰하시겠습니까?	신뢰함
인증 방식	Gemini API Key

인증 방식에서 다른 걸 고르면 2단계에서 등록한 키를 안 쓰게 돼요.
이 곳에서 꼭 Gemini API Key를 선택해 주세요.

4단계. 재밋 서버 붙이기

이제 제미나이한테 “재밋이라는 곳이랑 연결해줘”라고 알려줄 순서입니다.
터미널에 아래 명령을 넣는데 좀 길어서 오타 나기 딱 좋으니 꼭 복사해서 붙여넣으세요!

gemini mcp add --transport http --scope user zaemit <https://zaemit.ai/connect/mcpServer>

성공하면 이렇게 출력 됩니다.

The zaemit MCP server has been successfully registered globally:

globally라고 나온 건 이 컴퓨터 전체에 등록됐다는 뜻이에요.
다른 폴더에서 제미나이를 켜도 재밋이 따라옵니다.

등록한 내용은 settings.json 파일에 저장돼요. --scope user로 등록했기 때문에 위치는 사용자 폴더 안의 .gemini/settings.json이고, 열어보면 이렇게 적혀 있습니다.

{
  "mcpServers": {
    "zaemit": {
      "url": "https://zaemit.ai/connect/mcpServer",
      "type": "http"
    }
  }
}

명령어 대신 이 파일에 직접 적어도 똑같이 등록돼요. 다른 MCP 서버를 붙일 때도 mcpServers 안에 한 덩어리씩 추가하면 됩니다.

5단계. 로그인은 어떻게 하나요?

거의 다 왔어요!🎉 마지막은 재밋 계정으로 로그인하는 단계입니다.

시작하기 전에 확인할 게 있는데 여기서 어긋나면 엉뚱한 사이트에 연결되거나 로그인 창이 아예 안 뜨거든요.

재밋에 로그인한 브라우저가 이 컴퓨터의 기본 브라우저인지
사이트를 여러 개 운영 중이라면 지금 연결하려는 바로 그 사이트의 관리자인지
시크릿 창 말고 일반 창인지

관리자 콘솔 탭은 열어둔 채로 두시면 됩니다.

준비되셨으면 zaemit-mcp 폴더에서 터미널을 새로 열고 제미나이를 켭니다.

gemini

제미나이가 켜지면 대화창에 이렇게 입력해요.

/mcp auth zaemit

브라우저로 로그인 창이 넘어갑니다. 로그인하면 재밋 MCP 연동 끝!

이런 팝업이 뜨면 어떻게 하나요?

분명 연동은 된 것 같은데 이런 화면이 뜨는 경우가 있어요.

연결할 사이트가 없어요 팝업 — AI 권한 3단계 + 개인정보 원문 접근 체크박스

재밋에서 사이트를 하나도 안 만든 상태로 MCP를 연동하면 나오는 팝업입니다.
연결할 대상이 없어서 묻는 질문인데요.

‘새 사이트를 개설하고 연결’ 을 눌러주세요.
그러면 이런 화면으로 넘어갑니다.

여기까지 왔으면 진짜 끝!

6단계. 연결됐는지 확인하기

로그인까지 마쳤으면 제대로 붙었는지 확인해볼게요. 터미널에서는 gemini mcp list, 제미나이 대화창에서는 /mcp list를 입력합니다. 윈도우 PowerShell에서 오류가 뜨면 gemini.cmd mcp list로 입력해주세요.

PowerShell에서 gemini.cmd mcp list 실행 후 zaemit Connected가 뜬 화면

zaemit 앞에 ✓, 끝에 Connected가 보이면 연결된 거예요. ✗와 Disconnected가 뜨면 아래 자주 묻는 질문을 확인해주세요.

자주 묻는 질문

Q1. 터미널이 처음인데 괜찮을까요?

명령어는 전부 이 글에 있으니 복사만 하면 됩니다. 다만 까만 화면 자체가 부담스러우시면 웹에서 진행하는 ChatGPT 편이 더 편하실 거예요.

Q2. `npm`이 뭔지 모르겠다는 메시지가 떠요.

Node.js가 아직 설치되지 않았다는 뜻이에요. nodejs.org에서 20 버전 이상을 설치한 뒤 1단계부터 다시 밟으면 됩니다.

Q3. 키를 등록했는데 계속 인증하라고 나와요.

2단계 ③번을 다시 보세요. 환경 변수를 등록한 뒤에는 터미널을 닫았다가 새로 열어야 새 키를 알아봅니다.

Q4. 재밋 크레딧은 어떻게 차감되나요?

제미나이 같은 외부 AI를 MCP로 연결해서 작업하면 재밋 크레딧은 차감되지 않아요. 재밋에 들어 있는 AI를 쓸 때만 크레딧이 소모됩니다.

Q5. 사이트가 여러 개면 어떤 게 연결되나요?

연결 하나는 사이트 한 곳에 묶여요. 다른 사이트를 다루려면 그 사이트로 새로 연결해야 해요.

Q6. 이미 만들어둔 사이트가 있으면 그 팝업이 안 뜨나요?

네! 팝업은 연결할 사이트가 없을 때만 나옵니다.

Q7. 연결했는데 제미나이가 재밋을 못 찾아요.

6단계 확인 명령에서 Disconnected가 뜨는지 먼저 보세요. 뜬다면 제미나이를 껐다 켠 뒤 /mcp auth zaemit으로 다시 로그인해 보세요. 그래도 안 되면 4단계 명령의 주소에 오타가 없는지 확인합니다.

Q8. "이 시스템에서 스크립트를 실행할 수 없으므로..."라는 빨간 오류가 나와요.

윈도우 PowerShell 보안 설정 때문에 생기는 오류예요. 명령어의 gemini를 gemini.cmd로 바꿔 입력하면 됩니다. 예: gemini.cmd --version

생각보다 할 만하죠? 터미널 창에서 바로 사이트가 나온다는 게 처음엔 좀 신기하더라고요.

다음에는 클로드에서 MCP 연동하는 방법을 들고와볼게요!

2026년 8월에 쓰고 10월에 내용을 보강했어요. 확인한 제미나이 CLI 버전은 0.64.0이고, 화면은 7월에 캡처한 거라 지금과 조금 다를 수 있어요. 그럴 땐 명령어 위주로 따라오시면 됩니다!

재밋으로 사이트 만들어 보기

이 글이 도움이 됐나요?좋아요와 공유는 다음 글을 쓰는 큰 힘이 됩니다.

WRITTEN BY민

Zaemit을 만들면서 배운 것과 겪은 일을 솔직하게 적습니다.

이 글의 태그

#제미나이CLI #GeminiCLI #MCP #MCP연동 #MCP 웹사이트 #MCP 웹사이트 운영 #MCP 웹서버 배포 #바이브코딩 웹사이트 운영 #재밋 #AI웹빌더 #홈페이지제작 #노코드 #터미널 #활용법