Nodaro MCP

Nodaro MCP 서버를 사용하면 AI 어시스턴트가 나를 대신해 Nodaro를 사용할 수 있습니다. Claude, ChatGPT, Cursor 등 Model Context Protocol(MCP)을 지원하는 클라이언트를 연결하고 Nodaro 계정으로 로그인하세요. 그러면 어시스턴트가 대화만으로 이미지, 동영상, 보이스, 음악을 생성하고, 워크플로를 구축해 실행하고, 내 캐릭터를 관리하고, 완전한 영화를 연출할 수 있습니다. 어시스턴트가 만드는 모든 것은 내 Nodaro 라이브러리에 저장되며, 어시스턴트가 구축한 모든 워크플로는 편집기에서 열립니다.

서버 URL

https://mcp.nodaro.ai/mcp

모든 클라이언트가 이 URL 하나를 사용합니다. 서버는 Streamable HTTP 전송 방식으로 MCP를 사용하고 OAuth로 로그인하므로, 복사할 API 키가 없습니다.

비슷한 두 주소는 작동하지 않습니다.

• https://api.nodaro.ai/mcp: 이 도메인은 존재하지 않으므로 Nodaro에 닿기 전에 연결이 실패합니다.
• https://app.nodaro.ai/mcp: MCP를 소개하는 웹 페이지이며, 서버가 아닙니다.

약 1분 만에 연결

어시스턴트가 할 수 있는 일

서버는 약 200개의 도구를 제공합니다. 어시스턴트가 연결할 때 도구를 찾아내므로, 평범한 말로 요청하면 어시스턴트가 도구를 고릅니다.

일부 도구는 Nodaro로 작업하는 방법을 어시스턴트에게 가르치기 위해서만 있습니다. start_workflow_editor, get_node_skill, start_film_director, start_video_director, get_recipe는 미디어 대신 지침을 반환합니다. 이 도구들은 무료이며 내 계정에서 아무것도 바꾸지 않습니다.

로그인과 권한

서버는 PKCE를 사용하는 OAuth 2.0 인증 코드 흐름을 사용합니다. 처음 연결할 때 클라이언트가 Nodaro에 자신을 등록하고 나를 동의 화면으로 보냅니다.

• 동의 화면에는 앱, 앱이 연결할 Nodaro 계정, 앱이 요청하는 권한이 표시됩니다. 다른 계정을 연결하려면 다른 계정 사용을 클릭하세요.
• 클라이언트 이름은 확인되지 않습니다. 스스로 등록한 클라이언트는 이름을 직접 정했으며, 동의 화면에 이에 대한 경고가 표시됩니다. 사용 중인 앱이 맞을 때만 승인하세요.
• 액세스는 90일 동안 유지됩니다. 갱신 토큰이 없으므로 90일이 지나면 클라이언트가 다시 로그인하라고 요청합니다.
• 언제든지 액세스를 취소할 수 있습니다. app.nodaro.ai/settings/connected-apps에서 설정 › 연결된 앱을 여세요. 내 계정에 액세스할 수 있는 모든 앱과 AI 어시스턴트가 연결된 날짜, 마지막으로 사용한 날짜, 보유한 권한과 함께 나열됩니다. 어시스턴트 옆의 접근 취소를 클릭하고 확인하세요. 액세스가 즉시 종료됩니다.

권한(스코프)

각 도구에는 하나 이상의 권한이 필요합니다. 허용하지 않은 권한이 필요한 도구는 도구 목록에서 아예 빠집니다. 목록에 나타났다가 실패하는 일은 없습니다.

ping, list_models, 가이드 도구처럼 권한이 필요 없고 항상 보이는 도구도 몇 가지 있습니다. 도구 레퍼런스에 모든 도구의 권한이 나와 있습니다.

워크스페이스가 생기기 전에 승인된 연결에는 워크스페이스 권한이 포함되어 있지 않습니다. 워크스페이스 도구를 사용하려면 커넥터를 제거하고 다시 추가하세요.

