⚡ Falcon MCP 전용 설치 포털

FALCON MCP 설치

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

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

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

1. ZIP 압축을 풉니다. (다운로드한 FALCON_FRIEND_READY_2026-09-22_FINAL17.zip)
2. FalconFriendTest\FALCON 설치하기.cmd 를 한 번 실행합니다. 필요한 프로그램 설치·점검·FALCON 연결·바로가기 생성까지 이 하나가 알아서 합니다. 다른 파일은 누르지 않으셔도 됩니다.
3. VS Code 가 열리고 Claude 가 시작됩니다. 처음 한 번 «이 폴더의 자동 작업을 허용할까요?» 에 Allow 를 눌러 주세요.
4. 여기부터는 직접 하셔야 합니다. Claude Code 로그인 → 브라우저에 10자리 접속코드 입력(인증) → Claude 에게 falcon_setup 으로 실행기 받기.
5. 다음부터는 바탕화면의 "FALCON MCP 시작" 아이콘만 누르시면 됩니다.

✓ 본인 키로 제작 (서버는 키를 안 가짐) ✓ 100% 로컬 렌더링 보안 ✓ 4개 채널 수용 구조 ✓ 안전한 브라우저 인증

STEP 01 / 12 배포 ZIP 파일 받기

배포 ZIP 파일 받기

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

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

📦 FALCON_FRIEND_READY_2026-09-22_FINAL17.zip 다운로드

✓ 정상 결과

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

💡 패키지 성격 안내

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

압축 풀고 「FALCON 설치하기」 한 번 실행

내려받은 ZIP 의 압축을 풉니다. 그다음 누르실 파일은 하나뿐입니다 — FALCON 설치하기.cmd.

✓ 누르실 파일 (하나)

FalconFriendTest\FALCON 설치하기.cmd 를 더블클릭하세요.
FalconFriendTest/FALCON 설치하기.cmd
검은 창이 열리고 [1/7] ~ [5/7] 이 차례로 지나갑니다. 창을 닫지 마세요.
필수 프로그램 설치 → 점검 → FALCON 연결 → 바탕화면 바로가기 → VS Code 열기까지 이어집니다.

💡 다른 파일은 누르지 않으셔도 됩니다

폴더 안의 FALCON 설치 시작.html · FALCON 필수설치.cmd · 시스템 점검.cmd 는 「FALCON 설치하기」가 안에서 알아서 부릅니다. 따로 누르실 필요가 없습니다.

🔴 아직 «완전 자동»은 아닙니다

세 가지는 여전히 직접 하셔야 합니다 — Claude Code 로그인, 브라우저에서 10자리 접속코드 입력, Claude 에게 falcon_setup 으로 실행기 받기. 아래 STEP 08~11 이 그 부분입니다.

💡 참고 사항

실제 영상 제작 실행기(falcon_local_runner.py)는 이 ZIP 안에 없는 것이 정상입니다. 인증을 마친 뒤 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... 버전이 출력됩니다.

⚠️ 설치되어 있지 않은 경우

Windows는 아래 한 줄로 설치됩니다. (설치 후에는 «새 터미널»을 열어주세요):

winget install Anthropic.ClaudeCode

winget 이 없으시면 PowerShell 에서 공식 설치 관리자를 쓰셔도 됩니다:

irm https://claude.ai/install.ps1 | iex

🔑 계정·요금제가 먼저 필요합니다

Claude Code 는 설치만으로는 쓰실 수 없고 로그인할 계정이 필요합니다.
쓸 수 있는 계정은 Claude Pro · Max · Team · Enterprise 구독, 또는 Claude Console(API 선충전) 계정입니다.
무료 claude.ai 요금제로는 Claude Code 를 사용하실 수 없습니다. 계정이 없으시면 설치는 되지만 다음 단계에서 멈춥니다.

필요한 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

설치 결과 확인 (선택)

STEP 03~06 은 FALCON 설치하기.cmd 가 이미 자동으로 처리하고 다시 실측했습니다. 이 단계는 그 결과를 눈으로 보고 싶을 때만 하시면 됩니다.

✓ 보고 싶으실 때만

압축 푼 폴더의 FalconFriendTest\FALCON 설치 시작.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://falcon.tail2e115e.ts.net/friend-mcp

2) 등록 확인 명령어

claude mcp get falcon

✓ 정상 결과

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

📌 주소는 바뀌지 않습니다

이 주소는 고정 주소입니다. 예전 안내에 있던 «임시 주소»는 더 이상 쓰지 않으니 주소를 다시 받으실 필요가 없습니다.
옛 주소로 등록해 두셨다면 claude mcp remove falcon 후 위 명령어로 한 번만 다시 등록해 주세요.

«브라우저»로 승인 링크 인증

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

✓ 정상 결과

브라우저 화면에서 승인 링크 입력 후 사용자 권한이 성공적으로 등록됩니다.

🔒 필수 보안 주의

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

falcon_setup 실행기로 runner 받기

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

Claude에게 말할 내용

falcon_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에게 결과 전달

falcon_capability 로 이 결과를 보내 줘

✓ 정상 결과

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

첫 작업 및 결과 확인

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

1단계: Claude에게 제작 요청

falcon_local_make 로 cinema 영상을 시작해 줘

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

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

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

falcon_local_report 로 결과를 보내 줘

📁 최종 영상 산출물 위치

%USERPROFILE%\FalconWork\<작업번호>\out\<채널이름>_v001.mp4
(어디까지 진행되었는지는 falcon_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 서버는 그 키를 갖지도 받지도 않습니다 — 서버는 「무엇을 어디로 부를지」만 알려 주고, 부르는 것은 본인 컴퓨터입니다.
2. 무거운 작업은 지인분 PC에서 돕니다: ffmpeg 렌더·프레임 굽기·자막 합성은 본인 컴퓨터에서 실행되므로 ffmpeg와 Python이 필요합니다.
3. 실제 실행기(falcon_local_runner.py)는 ZIP에 없습니다: 10번 단계에서 FALCON 서버가 Claude를 통해 안전하게 직접 내려줍니다.

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

▼

claude mcp get falcon 으로 등록된 주소를 확인하세요.
등록된 주소가 https://falcon.tail2e115e.ts.net/friend-mcp 인지 확인해 주세요. 이 주소는 고정이라 갱신되지 않습니다.
다르게 등록돼 있으면 claude mcp remove falcon 후 STEP 08 의 명령어로 다시 등록해 주세요.

Q [falcon_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자리
홈 폴더의 .falcon 폴더
홈 폴더의 .wetube 폴더 (옛 이름)
홈 폴더의 .volcano 폴더

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