⚡ Falcon MCP 전용 설치 포털

FALCON MCP 설치

처음 설치하시는 분도 순서대로 진행하면 됩니다.

🚀 FALCON 설치하기 (다운로드) 📖 설치 가이드 보기

⚡ 다운로드 후 다음 순서 안내

1. ZIP 압축을 풉니다. (다운로드한 FALCON_FRIEND_READY_2026-09-17_FINAL8.zip)
2. FalconFriendTest\FALCON 설치 시작.html 더블클릭 (더블클릭하면 자동으로 FALCON SETUP 화면이 열립니다)
3. FALCON SETUP 화면의 안내대로 설치합니다. (시스템 점검 및 단계별 설정 진행)
4. 설치 완료 후 바탕화면의 "FALCON MCP 시작" 아이콘으로 실행합니다.

✓ API 키 불필요 (서버 대행) ✓ 100% 로컬 렌더링 보안 ✓ 4개 채널 수용 구조 ✓ 안전한 브라우저 인증

STEP 01 / 12 배포 ZIP 파일 받기

배포 ZIP 파일 받기

최신 정본 안내 꾸러미 압축 파일(FALCON_FRIEND_READY_2026-09-17_FINAL8.zip)을 PC에 내려받습니다.

실행할 동작 (아래 버튼으로 즉시 다운로드)

📦 FALCON_FRIEND_READY_2026-09-17_FINAL8.zip 다운로드

✓ 정상 결과

내 PC 다운로드 폴더에 FALCON_FRIEND_READY_2026-09-17_FINAL8.zip 파일이 정상적으로 저장되어 있습니다.

💡 패키지 성격 안내

이 꾸러미는 설치 안내 화면과 점검 도구입니다. 실제 실행기(runner)는 이후 10단계에서 서버가 내려줍니다.

압축 풀기 및 시작 파일 확인

내려받은 ZIP 파일의 압축을 풉니다. 최상위 폴더에 FALCON 설치 시작.html이 바로 보입니다.

✓ 첫 실행 파일

압축을 푼 후 폴더에 보이는 FalconFriendTest\FALCON 설치 시작.html 파일을 더블클릭하면 자동으로 설치 도우미 화면으로 연결됩니다.
FalconFriendTest/FALCON 설치 시작.html
FalconFriendTest/installer/README_FIRST.txt

💡 참고 사항

실제 영상 제작 실행기(falcon_local_runner.py)는 이 ZIP 안에 없는 것이 정상입니다. 이후 10단계에서 FALCON 서버가 직접 발급해 줍니다.

Python 3 확인

Windows 명령 프롬프트(또는 PowerShell)를 열고 Python 3이 설치되어 있는지 확인합니다.

터미널에 입력할 명령어

python -V

✓ 정상 결과

Python 3.11.x (또는 Python 3.10 이상) 버전이 출력됩니다.

⚠️ 파이썬이 없는 경우 간편 설치 명령어

아래 한 줄 명령어를 그대로 복사해서 터미널에 붙여넣으세요:

winget install --id Python.Python.3.11 --exact --silent --accept-package-agreements --accept-source-agreements

ffmpeg / ffprobe 확인

영상 렌더 및 오디오 합성에 필수적인 ffmpeg와 ffprobe가 모두 설치되어 있는지 확인합니다.

1) ffmpeg 확인

ffmpeg -version

2) ffprobe 확인

ffprobe -version

✓ 정상 결과

두 명령어 모두 버전 정보가 정상적으로 출력됩니다.

⚠️ 없을 경우 간편 설치 명령어

아래 명령어로 설치 시 ffprobe도 같이 들어옵니다. (설치 후에는 «새 터미널»을 열어주세요):

winget install --id Gyan.FFmpeg --exact --silent --accept-package-agreements --accept-source-agreements

Claude Code 확인

FALCON 에이전트와 소통하고 명령을 전달할 Claude Code가 설치되어 있는지 확인합니다.

터미널에 입력할 명령어

claude --version

✓ 정상 결과

@anthropic-ai/claude-code v... 버전이 출력됩니다.

필요한 Python 패키지 설치

로컬에서 이미지 처리 및 프레임 렌더링에 필요한 파이썬 패키지를 설치합니다.

터미널에 입력할 필수 명령어

python -m pip install --user Pillow numpy opencv-python

✓ 정상 결과

Successfully installed Pillow numpy opencv-python 문구가 나타납니다.

