개발자용
Nano Banana Pro MCP 서버
AI 어시스턴트가 이미지와 영상을 대신 생성하도록 설정하세요. Claude, Cursor 또는 Model Context Protocol을 지원하는 클라이언트에 서버를 하나 추가한 뒤, 필요한 내용을 평소 말투로 설명하면 됩니다.
세 단계로 연결하기
서버 주소
https://www.bananapro.site/api/mcp- 01
API 키 만들기
API 키 페이지에서 키를 생성하세요. 어시스턴트는 이 키로 작업하므로, 모든 생성 비용은 회원님 계정의 크레딧에서 차감됩니다.
API 키 열기 - 02
클라이언트에 서버 추가하기
위의 서버 주소를 클라이언트에 입력하고, 키는 Bearer 토큰으로 전송하도록 설정하세요. 주요 클라이언트별 설정 예시는 아래에 있습니다.
- 03
원하는 작업 요청하기
예를 들어 "Nano Banana Pro로 도자기 머그컵의 16:9 제품 사진을 생성해 줘"라고 요청하세요. 어시스턴트가 알맞은 도구를 선택해 작업을 시작하고 결과 링크를 알려 드립니다.
클라이언트 설정
YOUR_API_KEY를 생성한 키로 바꿔 입력하세요. 키는 외부에 공개되지 않도록 관리하세요. 키를 가진 사람은 누구나 회원님의 크레딧을 사용할 수 있습니다.
Claude Code (터미널에서 실행)
claude mcp add --transport http bananapro https://www.bananapro.site/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Cursor 및 JSON 설정 파일을 읽는 기타 클라이언트
{
"mcpServers": {
"bananapro": {
"url": "https://www.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}서버는 HTTP로 요청을 받아 각 호출에 바로 응답합니다. 브라우저를 통한 로그인은 제공하지 않으며, API 키로만 접근할 수 있습니다.
어시스턴트가 할 수 있는 일
서버는 여섯 가지 도구를 제공합니다. 네 가지는 정보를 조회만 하므로 무료이고, 두 가지는 생성을 시작하며 크레딧이 사용됩니다.
| 도구 | 기능 | 크레딧 사용 |
|---|---|---|
| list_models | 계정에서 사용할 수 있는 이미지·영상 모델과 각 모델이 지원하는 요청 유형을 보여 줍니다. | 아니요 |
| get_balance | 계정에 남은 크레딧을 보여 줍니다. | 아니요 |
| generate_image | 프롬프트와 선택 사항인 참조 이미지로 이미지 생성 또는 이미지 편집을 시작합니다. | 예 |
| generate_video | 프롬프트, 이미지 또는 기타 참조 미디어로 영상 생성을 시작합니다. | 예 |
| get_task | 생성 작업의 상태를 확인하고, 완료되면 결과 링크를 반환합니다. | 아니요 |
| list_tasks | 최근 생성 작업을 나열합니다. 작업 ID를 잃어버렸을 때 유용합니다. | 아니요 |
MCP 서버 관련 질문
MCP로 생성하면 비용은 얼마인가요?
API를 사용할 때와 같습니다. 도구를 호출하면 회원님의 키로 해당 API 요청이 실행되며, 크레딧은 회원님 계정에서 차감됩니다. 실패한 작업은 동일한 방식으로 환불됩니다.
어시스턴트는 어떤 모델을 사용할 수 있나요?
API에서 회원님 계정에 제공하는 모든 모델을 사용할 수 있습니다. list_models 도구가 최신 목록을 반환하므로 어시스턴트는 고정된 표에 의존하지 않습니다.
제가 가진 사진이나 영상을 참조로 사용할 수 있나요?
공개 https 링크로 전달하면 사용할 수 있습니다. 서버는 파일 업로드를 받지 않으므로, 접근 가능한 곳에 파일을 올린 뒤 그 주소를 전달하세요.
결과물은 어디에서 확인하나요?
어시스턴트가 대화 안에서 결과 링크를 알려 드립니다. 같은 작업은 list_tasks로도 조회할 수 있고 API를 통해서도 확인할 수 있습니다.
어시스턴트가 제 계정을 사용하지 못하게 하려면 어떻게 하나요?
API 키 페이지에서 해당 API 키를 삭제하세요. 삭제 이후에는 그 키로 보내는 호출이 거부됩니다.
API를 직접 호출하시겠습니까?
MCP 서버는 공개 API를 기반으로 만들어졌습니다. 문서에서 모든 엔드포인트, 파라미터, 모델을 확인할 수 있습니다.