FALCON 스위칭쇼츠2기 MCP 윈도우를 쓰시나요? → 윈도우 설치 안내

FALCON MCP 맥북 설치

Mac인텔 · 애플 실리콘(M1~) 모두

아래 번호 순서대로 따라 하시면 됩니다. 설치 파일 하나를 열면 필요한 것을 확인하고, 없는 것만 물어보고 설치합니다.

0준비물

접속코드 10자리 — 초대받은 것. 4번 단계의 브라우저 화면에만 넣습니다. 채팅창·메신저에 붙여넣지 마세요.
FALCON 서버 주소 — 접속코드와 함께 따로 받은 것. https:// 로 시작하고 /friend-mcp 로 끝납니다. 3번 단계에서 설치기가 물으면 붙여넣습니다.
Claude 유료 구독 — Pro · Max · Team · Enterprise 중 하나. 무료 요금제는 안 됩니다.
인터넷 연결, 디스크 여유 5GB 이상

1맥북용 설치 파일 받기

⬇ FALCON_맥북용.zip 다운로드

작은 파일입니다(약 5KB). 받으면 «다운로드» 폴더에 저장됩니다.

2압축 풀고 설치 파일 열기

ZIP 을 더블클릭하면 FALCON_맥북용 폴더가 생깁니다. 그 안의 FALCON_맥북_설치하기.command 를 엽니다.

처음 열면 «확인되지 않은 개발자라 열 수 없습니다» 창이 뜹니다. 고장이 아니라 맥의 보안 확인입니다. 아래 셋 중 하나로 여세요.

가) 파일을 우클릭 → 열기 → 다시 열기
나) 시스템 설정 → 개인정보 보호 및 보안 맨 아래의 «그래도 열기»
다) 터미널(⌘+Space → «터미널»)에 아래 한 줄을 붙여넣고 엔터 — 가장 확실합니다

xattr -dr com.apple.quarantine ~/Downloads/FALCON_맥북용 && bash ~/Downloads/FALCON_맥북용/FALCON_맥북_설치하기.command

3설치기가 알아서 확인합니다

터미널 창이 열리고 아래를 하나씩 확인합니다. 칩이 인텔인지 M1~ 인지도 스스로 알아봅니다.

확인 항목	없으면
홈브류(설치 도우미)	설치할지 묻습니다 — y
파이썬 3.11 이상	묻고 설치
ffmpeg · ffprobe	묻고 설치
Claude Code	묻고 설치
FALCON 전용 환경, 작업 폴더 `~/FalconWork`	자동으로 만듭니다
FALCON 서버 주소	«주소:» 를 묻습니다 — 따로 받은 주소를 붙여넣고 엔터

맥을 새로 산 직후라면 홈브류를 깔 때 «명령줄 개발자 도구» 설치 창이 함께 뜨고, 터미널이 «Press RETURN» 을 물으면 엔터를 누릅니다. 이 과정에 보통 5~15분 걸립니다(컴퓨터에 따라 다름). 창을 닫지 말고 끝날 때까지 기다리세요. 맥의 관리자 계정으로 해야 합니다.

«설치할까요? [y/N]» 이 나오면 y 후 엔터. 맥 비밀번호를 물을 수 있습니다(글자가 안 보이는 것이 정상).

4브라우저에서 접속코드 인증

설치기 끝에 브라우저가 자동으로 열립니다. «접속코드» 칸에 10자리를 넣고 로그인을 누르세요.

터미널에 Waiting for authorization… 이 떠서 멈춘 듯 보여도 정상입니다. 브라우저에서 로그인하면 알아서 이어집니다.

브라우저가 안 열리면 터미널에 나온 https://falcon…/authorize?… 주소를 복사해서 직접 여세요.

5실행기 받기

새 터미널을 열고 아래를 실행해 Claude 를 켭니다. Claude Code 를 이번에 처음 깔았다면 먼저 claude 만 쳐서 본인 Claude 계정으로 로그인해 두세요.

cd ~/FalconWork && claude

Claude 에게 이렇게 말하세요.

falcon_setup 을 실행해 줘. 알려 주는 주소에서 실행기를 받아 ~/FalconWork/falcon_local_runner.py 로 저장하고, 서버가 알려 준 sha256 과 같은지 확인해 줘.

지문이 다르면 다시 받습니다(최대 2번). 계속 다르면 멈추고 알려 주세요.

6점검

터미널에서 한 줄씩 따로 실행합니다.

~/.volcano/venv/bin/python ~/FalconWork/falcon_local_runner.py selfcheck

~/.volcano/venv/bin/python ~/FalconWork/falcon_local_runner.py capability

"ready": true 가 나오면 준비 완료입니다. Claude 에게 «capability 결과를 falcon_capability 로 보내 줘» 라고 하면 서버가 확인해 줍니다.

«받아쓰기(Speechmatics)가 설치되어 있지 않습니다» 가 나오면 화면의 안내 줄(pip install speechmatics-python)을 그대로 실행한 뒤 capability 를 다시 돌리세요.

7첫 영상

Claude 에게 이렇게 말하면 시작합니다.

falcon_local_make 로 영상을 시작해 줘

완성된 영상은 바탕화면의 «FALCON 작업» 폴더에 들어옵니다.

막혔을 때

«확인되지 않은 개발자» 창에서 열기 버튼이 없어요

최신 macOS 는 우클릭 열기도 막을 수 있습니다. 2번 단계의 나) 또는 다) 를 쓰세요.

claude mcp login 이 없다고 나와요

Claude Code 가 옛 판입니다. 터미널에서 아래를 실행하고 새 터미널 창에서 설치 파일을 다시 여세요.

curl -fsSL https://claude.ai/install.sh | bash

«주소 모양이 다릅니다» / 서버 주소를 잘못 넣었어요

주소는 접속코드와 함께 받은 것을 그대로 붙여넣습니다(https:// 로 시작, /friend-mcp 로 끝). 이미 틀린 주소로 등록됐다면 터미널에서 아래를 실행한 뒤 설치 파일을 다시 여세요.

claude mcp remove falcon -s user

홈브류를 설치하라는데 비밀번호를 물어요

맥 로그인 비밀번호입니다. 입력해도 글자가 안 보이는 것이 정상이고, 입력 후 엔터를 누르면 됩니다. 설치가 끝나면 설치 파일을 다시 여세요.

«현재 사용할 수 없는 접속코드» / «다시 확인해 주세요»

앞의 말은 코드가 있지만 지금 막혀 있다는 뜻, 뒤의 말은 글자가 틀렸다는 뜻입니다. 대문자 I 와 소문자 l, 숫자 0 과 알파벳 O 가 헷갈리지 않는지 확인하고, 그래도 안 되면 코드를 준 사람에게 알려 주세요.

인물형 채널은 글꼴이 없다고 해요

인물형 채널에만 필요한 글꼴 2종입니다. 다른 채널은 그대로 됩니다. 인물형을 하실 때 falcon_local_make 가 받는 법을 알려 줍니다.

인텔 맥에서 터미널이 «Rosetta» 로 열려 있다는 안내가 나와요

터미널 앱 정보 창의 «Rosetta 를 사용하여 열기» 체크를 끄고 터미널을 다시 여세요.

그래도 안 돼요

터미널 화면에서 ✘ 가 붙은 줄을 그대로 캡처해서 보내 주세요.

FALCON 스위칭쇼츠2기 MCP · 맥북판 안내