비용

• 연결은 무료입니다. MCP용 별도 요금제는 없습니다.
• 생성 도구는 내 Nodaro 계정의 크레딧을 사용하며, 가격은 편집기, API와 같습니다. 크레딧에서 가격이 정해지는 방식을 설명하며, 각 모델 페이지에 가격이 나와 있습니다.
• 탐색 도구와 가이드 도구는 무료입니다. 예를 들어 list_models, get_node_skill, list_shot_shapes, get_recipe가 있습니다.
• 실패한 생성은 환불됩니다. 실패한 작업에 예약된 크레딧은 자동으로 돌아옵니다. 예외는 모델이 이미 결과를 전달한 뒤 후처리에서 실패한 경우입니다.
• 일부 도구는 크레딧을 쓰기 전에 견적을 냅니다. confirm 없는 start_recast, plan_studio_export, dry_run: true를 지정한 스튜디오 도구는 가격을 반환하고 아무것도 시작하지 않습니다.
• 재시도 토큰이 있으면 안전하게 재시도할 수 있습니다. run_workflow, run_app, run_component와 여러 프로덕션 도구는 client_request_id를 받습니다. 타임아웃 후 같은 값을 다시 보내면 Nodaro는 실행을 두 번 시작하거나 두 번 청구하지 않습니다.

Nodaro Cloud에서는 check_balance가 내 잔액을 반환하고 credit_transactions가 구매 내역과 사용 내역을 나열합니다.

결과가 저장되는 곳

• 내 라이브러리. 모든 결과는 편집기에서 실행했을 때와 똑같이 내 Nodaro 라이브러리에 저장됩니다.
• 작업 카드. 웹용 Claude처럼 MCP Apps를 표시하는 클라이언트에서는 생성 중에 실시간 진행 상황이 담긴 카드가 표시되고, 그다음 결과가 나타납니다. 다른 클라이언트는 get_job이나 wait_for_job으로 작업을 확인합니다.
• mcp 프로젝트. 어시스턴트가 만든 워크플로는 mcp라는 프로젝트에 있으며, Nodaro가 처음 사용할 때 이 프로젝트를 만듭니다. 대시보드에서는 MCP 워크플로 아래에 나열됩니다. 어시스턴트는 내 모든 프로젝트의 이름을 볼 수 있지만, mcp 프로젝트에 있는 워크플로만 편집하고 실행합니다.
• 실행 목록. 어시스턴트가 시작한 실행에는 MCP 경유 배지가 붙으며, Nodaro가 클라이언트 이름을 알면 Claude 경유처럼 클라이언트 이름이 붙습니다.

nodaro.ai의 MCP 페이지

nodaro.ai/mcp는 가장 빠르게 연결하는 방법입니다. Claude에 연결 버튼, 서버 URL을 복사하는 필드, 클라이언트별로 짧은 세 단계가 담긴 탭이 있습니다. 이 문서는 클라이언트별 전체 단계, 모든 도구의 레퍼런스, 디렉터와 파이프라인 가이드를 더합니다.

Nodaro Cloud와 셀프 호스팅 설치

Nodaro Cloud는 모든 계정을 위해 mcp.nodaro.ai에서 MCP 서버를 실행합니다.

셀프 호스팅한 Community Edition과 Business 에디션 설치에도 같은 서버가 포함되어 있으며, 기본값은 꺼짐입니다. 운영자가 서버를 켜고 자체 주소를 지정합니다. 셀프 호스팅 설치의 MCP를 참고하세요. 클라이언트를 mcp.nodaro.ai 대신 그 주소에 연결하세요.

일부 도구는 Nodaro Cloud에만 있습니다. 예를 들어 스튜디오 프로덕션 도구와 Recast 도구, create_explainer, plan_edit, 크레딧 도구가 있습니다. 다른 설치에서는 이 도구가 없거나 not_available로 응답합니다.

다음 단계