MCP

DesignerBox MCP 서버를 사용하면 AI 어시스턴트가 DesignerBox 계정에서 직접 작업할 수 있습니다. Claude에게 제품 사진 생성, 템플릿 적용, 크레딧 잔액 확인, 라이브러리에서 에셋 가져오기를 요청하면 계정에서 그대로 실행되고 앱에 표시됩니다.

MCP(Model Context Protocol)는 AI 어시스턴트를 외부 도구에 연결하기 위한 개방형 표준입니다. DesignerBox는 호스팅형 MCP 서버를 운영하므로 설치하거나 직접 호스팅할 것이 없습니다.

서버 URL

클라이언트를 다음 주소에 연결하세요.

https://mcp.designerbox.ai/api

경로는 /mcp가 아니라 /api입니다. 서버는 스트리밍 가능한 HTTP 위에서 JSON-RPC 2.0을 사용합니다.

어시스턴트 연결하기

정확한 단계는 클라이언트마다 다르지만 흐름은 항상 동일합니다. 커스텀 커넥터를 추가하고, 서버 URL을 붙여넣은 뒤 로그인하면 됩니다.

Claude (웹, 데스크톱, Cowork)

설정을 열고 커넥터로 이동합니다.
커스텀 커넥터 추가를 선택합니다.
https://mcp.designerbox.ai/api를 붙여넣습니다.
브라우저가 열리면 DesignerBox 로그인을 완료합니다.
채팅을 시작하고 원하는 작업을 요청합니다. 예를 들어 "내 DesignerBox 디자인 목록을 보여줘"라고 입력해 보세요.

커넥터는 자동으로 등록되므로 복사할 클라이언트 ID나 시크릿이 없습니다. Claude에서 한 번 연결하면 Cowork에서도 동일한 연결을 사용할 수 있습니다.

Cursor 및 기타 MCP 클라이언트

스트리밍 가능한 HTTP 기반 원격 MCP 서버를 지원하는 모든 클라이언트에서 작동합니다. 동일한 URL을 지정하세요. OAuth 디스커버리를 지원하는 클라이언트는 로그인 흐름을 스스로 찾습니다.

인증

DesignerBox MCP는 OAuth만 사용합니다. 브라우저에서 로그인하면 클라이언트가 계정 범위의 토큰을 받습니다. 붙여넣을 API 키가 없으며, DesignerBox의 다른 영역에서 발급한 API 키는 여기서 사용할 수 없습니다.

서버는 동적 클라이언트 등록을 지원하므로 규격을 잘 따르는 클라이언트는 URL만으로 스스로 설정을 완료합니다. 토큰은 다음 스코프로 발급됩니다.

openid - 계정을 식별합니다.
mcp:read - 디자인, 에셋, 템플릿, 플랜을 읽습니다.
mcp:write - 미디어를 생성하고 데이터를 변경합니다.
offline_access - 세션을 갱신해 매일 로그인하지 않아도 됩니다.

모든 요청마다 팀 멤버십을 확인하므로, 팀에서 누군가를 제거하면 토큰 만료를 기다릴 필요 없이 즉시 접근 권한이 취소됩니다.

연결된 어시스턴트를 확인하거나 연결을 해제하려면 앱의 계정 설정에서 MCP 연결을 여세요. 여기서 해제하면 해당 클라이언트의 연결이 끊깁니다.

어시스턴트가 할 수 있는 일

서버는 63개의 도구를 제공하며, 읽기 도구가 37개, 쓰기 도구가 26개입니다. 도구 이름을 외울 필요는 없습니다. 원하는 것을 일상적인 표현으로 요청하면 어시스턴트가 알아서 도구를 선택합니다.

주요 영역은 다음과 같습니다.

생성. 이미지, 영상, 시네마 스튜디오 촬영, AI 캐릭터.
편집. 배경 제거, 리라이팅 및 각도 조정, 피부 리터치, 가상 피팅, 플랫레이, 제품 광고.
기법과 템플릿. 큐레이션된 카탈로그를 둘러보고 자신의 참조 이미지에 템플릿을 적용합니다.
라이브러리. 디자인, 에셋, 폴더, 갤러리를 조회하고 가져오거나, 채팅에서 바로 새 에셋을 업로드합니다.
브랜드. 브랜드 프로필과 브랜드 에셋을 읽고 업데이트합니다.
워크플로. Canvas의 파이프라인을 조회하고, 만들고, 실행합니다.
계정. 플랜, 크레딧 잔액, 한도, 팀을 확인합니다.

