# Claude Code

> 터미널 명령 하나로 Claude Code에 Nodaro MCP 서버를 추가하고, /mcp에서 OAuth로 로그인한 다음, Claude Code에서 이미지, 동영상, 영화를 만드세요.

Source: https://nodaro.ai/ko/docs/mcp/connect/claude-code

**Claude Code**를 Nodaro에 연결하려면 터미널에서 명령 하나로 Nodaro MCP 서버 `https://mcp.nodaro.ai/mcp`를 추가하세요. 내 Nodaro 계정으로 로그인하면, Claude가 Claude Code 세션에서 내가 허용한 모든 Nodaro 도구를 호출할 수 있습니다. 모든 결과는 내 Nodaro 라이브러리에도 저장됩니다.

## Claude Code 연결
### Nodaro 추가
프로젝트 폴더에서 터미널을 열고 다음을 실행하세요.

```bash
claude mcp add --transport http nodaro https://mcp.nodaro.ai/mcp
```

Claude 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 스킬과 함께 추가합니다. [에이전트 스킬](https://nodaro.ai/docs/developers/agent-skills)을 참조하세요.

## 서버 확인 또는 제거
터미널에서 다음 명령을 실행하세요.

```bash
claude mcp list
claude mcp remove nodaro
```

첫 번째 명령은 내 MCP 서버를 상태와 함께 나열하므로, Nodaro가 연결되었는지 확인할 수 있습니다. 두 번째 명령은 Claude Code에서 Nodaro를 제거합니다. 내 Nodaro 계정에 대한 Claude Code의 접근 권한도 끝내려면 [app.nodaro.ai/settings/connected-apps](https://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을 다음 도구에 전달합니다. [업로드 도구](https://nodaro.ai/docs/mcp/tools/uploads)를 참조하세요.

## Claude Code에서 영화 만들기
Claude에게 예고편, 단편 영화 또는 뮤직비디오를 요청하면, Claude가 Nodaro에서 [영화 디렉터](https://nodaro.ai/docs/mcp/film-director) 스킬을 불러옵니다. 그런 다음 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**(인증 지우기) 항목을 선택하고, 모든 권한을 허용해 다시 로그인하세요.

더 많은 해결 방법은 [문제 해결](https://nodaro.ai/docs/mcp/troubleshooting)에 있습니다.

## 자주 묻는 질문

### 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에 보냅니다.