Canvas + Codex + Claude

    Banana Art Lab MCP Server

    Codex, Claude Code, Cursor 등 모든 MCP 클라이언트에서 보유한 크레딧으로 GPT Image 2, Nano Banana Pro, Seedream 등 Banana Art Lab 모델을 사용해 이미지를 생성하고, 함께 작업하는 캔버스에 결과를 배치해 보세요.

    서버 URL(Streamable HTTP, OAuth)
    https://trynanobanana.net/mcp
    Codex

    › GPT Image 2 Saver로 여행 포스터 3장을 만들어서 “포스터” 캔버스에 넣어줘

    ● banana-art-lab · generate_image

    model: gpt-image-2-saver · ratio 3:4 · 3 images

    이미지 3장 · 6 크레딧 · “포스터” 캔버스에 배치됨

    완료되었습니다. trynanobanana.net/canvas에서 비교해 보시거나, 다듬고 싶은 이미지를 알려주세요.

    trynanobanana.net/canvas · 포스터
    프롬프트
    여행 포스터, 따뜻한 인쇄 색감, 굵은 타이포그래피
    GPT Image 2 Saver로 생성한 교토 여행 포스터
    GPT Image 2 Saver로 생성한 비 오는 거리 풍경
    GPT Image 2 Saver로 생성한 서점 내부

    설정 안내

    어시스턴트 연결

    Codex

    서버를 추가한 후 로그인하세요. Codex가 브라우저에서 trynanobanana.net을 열어 접근을 승인합니다.

    codex mcp add banana-art-lab --url https://trynanobanana.net/mcp
    codex mcp login banana-art-lab
    Codex에서 이미지 생성

    Claude Code

    서버를 추가한 다음 Claude Code에서 /mcp를 입력하고 banana-art-lab을 선택하여 로그인하세요.

    claude mcp add --transport http banana-art-lab https://trynanobanana.net/mcp
    Claude Code에서 이미지 생성

    Cursor

    ~/.cursor/mcp.json(또는 프로젝트의 .cursor/mcp.json)에 추가하세요. 처음 실행 시 Cursor에서 로그인을 요청합니다.

    mcp.json
    {
  "mcpServers": {
    "banana-art-lab": {
      "url": "https://trynanobanana.net/mcp"
    }
  }
}

    기타 클라이언트 또는 API 키 사용

    https://trynanobanana.net/mcp 주소를 원격 HTTP MCP 서버로 추가하세요. OAuth를 지원하는 클라이언트는 로그인 창이 표시됩니다. 지원하지 않는 클라이언트는 캔버스의 설정 → AI 도구에서 API 키를 생성한 후 Bearer 토큰으로 전달하세요. Codex에서 BANANA_ART_LAB_API_KEY 환경 변수에 키를 설정하는 방법은 다음과 같습니다:

    codex mcp add banana-art-lab --url https://trynanobanana.net/mcp --bearer-token-env-var BANANA_ART_LAB_API_KEY

    도구

    어시스턴트가 지원하는 작업

    도구주요 기능
    generate_image프롬프트와 선택적 참조 이미지를 바탕으로 사이트 내 모든 모델, 화면비, 해상도로 1-4장의 이미지를 생성합니다. 필요한 경우 프롬프트와 결과물을 캔버스에 배치할 수도 있습니다.
    get_generation약 45초 이상 소요된 생성 작업의 이미지를 가져옵니다.
    list_models지원 모델, 해상도, 품질 수준 및 이미지당 크레딧 목록을 확인합니다.
    get_account연결된 계정의 크레딧 잔액을 표시합니다.
    list_canvases캔버스 목록과 각 캔버스 ID를 확인합니다.
    get_canvas캔버스 정보(텍스트, 이미지, 위치 등 노드 및 연결 상태)를 읽어옵니다.
    create_canvas새 캔버스를 만듭니다.
    edit_canvas캔버스에서 노드를 추가, 수정, 연결 및 삭제합니다.

    요청 예시

    • “GPT Image 2 Saver로 흰색 대리석 위에 놓인 세라믹 커피 머그 제품 사진 4장을 생성하고, "Mug launch"라는 새 캔버스에 추가해 줘.”
    • “"Spring campaign" 캔버스를 읽어서 거기 있는 모든 이미지를 16:9 버전으로 만들어 줘.”
    • “Banana Art Lab 모델 목록과 가격을 알려주고, Nanobanana Pro로 야시장 2K 포스터를 하나 만들어 줘.”
    • “이 제품 설명을 내 캔버스에 프롬프트 노드 3개로 바꾸고, 각각 이미지에 연결해서 생성해 줘.”

    액세스 권한

    계정 제어 권한은 항상 사용자에게 있습니다

    • trynanobanana.net에서 로그인하고 각 앱을 직접 승인합니다. 앱에는 사용자의 비밀번호가 절대 노출되지 않습니다.
    • 액세스 토큰은 1시간 동안 유지되며 자동으로 갱신됩니다. 캔버스 설정 → AI 도구에서 언제든지 앱 연결을 해제하거나 키를 취소할 수 있습니다.
    • 서버는 어시스턴트의 요청이 있을 때만 이미지를 생성하며, 웹사이트와 동일한 크레딧 가격이 적용됩니다(모델 및 가격 참고).
    • Banana Art Lab 계정하고만 연동되며, 사용자의 컴퓨터에 있는 파일에는 절대 접근할 수 없습니다.

    자주 묻는 질문

    Banana Art Lab MCP 서버란 무엇인가요?

    MCP(Model Context Protocol)는 Codex, Claude Code, Cursor 같은 AI 어시스턴트가 외부 도구를 활용할 수 있게 해 주는 규격입니다. https://trynanobanana.net/mcp 에 위치한 Banana Art Lab MCP 서버를 연결하면 이미지 생성 및 캔버스 기능을 제공하여 작업 중인 채팅창에서 바로 이미지를 생성할 수 있습니다.

    어떤 앱을 연결할 수 있나요?

    원격(Streamable HTTP) 서버를 지원하는 모든 MCP 클라이언트를 연결할 수 있습니다. Codex, Claude Code, Cursor는 OAuth 로그인을 지원하므로 trynanobanana.net에서 앱을 한 번만 승인하면 됩니다. OAuth를 지원하지 않는 클라이언트는 캔버스 설정 → AI 도구에서 발급받은 API 키를 사용할 수 있습니다.

    요금이 어떻게 되나요?

    도구 연결은 무료입니다. 생성된 이미지는 웹사이트와 동일한 가격으로 크레딧을 차감하며, 예를 들어 GPT Image 2 Saver는 모든 해상도에서 2크레딧이 소모됩니다. 신규 계정은 회원가입 시 무료 크레딧 10개가 제공되며, 가격 페이지에서 크레딧을 추가로 충전할 수 있습니다.

    AI가 내 캔버스를 확인하고 크레딧을 사용할 수 있나요?

    동의 페이지에서 승인한 계정에 한해서만 권한을 부여한 후 접근할 수 있습니다. AI는 사용자의 컴퓨터에 있는 파일에는 절대 접근할 수 없습니다. 언제든지 캔버스 설정 → AI 도구에서 앱 연결을 해제하거나 API 키를 취소할 수 있습니다.

    생성 결과가 작업(job) 형태로 반환되는 이유는 무엇인가요?

    Codex는 기본적으로 도구 응답을 약 60초 동안 대기합니다. 약 45초 이내에 이미지가 준비되지 않으면 generate_image가 작업 ID를 반환하며, 어시스턴트가 잠시 후 get_generation을 호출해 이미지를 가져옵니다. 크레딧이 중복 차감되지 않습니다.

    캔버스 변경 사항은 어디에 표시되나요?

    trynanobanana.net/canvas 의 내 캔버스에 바로 반영됩니다. 캔버스를 열어둔 상태라면 약 10초 이내에 어시스턴트의 변경 사항이 나타나며, 닫혀 있다면 다음에 열 때 반영되어 있습니다.