개발자용
Nano Banana Pro MCP 서버
AI 비서가 이미지와 영상을 대신 만들어 드립니다. Model Context Protocol을 지원하는 클라이언트에 서버 주소를 하나 추가하고, 브라우저에서 계정에 로그인한 뒤, 필요한 내용을 평소 말투로 설명하면 됩니다.
이용 방법
클라이언트별 설정
사용하는 클라이언트를 선택하십시오. 메뉴 이름은 버전에 따라 조금 다를 수 있습니다.
Claude Code
- 1터미널에서 아래 명령을 실행하여 서버를 추가합니다.
- 2Claude Code에서 /mcp를 열고 nanobanana를 선택한 뒤 브라우저에서 로그인을 완료합니다.
claude mcp add --transport http nanobanana https://preview.bananapro.site/api/mcpCodex
- 1터미널에서 첫 번째 명령을 실행하여 서버를 추가합니다.
- 2두 번째 명령을 실행하면 브라우저 창이 열립니다.
- 3계정에 로그인하고 ‘허용’을 누릅니다.
codex mcp add nanobanana --url https://preview.bananapro.site/api/mcpcodex mcp login nanobananaCursor 및 JSON 클라이언트
- 1클라이언트의 MCP 설정 파일(Cursor에서는 mcp.json 등)에 다음 내용을 추가합니다.
- 2필요하면 클라이언트를 다시 시작합니다. 처음 사용할 때 브라우저 창이 열리면 로그인하고 ‘허용’을 누릅니다.
{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp"
}
}
}사용자 지정 커넥터
- 1클라이언트 설정을 열어 사용자 지정 커넥터 또는 원격 MCP 서버 입력란을 찾습니다.
- 2아래에 표시된 서버 주소를 붙여 넣고 저장합니다.
- 3‘연결’을 선택하고 계정에 로그인한 뒤 ‘허용’을 누릅니다.
https://preview.bananapro.site/api/mcpAPI 키
- 1브라우저를 열 수 없는 클라이언트에서만 이 방법을 사용하십시오.
- 2API 키 페이지에서 키를 만듭니다. 첫 번째 칸의 헤더로 보내거나, JSON 설정에서는 두 번째 칸처럼 headers 아래에 추가합니다.
- 3키는 클라이언트의 자격 증명 설정에 보관하고 다른 사람에게 알려 주지 마십시오.
Authorization: Bearer YOUR_API_KEY{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}어시스턴트가 할 수 있는 일
서버는 여섯 가지 도구를 제공합니다. 네 가지는 정보를 조회만 하므로 무료이고, 두 가지는 생성을 시작하며 크레딧이 사용됩니다.
| 도구 | 기능 | 크레딧 사용 |
|---|---|---|
| list_models | 계정에서 사용할 수 있는 이미지·영상 모델과 각 모델이 지원하는 요청 유형을 보여 줍니다. | 아니요 |
| get_balance | 계정에 남은 크레딧을 보여 줍니다. | 아니요 |
| generate_image | 프롬프트와 선택 사항인 참조 이미지로 이미지 생성 또는 이미지 편집을 시작합니다. | 예 |
| generate_video | 프롬프트, 이미지 또는 기타 참조 미디어로 영상 생성을 시작합니다. | 예 |
| get_task | 생성 작업의 상태를 확인하고, 완료되면 결과 링크를 반환합니다. | 아니요 |
| list_tasks | 최근 생성 작업을 나열합니다. 작업 ID를 잃어버렸을 때 유용합니다. | 아니요 |
명령줄 도구
nanobanana 명령으로 터미널, 스크립트, 그리고 컴퓨터에서 명령을 실행할 수 있는 AI 앱에서 이미지와 영상을 만들 수 있습니다.
macOS 또는 Linux와 Node.js 22 이상이 필요합니다.
CLI 설치
npm으로 @nanobanana-pro/cli 패키지를 설치합니다.
npm install -g @nanobanana-pro/cli로그인
명령을 실행한 뒤 열리는 브라우저 창에서 계정에 로그인하고 ‘허용’을 누릅니다.
nanobanana auth login계정과 모델 확인
이 명령은 크레딧 잔액을 표시합니다. nanobanana models 명령은 사용 가능한 모델을 보여 줍니다.
nanobanana account생성 시작
모델과 프롬프트를 request.json에 저장한 뒤 명령을 실행합니다. --wait 옵션은 작업이 끝날 때까지 기다립니다.
nanobanana create --input request.json --wait결과 다운로드
TASK_ID를 이전 명령이 반환한 작업 ID로 바꾸십시오.
nanobanana download TASK_ID --output result.png
실행 예시
한 문장으로 이미지를 요청하면 됩니다. AI 앱이 요청을 작성하고 이미지를 만든 뒤 파일로 저장합니다.
$ nanobanana create --input request.json --wait
Task TASK_ID submitted; waiting for the result…
{ "status": "completed" }
$ nanobanana download TASK_ID --output result.png
{ "files": ["result.png"] }
사용 가능한 모델
비서는 웹사이트와 API에서 계정이 사용할 수 있는 이미지·영상 모델을 그대로 사용할 수 있습니다.
- 비서에게 list_models 호출을 요청하면 현재 모델 목록과 모델별로 받는 요청 유형을 확인할 수 있습니다.
- 각 모델의 옵션은 웹사이트와 같습니다. 모델이 지원하지 않는 설정은 사유와 함께 거절됩니다.
- 참조 이미지와 영상은 공개 https 링크여야 합니다. MCP에서는 파일을 업로드할 수 없습니다.
크레딧과 결제
- 로그인과 무료 도구(list_models, get_balance, get_task, list_tasks)에는 크레딧이 들지 않습니다.
- generate_image와 generate_video는 웹사이트 및 API와 같은 크레딧을 계정 잔액에서 사용합니다.
- 실패한 작업은 자동으로 환불됩니다.
- AI 비서 자체의 구독은 별개이며 해당 비서에서 청구합니다.
요청 예시
연결한 뒤 다음과 같은 요청을 비서에게 보내 보십시오.
- 사용할 수 있는 이미지·영상 모델을 짧은 목록으로 보여 주세요.
- 나무 탁자 위에 놓인 도자기 머그잔의 제품 사진을 16:9로 만들어 주세요.
- 이 풍경 사진으로 5초 길이의 영상을 만들어 주세요: https://example.com/photo.jpg
- 가장 최근 작업의 상태를 확인하고 결과 링크를 보내 주세요.
자주 묻는 질문
API 키가 필요합니까?
브라우저를 열 수 있는 클라이언트에는 필요하지 않습니다. 로그인하고 ‘허용’을 누르면 됩니다. 키는 브라우저를 열 수 없는 클라이언트에만 필요하며, 방법은 ‘API 키’ 항목에 있습니다.
연결은 어디에서 확인하거나 삭제합니까?
API 키 페이지를 여십시오. 각 연결이 클라이언트 이름으로 표시되며, 삭제하면 해당 클라이언트의 접근이 끝납니다.
생성에는 크레딧이 얼마나 듭니까?
웹사이트 및 API와 같은 크레딧이 듭니다. 실패한 작업은 자동으로 환불됩니다.
제 이미지나 영상을 참조로 쓸 수 있습니까?
예, 공개 https 링크로 전달하면 됩니다. 파일 업로드는 지원하지 않으므로 접근 가능한 곳에 파일을 두고 그 주소를 전달하십시오.
연결은 되었는데 도구가 보이지 않습니다.
로그인이 완료되었는지, 클라이언트에 서버가 연결됨으로 표시되는지 확인하십시오. 그다음 새 대화를 시작하십시오. 일부 클라이언트는 대화를 시작할 때만 도구를 불러옵니다.
결과는 어디에서 확인합니까?
비서가 대화에서 결과 링크를 돌려줍니다. 이전 작업은 list_tasks로 다시 조회할 수 있습니다.
API를 직접 호출하시겠습니까?
MCP 서버는 공개 API를 기반으로 만들어졌습니다. 문서에서 모든 엔드포인트, 파라미터, 모델을 확인할 수 있습니다.