💡 받아쓰기(Speechmatics) 본인 키 보유자만 (선택)

본인 Speechmatics 키가 있는 경우에만 실행하세요 (없으면 건너뜁니다):

python -m pip install --user speechmatics-python

설치 안내 화면 열기

압축 푼 폴더의 FalconFriendTest\FALCON 설치 시작.html(또는 installer\ui\index.html) 파일을 더블클릭하여 브라우저로 엽니다.

✓ 정상 결과

어두운 네이비 톤의 FALCON 설치 도우미 화면이 열립니다. 화면의 «시스템 점검»을 눌러 빠진 항목이 없는지 확인하세요.

💡 점검에 빨간 줄이 보인다면?

빨간 줄이 남아 있으면 이전 단계(STEP 03~06) 중 누락된 항목이 있는 것이니 해당 안내대로 도구/패키지를 먼저 채워주세요.

원격 FALCON MCP 등록

대표님이 알려주신 FALCON 서버 주소를 Claude Code에 사용자 스코프로 등록합니다.
* 주소 규칙: 반드시 https로 시작하고 /friend-mcp로 끝나야 합니다.

1) FALCON MCP 등록 명령어

claude mcp add --transport http --scope user falcon https://<대표님이_준_주소>/friend-mcp

2) 등록 확인 명령어

claude mcp get falcon

✓ 정상 결과

claude mcp get falcon 실행 시 등록된 falcon 서버의 URL과 세부 설정이 출력됩니다.

⚠️ 서버 주소가 바뀌었을 때

대표님께 새 주소를 받으셨다면 claude mcp remove falcon 후 새 주소로 다시 등록해 주세요.

«브라우저»로 접속코드 인증

Claude Code를 열고 FALCON 도구를 한 번 부르면, 인증이 필요하다며 브라우저 창이 자동으로 열립니다. 그 화면의 「접속코드」 칸에 전달받으신 10자리 코드(영문·숫자)를 넣으시면 됩니다.

✓ 정상 결과

브라우저 화면에서 접속코드 입력 후 사용자 권한이 성공적으로 등록됩니다.

🔒 필수 보안 주의

• 로그인은 채팅창이 아니라 이 브라우저 화면에서 합니다. 채팅창에 코드를 붙여넣지 마세요.
• 접속코드 및 발급받은 인증 정보는 외부에 공개되지 않도록 주의하세요.

wetube_setup 실행기로 runner 받기

Claude Code 채팅창에서 아래와 같이 요청합니다. FALCON 서버가 실행기 본문과 sha256 지문을 함께 내려줍니다.

Claude에게 말할 내용

wetube_setup 을 실행해 줘

📁 정확한 저장 위치

%USERPROFILE%\FalconWork\falcon_local_runner.py

⚠️ 저장 시 필수 주의사항

줄바꿈을 «바꾸지 말고» 서버에서 받은 그대로 저장해야 합니다. 그러지 않으면 sha256 지문이 어긋납니다.

selfcheck 및 capability 검증

내려받은 실행기가 정상인지 확인하고, 내 PC 환경 점검 결과를 Claude에게 알려줍니다.

1) selfcheck 검증 명령어 (지문 대조)

python "%USERPROFILE%\FalconWork\falcon_local_runner.py" selfcheck

2) capability 환경 검사 명령어

python "%USERPROFILE%\FalconWork\falcon_local_runner.py" capability

3) Claude에게 결과 전달

wetube_capability 로 이 결과를 보내 줘

✓ 정상 결과

selfcheck의 sha256이 10단계에서 받은 지문과 일치하며, capability 결과가 Claude에게 전달됩니다.

첫 작업 및 결과 확인

Claude에게 원하는 채널의 영상 시작을 요청합니다. FALCON이 계약(spec.json)을 내려주면 내 PC에서 렌더를 돌리고 보고합니다.

1단계: Claude에게 제작 요청

wetube_local_make 로 cinema 영상을 시작해 줘

2단계: 내려받은 spec으로 내 PC에서 실행 (터미널)

python "%USERPROFILE%\FalconWork\falcon_local_runner.py" run spec.json

3단계: 결과를 Claude에게 보고

wetube_local_report 로 결과를 보내 줘

📁 최종 영상 산출물 위치

%USERPROFILE%\FalconWork\<작업번호>\out\<채널이름>_v001.mp4
(어디까지 진행되었는지는 wetube_local_status 로 확인 가능)

READY FOR TAKEOFF

