MCP 서버와 CLI

Nano Banana MCP & CLI

Claude Code, Cursor, Codex 안에서 Nano Banana Pro, Seedream, GPT Image, Seedance 등으로 이미지와 동영상을 바로 생성하세요. 에이전트는 이미 가진 크레딧과 요금제를 사용합니다.

한 번에 설정하기

  • Claude Code
  • Cursor
  • Codex

이 메시지를 에이전트에 붙여 넣으면 설치와 로그인을 대신 해 줍니다.

직접 설정하고 싶으신가요? 연결 방법 보기

별도 API 요금이 없습니다. 기존 Nano Banana 계정으로 사용합니다.

에이전트 연결

클라이언트를 선택하세요. 로컬 MCP는 npx로 실행되며 CLI 로그인을 재사용합니다. 원격 MCP는 Authorization 헤더에 API 토큰이 필요합니다.

터미널에서 실행

claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcp

도구를 처음 실행하기 전에 npx -y @nanobananana/cli@latest auth login으로 로그인하거나 NANOBANANANA_TOKEN을 설정하세요.

세 단계로 시작하기

한 번 설치하고 브라우저로 로그인한 뒤 에이전트에게 요청하세요.

  1. 01

    MCP 서버 추가

    Claude Code는 명령 하나면 됩니다. Cursor와 Codex는 짧은 설정만 추가하면 됩니다.

    claude mcp add nanobananana -- npx -y @nanobananana/cli@latest mcp
  2. 02

    로그인

    브라우저가 열립니다. 액세스를 허용하면 CLI가 토큰을 기기에 저장합니다.

    npx -y @nanobananana/cli@latest auth login
  3. 03

    생성

    에이전트에게 이미지나 동영상을 요청하거나 CLI를 직접 실행하세요. 결과는 프로젝트에 다운로드됩니다.

    nanobanana generate create nano-banana-pro --prompt "a banana astronaut" --wait

에이전트가 쓸 수 있는 도구

모델 선택부터 결과 다운로드까지 9개의 도구로 처리합니다.

  • nano_account_status

    이메일, 요금제, 크레딧 잔액, 무제한 모델, 오늘 남은 무제한 이미지 수.

  • nano_list_models

    짧은 설명과 시작 가격이 있는 이미지·동영상 모델 목록, 유형별 필터.

  • nano_get_model

    모델의 모든 매개변수: 유형, 허용 값, 범위, 함께 쓸 수 있는 옵션.

  • nano_estimate_cost

    매개변수에 대한 정확한 크레딧 비용, 또는 조합이 잘못된 이유.

  • nano_upload_image

    HTTPS 링크에서 참조 이미지 업로드, 로컬 MCP는 로컬 파일도 가능.

  • nano_generate_image

    이미지 생성을 시작하고 요청 ID와 차감된 크레딧을 반환합니다.

  • nano_generate_video

    웹사이트와 같은 옵션으로 동영상 생성을 시작합니다.

  • nano_get_generation

    최대 20초 기다리며 생성 상태를 확인하고 완료되면 결과 URL을 반환합니다.

  • nano_list_generations

    최근 생성 기록을 페이지별로 조회합니다.

터미널이 더 편하신가요?

모든 기능을 일반 명령으로도 쓸 수 있습니다. 모든 명령이 --json을 지원해 스크립트와 CI에 넣기 좋습니다.

nanobanana model list --type text_to_image
nanobanana model get nano-banana-pro
nanobanana generate cost nano-banana-pro --prompt "a cozy reading nook" --resolution 2K
nanobanana generate create nano-banana-pro --prompt "a cozy reading nook" --resolution 2K --wait --out ./out
nanobanana generate create seedance --prompt "waves at sunset" --image ./frame.png --wait
nanobanana generate list --limit 20 --json

요금 방식

에이전트는 별도 API 잔액이 아니라 내 Nano Banana 계정을 사용합니다.

웹사이트와 같은 크레딧

생성할 때마다 nanobananana.com과 같은 가격으로 계정 크레딧이 차감됩니다. 실패한 생성은 환불됩니다.

무제한은 그대로

Plus와 Ultra에서는 Z Image와 FLUX.2가 계속 무제한입니다. 토큰을 통한 사용은 스크립트 폭주를 막기 위해 하루 300장까지입니다.

먼저 가격 확인

에이전트는 생성 전에 nano_estimate_cost로 견적을 낼 수 있고, 해상도를 직접 명시해야 하므로 더 비싼 옵션을 임의로 고르지 않습니다.

크레딧이 더 필요하신가요? 요금제와 크레딧 팩 보기

자주 묻는 질문

토큰으로는 생성, 참조 이미지 업로드, 생성 기록과 잔액 조회만 할 수 있습니다. 비밀번호 변경, 계정 삭제, 요금제 구매, 지원 티켓 작성은 할 수 없습니다. 토큰으로 보낸 프롬프트도 웹사이트와 같은 콘텐츠 검토를 거칩니다.

Nano Banana를 에이전트에 연결하세요

토큰을 만들고 설정을 붙여 넣으면 에디터에서 바로 생성을 시작할 수 있습니다.

API 토큰 만들기
이 페이지 공유하기