가이드 / MCP

MCP로 Claude Code 또는 Cursor에서 생성하기

NOLGIA는 자체 에이전트가 사용하는 것과 동일한 도구를 갖춘 호스팅된 MCP 서버를 실행합니다. Claude Code 또는 Cursor에 토큰을 제공하면 생성, 라이브러리 읽기, 작업 확인을 대신 수행할 수 있습니다.

  • 5분 분량
  • 업데이트

영어에서 자동 번역되었습니다. 원문 보기

개인 액세스 토큰 하나로 Claude Code 또는 Cursor를 NOLGIA에 연결한 후, 평범한 말로 이미지, 영상, 오디오 생성을 요청할 수 있습니다. NOLGIA는 NOLGIA Agent가 사용하는 것과 동일한 도구를 실행하는 mcp.nolgia.ai의 호스팅 서버를 통해 Model Context Protocol(약칭 MCP)을 지원합니다.

현재는 Claude Code와 Cursor에서 작동합니다. MCP 페이지에서 ChatGPT, Claude 데스크톱 및 웹은 '준비 중'으로 표시되어 있습니다. 이들은 토큰 대신 로그인 방식을 사용하며, 설정 단계는 아직 공개되지 않았습니다.

시작하기 전에

  • NOLGIA 계정과 컴퓨터에 설치된 Claude Code 또는 Cursor가 필요합니다.
  • 충전 잔액의 크레딧입니다. 토큰은 충전 크레딧만 사용하며, 월간 플랜 크레딧은 절대 사용하지 않습니다.
  • 동영상 생성을 위해선 Pro 이상 플랜이 필요합니다. 토큰은 계정의 플랜을 따르므로, 플랜에 포함되지 않은 모델을 잠금 해제하지 않습니다.

API 토큰 만들기

계정 설정에서 API 토큰을 여세요. 토큰 만들기 아래에서 이름을 지정하세요. 예를 들어 사용할 앱의 이름을 입력하고 토큰 만들기를 누르세요. NOLGIA는 토큰을 한 번만 표시하므로, 페이지를 떠나기 전에 안전한 곳에 복사해 두세요.

API 토큰 설정 페이지의 토큰 만들기 카드. 두 개의 번호가 매겨진 표시가 있으며, 이름 필드와 토큰 만들기 버튼이 365일로 설정된 만료일 필드 옆에 있습니다.
API 토큰 페이지의 토큰 만들기입니다. (1) 사용할 앱의 이름으로 지정하세요. (2) 토큰을 만든 후, 표시되는 동안 복사하세요.

주의:실수로 공유했나요? 활성 토큰 아래에서 해당 토큰 옆의 폐기를 누르고 새 토큰을 만드세요. 폐기된 토큰을 사용하는 모든 항목은 즉시 작동을 멈춥니다.

Claude Code에 NOLGIA 추가

터미널을 열고 이 명령어를 실행하세요. nol_your_token_here 자리에 토큰을 넣으면 됩니다. 한 번만 추가하면 터미널의 모든 Claude Code 세션에서 생성, 라이브러리 탐색, 작업 상태 확인이 가능합니다.

터미널에 붙여넣기
claude mcp add --transport http nolgia https://mcp.nolgia.ai/mcp --header "Authorization: Bearer nol_your_token_here"
MCP 페이지의 2단계에서 Claude Code 탭이 선택된 상태: Claude Code, Cursor, 곧 제공 예정인 ChatGPT, 곧 제공 예정인 Claude 데스크톱 및 웹 탭이 있으며, 그 아래에 복사 버튼이 있는 claude mcp add 명령어가 표시됨
MCP 페이지, 2단계. Claude Code 탭에는 복사 버튼이 있는 동일한 명령어가 있습니다. ChatGPT와 Claude 데스크톱 및 웹은 곧 제공 예정으로 표시됩니다.

또는 Cursor에 추가하기

Cursor에서는 서버를 MCP 구성 파일인 ~/.cursor/mcp.json에 넣습니다. MCP 페이지를 열고 Cursor 탭을 선택한 후 구성을 복사하세요. 파일에 붙여넣고 nol_your_token_here 자리에 토큰을 넣은 후 저장합니다.

MCP 페이지의 2단계에서 Cursor 탭이 선택되고 표시된 상태: nolgia 서버가 포함된 ~/.cursor/mcp.json 구성과 복사 버튼이 표시됨
MCP 페이지, Cursor 탭. (1) Cursor. (2) 구성을 복사한 후 nol_your_token_here 자리에 토큰을 넣으세요.

파일이 한 줄로 표시된 경우 다음과 같이 읽어야 합니다: { "mcpServers": { "nolgia": { "url": "https://mcp.nolgia.ai/mcp", "headers": { "Authorization": "Bearer nol_your_token_here" } } } }

팁:다른 서버를 이미 사용 중이신가요? 이미 있는 mcpServers 객체 내부에, 다른 항목 옆에 nolgia 항목을 추가하세요.

평이한 언어로 요청하기

연결이 완료되면 원하는 내용을 자신의 말로 요청하세요. 서버는 7개 그룹으로 나뉜 50개 이상의 도구를 앱에 제공합니다:

그룹다루는 내용
생성이미지, 비디오, 오디오, 3D, 이미지 세트, 프리셋 실행, 그리고 하나의 비디오로 조립된 클립과 내레이션
내 라이브러리에셋, 업로드, 캐릭터, 스타일, 전사 텍스트 및 짧은 클립
프로젝트프로젝트, 해당 에셋 및 캔버스
편집 세션 및 세부 조정단계별 이미지 편집, 예상 시간 및 되돌리기 기능 포함
프리셋프리셋 목록 보기 및 하나 읽기
타임라인마스크 및 모션 확인, 색보정 프리셋 목록 보기 및 렌더링 확인
모델, 계정 및 작업모델, 내 계정, 생성 횟수 및 작업(취소 포함)
MCP 페이지에 나열된 도구 그룹입니다.
요청해 보세요
Use NOLGIA to make a 16:9 image of a singer in a silver bomber jacket walking through a concrete tunnel lined with red and magenta neon tubes, low haze on the floor.