FALCON 설치가 완료되었습니다.

사용 가능한 채널과 권한은 연결 후 FALCON에서 확인됩니다. 작업할 채널 카드를 클릭하시면 상단의 Claude 실행 명령어가 변경됩니다.

DESKTOP LAUNCHER

설치가 완료되었습니다.
앞으로는 바탕화면의 "FALCON MCP 시작" 아이콘을 더블클릭하세요.

💡 바탕화면 바로가기 아이콘 생성 방법:
1. 압축을 푼 FalconFriendTest 폴더에서 「바탕화면 바로가기 생성.cmd」를 더블클릭합니다.
2. 또는 PowerShell 터미널에서 아래 명령어를 실행하세요:

powershell -ExecutionPolicy Bypass -File install_falcon_shortcut.ps1

3. 생성이 완료되면 바탕화면에 「FALCON MCP 시작」 바로가기 아이콘이 즉시 생성됩니다.

ℹ️ 채널 상태는 연결 후 확인됩니다. (대표님 별도 안내 및 서버 권한 응답 기준)

cinema 연결 후 확인

명화관

gunrimbo 연결 후 확인

군림보

noejeongu 연결 후 확인

뇌전구

linbox 연결 후 확인

린박스

funnyburger 연결 후 확인

웃긴버거

arab 연결 후 확인

어랍숏

person 연결 후 확인

인물형

shop 연결 후 확인

쇼핑

📚 설치 전 준비 및 FAQ / 문제 해결

설치 중 궁금한 점이나 오류가 발생했을 때 언제든 참고하세요.

01 설치 전 미리 알아두실 것 (3대 원칙)

▼

1. API 키를 구해 오실 필요가 없습니다: 목소리(Typecast)와 장면 그림(EvoLink)은 FALCON 서버가 대신 부릅니다. 지인분 PC에는 그 키를 넣지 않으며, 설치 화면에도 입력칸이 없습니다.
2. 무거운 작업은 지인분 PC에서 돕니다: ffmpeg 렌더·프레임 굽기·자막 합성은 본인 컴퓨터에서 실행되므로 ffmpeg와 Python이 필요합니다.
3. 실제 실행기(falcon_local_runner.py)는 ZIP에 없습니다: 10번 단계에서 FALCON 서버가 Claude를 통해 안전하게 직접 내려줍니다.

Q [서버에 연결이 안 됩니다]

▼

claude mcp get falcon 으로 등록된 주소를 확인하세요.
주소가 https 로 시작하고 /friend-mcp 로 끝나는지 확인하시고, 임시 주소(Quick Tunnel) 갱신 시 대표님께 새 주소를 받아 claude mcp remove falcon 후 다시 등록해 주세요.

Q [wetube_setup 이 실패합니다]

▼

먼저 브라우저 인증(STEP 09)이 끝났는지 확인하세요. 로그인이 안 된 상태에서는 실행기(runner)를 내려받을 수 없습니다.

Q [ffmpeg 가 없다고 나옵니다]

▼

ffmpeg -version 이 되는지 확인하세요. 방금 설치하셨다면 기존 터미널을 닫고 «새 터미널»을 열어야 인식됩니다. 컴퓨터 재부팅은 필요 없습니다.

Q [Python 패키지가 없다고 나옵니다]

▼

STEP 06의 pip 명령어(python -m pip install --user Pillow numpy opencv-python)를 다시 돌려주세요. 그다음 capability를 한 번 더 돌려 결과를 보내주시면 됩니다.

Q [MP4 가 안 생깁니다]

▼

%USERPROFILE%\FalconWork\<작업번호>\out 폴더가 만들어졌는지 보시고, 마지막 실행 화면 메시지를 확인해 주세요. 실행기가 «무엇이 없어서 멈췄는지»를 한국어로 알려줍니다. 그 문구를 그대로 알려주시면 됩니다.

⚠️ [절대 보내지 마세요 (보안 필독)]

▼

문제를 알려주실 때 아래 항목은 «어떤 경우에도» 메신저나 채팅으로 보내지 마세요:

API 키 · 토큰 (Typecast · EvoLink · 받아쓰기 키 등)
.env 파일
개인 인증서 · 로그인 정보 · 접속코드 10자리
홈 폴더의 .wetube 폴더
홈 폴더의 .volcano 폴더

보내주실 것은 화면에 뜬 오류 메시지 텍스트와 키/토큰이 가려진(모자이크) 스크린샷뿐입니다.