읽기 도구와 쓰기 도구에는 라벨이 붙어 있어 어시스턴트가 어떤 작업이 계정을 변경하는지 알 수 있습니다. 대부분의 클라이언트는 쓰기 도구를 처음 실행할 때 확인을 요청합니다.

이렇게 요청해 보세요

"콘크리트 바닥 위에 놓인 무광 검정 물병의 제품 사진을 생성해줘."
"패션 플랫레이용 템플릿에는 어떤 것들이 있어?"
"이번 달 남은 크레딧이 얼마야?"
"방금 만든 이미지의 배경을 제거해줘."
"이번 주에 만든 내 디자인 목록을 보여줘."

플랜과 크레딧

생성 작업은 앱에서 사용하는 것과 동일한 월간 풀에서 크레딧을 소모합니다. MCP 전용 허용량은 없으며, MCP 사용에 따른 추가 요금도 없습니다. Free 플랜에는 112 크레딧(기본 모델 기준 약 4장의 이미지)이 포함되어 있어 업그레이드 전에 생성을 시도해 볼 수 있습니다. 크레딧이 소진되면 허용량이 갱신되거나 업그레이드할 때까지 생성 도구는 중단되지만, 읽기 도구는 계속 작동합니다.

이미지 비용은 모델에 따라 다릅니다.

모델	이미지당 크레딧
Seedream 5	4
FLUX Pro 1.1	5
Nano Banana 2	7
FLUX 2 Flex	7
Nano Banana Pro	14
GPT Image 2	22

기타 작업:

작업	크레딧
이미지에 기법 적용	선택한 모델의 이미지당 비용(기본 모델은 14)
배경 제거	3
시네마 스튜디오	이미지당 2
AI 캐릭터 (9가지 포즈)	25
영상	모델별 초당 요율에 길이를 곱한 값

채팅을 벗어나지 않고 현재 비용과 기능을 확인하려면 어시스턴트에게 이미지 또는 영상 모델 목록을 요청하세요. 전체 내용은 플랜, 크레딧, 한도를 참고하세요.

소요 시간

어떤 도구는 대화 중에 끝나고, 어떤 도구는 백그라운드에서 실행됩니다.

이미지는 채팅에서 완료됩니다. 생성에는 약 30초가 걸리며, 완료되면 어시스턴트가 이미지를 반환합니다.
영상과 AI 캐릭터는 백그라운드에서 실행됩니다. 작업 참조를 즉시 받고, 어시스턴트가 준비될 때까지 상태를 확인합니다. 계속 다른 작업을 하다가 나중에 돌아와 완료되었는지 물어봐도 됩니다.

생성한 결과물은 모두 DesignerBox 라이브러리에 저장되므로, 채팅을 열어두었는지와 관계없이 앱에서 확인할 수 있습니다.

한도

요청은 계정별로 속도가 제한됩니다. 일반적인 대화형 사용은 한도 내에 충분히 들어옵니다. 어시스턴트가 반복 실행되거나 대량 요청을 보내면 잠시 제한될 수 있으며, 이 경우 재시도해야 합니다.

문제 해결

어시스턴트가 서버를 찾을 수 없다고 합니다. URL이 /api로 끝나는지 확인하세요. https://mcp.designerbox.ai/mcp는 유효하지 않으며 찾을 수 없음을 반환합니다.

로그인은 되지만 도구가 권한 오류로 실패합니다. 토큰이 취소되었거나 팀에서 제외되었을 수 있습니다. 커넥터를 다시 연결하세요.

생성이 중단되고 크레딧 관련 메시지가 표시됩니다. 월간 크레딧을 모두 사용했습니다(Free 플랜은 112 크레딧으로 시작합니다). 읽기 도구는 계속 작동합니다. 다시 생성하려면 허용량이 갱신될 때까지 기다리거나, 크레딧 팩을 구매하거나, 업그레이드하세요. 앱에서 잔액을 확인하거나 어시스턴트에게 플랜을 물어보세요.

어시스턴트가 잘못된 도구를 선택합니다. 원하는 결과를 구체적으로 말하세요. "이 사진에 리넨 플랫레이 템플릿을 적용해줘"가 "이거 더 예쁘게 만들어줘"보다 낫습니다.

MCP

MCP