팁:프리셋에서 시작하기. MCP 페이지의 각 프리셋 카드에는 Claude Code나 Cursor에 복사하여 붙여넣을 수 있는 프롬프트가 있으며, 각 프리셋은 프리셋에도 자체 페이지가 있습니다.

MCP 페이지의 세 가지 프리셋 카드: Encore Captions, Multicam, Commercial. 각 카드에는 프롬프트 줄과 복사 버튼이 있으며, Encore Captions의 프롬프트와 복사 버튼이 표시되어 있습니다.
MCP 페이지의 프리셋 카드. (1) 해당 프리셋의 프롬프트. (2) Claude Code나 Cursor에 복사하세요.

모든 도구는 MCP 실행을 참조하세요. 코딩 에이전트가 NOLGIA를 사용하는 데 도움이 되는 스킬은 Claude Code, Cursor 및 Codex용 NOLGIA를 참조하세요.

또는 대신 CLI를 설정하세요

MCP 페이지에는 코딩 에이전트를 위한 한 줄 지침도 있습니다. 이 지침은 MCP 서버를 추가하지 않습니다. 대신 sudo 없이 NOLGIA 명령줄 도구를 설치하고, 로그인을 기다린 후, NOLGIA 스킬을 설치하고, 소량의 크레딧을 사용하는 검증 생성을 한 번 실행합니다.

MCP 페이지의 '에이전트에 이 내용 붙여넣기' 블록: Nolgia CLI를 설치하기 위한 한 줄 지침이며, 복사 버튼이 표시되어 있습니다.
코딩 에이전트용 한 줄 명령어, MCP 페이지에 있습니다. (1) 복사해서 에이전트에 붙여넣으면 CLI를 자동으로 설치하고 확인합니다.
에이전트에 붙여넣기
Read https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/INSTALL_FOR_AGENTS.md and follow it end to end to install and set up the Nolgia CLI for me.

비용 안내

조회는 무료입니다: 자산 목록 보기, 작업 상태 확인, 프리셋 탐색은 비용이 들지 않습니다. 생성에만 크레딧이 사용되며, 모델이 공개한 요율에 따라 차감됩니다. 아래는 MCP 페이지에 나열된 일부 모델과 실시간 요율입니다.

  • Wan 3.0Pro and up

    Per 5s clip

    480p 14 크레딧 · 720p 28 크레딧 · 1080p 56 크레딧

  • Seedance 2.5Pro and up

    Per 5s clip

    480p 26 크레딧 · 720p 56 크레딧 · 1080p 137 크레딧

    1080p renders at 16:9 and 9:16

  • GPT Image 2.5 SunburstEvery plan

    Per image

    Native 8 크레딧 · 2K 21 크레딧 · 4K 58 크레딧

  • Nano Banana 2Every plan

    Per image

    Native 4 크레딧 · 2K 17 크레딧 · 4K 54 크레딧

  • ElevenLabs v3Every plan

    Per 1,000 characters

    Standard 6 크레딧

이 페이지를 열 때 카탈로그에서 실시간으로 불러옵니다. 모든 가격은 생성하기 전에 표시됩니다. 모든 요금 보기.

별도 설정 없이 사용하시겠습니까? NOLGIA Agent가 동일한 도구를 대신 실행하며, 대화 턴당 과금되고 Studio 플랜에 포함되어 있습니다.

자주 묻는 질문

어떤 앱과 연결할 수 있나요?
현재는 Claude Code와 Cursor가 지원되며, Authorization 헤더를 보낼 수 있는 모든 MCP 클라이언트가 연결할 수 있습니다. ChatGPT, Claude 데스크톱 및 웹은 'Soon'으로 표시되어 있습니다. 문서의 Run MCP 페이지에서는 Codex 설정도 안내합니다.
비용은 얼마나 되나요?
조회는 무료이며, 생성에만 크레딧이 사용되고 모델이 공개한 요율에 따라 차감됩니다. 토큰으로 요청하면 충전 크레딧만 사용되며, 월간 플랜 크레딧은 절대 사용하지 않습니다.
토큰으로 내 플랜의 비디오 기능을 해제할 수 있나요?
아니요. 토큰은 계정 플랜 정보를 포함하므로, Pro 이상 플랜이 필요한 모델은 여전히 해당 플랜이 필요합니다.
토큰이 노출되면 어떻게 해야 하나요?
설정 내의 API 토큰 페이지에서 해당 토큰을 취소하고 새 토큰을 생성하세요. 취소된 토큰을 사용하는 모든 항목은 즉시 작동을 멈춥니다.
NOLGIA Agent가 이 도구들을 대신 실행해 줄 수 있나요?
네. NOLGIA Agent가 대신 동일한 도구를 실행하며, 사용 중인 모델의 요금 기준으로 채팅 턴당 과금됩니다. Studio 플랜에 포함되어 있습니다.

Claude Code 또는 Cursor 연결하기

MCP 설정 보기

크레딧

크레딧 사용 방식과 렌더링 실패 시 처리 방법

가격은 생성 버튼에 표시되며, 작업 중에는 해당 금액이 보류됩니다. 보류된 금액은 청구되거나 환불됩니다. 실패, 거부 또는 취소 시 크레딧이 반환되는 시점을 안내합니다.

· 6분 분량