Nodaro 문서Claude Code
터미널 명령 하나로 Claude Code에 Nodaro MCP 서버를 추가하고, /mcp에서 OAuth로 로그인한 다음, Claude Code에서 이미지, 동영상, 영화를 만드세요.
Claude Code를 Nodaro에 연결하려면 터미널에서 명령 하나로 Nodaro MCP 서버 https://mcp.nodaro.ai/mcp를 추가하세요. 내 Nodaro 계정으로 로그인하면, Claude가 Claude Code 세션에서 내가 허용한 모든 Nodaro 도구를 호출할 수 있습니다. 모든 결과는 내 Nodaro 라이브러리에도 저장됩니다.
Claude Code 연결
Nodaro 추가
프로젝트 폴더에서 터미널을 열고 다음을 실행하세요.
claude mcp add --transport http nodaro https://mcp.nodaro.ai/mcpClaude Code 세션 안이 아니라 터미널에서 명령을 실행하세요. Claude Code가 nodaro라는 서버를 추가하며, 로그인하기 전까지 claude mcp list에 Needs authentication(인증 필요) 상태로 표시됩니다.
로그인
같은 폴더에서 Claude Code를 시작하고 /mcp를 실행하세요. nodaro를 선택하고 Enter를 누른 다음 Authenticate(인증) 항목을 선택하세요. 브라우저에 Nodaro 로그인 페이지가 열립니다. 내 Nodaro 계정으로 로그인하고, 동의 화면에서 권한을 검토한 다음 허용을 클릭하세요.
제작 시작
Claude Code로 돌아오면 Nodaro가 연결됨으로 표시됩니다. Claude에게 Nodaro를 사용해 달라고 요청하세요. 예: “내 Nodaro 프로젝트를 보여 주세요.” 또는 “이 스크립트로 스토리보드를 만들어 주세요.” Claude가 Nodaro 도구를 처음 호출할 때 Claude Code가 권한을 요청하면 승인하세요.
기본적으로 Claude Code는 명령을 실행한 프로젝트에만 Nodaro를 추가합니다. 모든 프로젝트에서 Nodaro를 사용하려면 명령에 --scope user를 추가하세요.
Claude Code용 Nodaro 플러그인은 같은 서버를 Nodaro SDK 스킬과 함께 추가합니다. 에이전트 스킬을 참조하세요.
서버 확인 또는 제거
터미널에서 다음 명령을 실행하세요.
claude mcp list
claude mcp remove nodaro첫 번째 명령은 내 MCP 서버를 상태와 함께 나열하므로, Nodaro가 연결되었는지 확인할 수 있습니다. 두 번째 명령은 Claude Code에서 Nodaro를 제거합니다. 내 Nodaro 계정에 대한 Claude Code의 접근 권한도 끝내려면 app.nodaro.ai/settings/connected-apps의 설정 › 연결된 앱에서 해지하세요.
프로젝트에서 파일 업로드
Claude Code는 셸 명령을 실행할 수 있으므로 로컬 파일을 Nodaro로 직접 보낼 수 있습니다. prepare_image_upload, prepare_audio_upload, prepare_video_upload는 미리 서명된 업로드 URL과 파일의 공개 URL을 반환합니다. Claude Code는 curl -X PUT으로 파일을 업로드하고, 공개 URL을 다음 도구에 전달합니다. 업로드 도구를 참조하세요.
Claude Code에서 영화 만들기
Claude에게 예고편, 단편 영화 또는 뮤직비디오를 요청하면, Claude가 Nodaro에서 영화 디렉터 스킬을 불러옵니다. 그런 다음 Claude는 승인받은 단계를 하나씩 쌓아 내 캔버스에 편집 가능한 워크플로를 만듭니다. 이 스킬은 Claude Code에서 테스트되었습니다. Claude Code에서는 스킬을 로컬 파일로 설치할 수도 있으며, 셀프 호스팅 설치에서 영화 디렉터를 사용할 때는 이 방법을 씁니다.
연결에 실패하면
- Authenticate를 선택해도 브라우저가 열리지 않습니다. Claude Code가 터미널에 보여 주는 URL을 복사해 브라우저에서 여세요.
- 로그인이 실패합니다. URL이 끝에 슬래시 없이 정확히
https://mcp.nodaro.ai/mcp인지 확인하세요. 잘못된 URL을 고치려면claude mcp remove nodaro를 실행하고 서버를 다시 추가하세요. /mcp에 Nodaro가 없습니다. 다른 프로젝트에 서버를 추가한 것입니다. 이 프로젝트에서claude mcp add명령을 다시 실행하세요.- Nodaro가 연결되었는데 도구가 하나도 없습니다. 일부 권한이 부여되지 않았습니다.
/mcp를 실행하고nodaro를 선택한 다음 Clear authentication(인증 지우기) 항목을 선택하고, 모든 권한을 허용해 다시 로그인하세요.
더 많은 해결 방법은 문제 해결에 있습니다.
자주 묻는 질문
Claude Code에 Nodaro를 어떻게 추가하나요?
터미널에서 claude mcp add --transport http nodaro https://mcp.nodaro.ai/mcp를 실행하세요. 그런 다음 Claude Code를 시작하고 /mcp를 실행해 nodaro를 선택한 뒤, 내 Nodaro 계정으로 로그인하세요.
Claude Code에 Nodaro가 Needs authentication(인증 필요) 상태로 표시되는 이유는 무엇인가요?
아직 로그인하지 않았기 때문입니다. Claude Code에서 /mcp를 실행하고 nodaro를 선택한 다음 Authenticate(인증) 항목을 선택하세요. 브라우저에 Nodaro 로그인 페이지가 열리고, 액세스를 허용하면 Nodaro가 연결됨으로 표시됩니다.
Claude Code를 쓰려면 Nodaro API 키나 클라이언트 시크릿이 필요한가요?
아니요. Claude Code는 스스로 Nodaro에 등록할 수 있는 클라이언트 중 하나이며, 브라우저에서 OAuth로 로그인시켜 줍니다. 내 Nodaro 계정만 있으면 됩니다.
Claude Code로 로컬 파일을 Nodaro에 업로드할 수 있나요?
네. prepare 업로드 도구는 미리 서명된 업로드 URL을 반환합니다. Claude Code는 셸 명령을 실행할 수 있으므로, curl 명령 하나로 로컬 파일을 그 URL에 보냅니다.
관련 문서
클라이언트 연결
Claude
영화 디렉터
업로드
문제 해결
최종 업데이트